source: people/yasumichi/update-watch.xml @ 3058

<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<book id="update-watch" lang="ja">
  <bookinfo>
    <title>update-watch ヘルプ</title>
    <copyright>
      <year>2009-2011</year>
      <holder>Kazutaka HARADA</holder>
    </copyright>
    <abstract>
      <para>update-watch は システムのアップデートの有無を1日1回自動的に確認して、アップデートが見つかると通知エリアのアイコンや通知パネルでお知らせするアプリケーションです。</para>
      <para>また通知エリアのアイコンの右クリックで表示されるメニューから、アップデートの適用や synaptic パッケージマネージャの実行等が簡単に行えます。</para>
    </abstract>
  </bookinfo>

  <chapter id="how-to-boot">
    <title>起動方法</title>
    <para>Gnome や kDE、Xfce といった freedesktop.org のデスクトップ標準に準拠したデスクトップ環境を使用している場合は、ログインすると自動的に起動します。</para>
    <para>上記以外のデスクトップ環境を使っていたり手動で起動したい場合は、コマンドラインから update-watch を実行します。</para>
  </chapter>

  <chapter id="usage">
    <title>使い方</title>
    <sect1 id="icons">
      <title>アイコンの説明</title>
      <para>デスクトップ環境にログインすると、通知エリアに以下のようなアイコンが表示されます。</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="images/icon.png" format="png" />
        </imageobject>
        <textobject>
          <phrase>notification icon</phrase>
        </textobject>
      </mediaobject>
      <para>update-watch はシステムのアップデートの有無を1日に1回自動的にネットワーク経由で確認します。そしてアップデートの有無によって以下のようなアイコンを通知エリアに表示します。</para>
      <para>
        <inlinemediaobject>
          <imageobject>
            <imagedata fileref="images/red.png" format="png" />
          </imageobject>
          <textobject>
            <phrase>updates found</phrase>
          </textobject>
        </inlinemediaobject>：アップデートがあります。システムを更新する必要があります。
      </para>
      <para>
        <inlinemediaobject>
          <imageobject>
            <imagedata fileref="images/blue.png" format="png" />
          </imageobject>
          <textobject>
            <phrase>no update</phrase>
          </textobject>
        </inlinemediaobject>：アップデートはありません。システムは最新の状態です。
      </para>
      <para>
        <inlinemediaobject>
          <imageobject>
            <imagedata fileref="images/gray.png" format="png" />
          </imageobject>
          <textobject>
            <phrase>standby</phrase>
          </textobject>
        </inlinemediaobject>：処理を一時停止しています。synaptic または apt-get コマンドが実行中です。
      </para>
      <para>
        <inlinemediaobject>
          <imageobject>
            <imagedata fileref="images/reboot.png" format="png" />
          </imageobject>
          <textobject>
            <phrase>reboot required</phrase>
          </textobject>
        </inlinemediaobject>：再起動が必要です。アップデートによりシステムの再起動が必要となった場合にのみ表示されます。
      </para>
      <para>
        <inlinemediaobject>
          <imageobject>
            <imagedata fileref="images/orange.png" format="png" />
          </imageobject>
          <textobject>
            <phrase>duplicate package</phrase>
          </textobject>
        </inlinemediaobject>：注意が必要です。以下のいずれかの状態の時に表示されます。
        <orderedlist>
          <listitem><para>複数のバージョンが同時にインストールされたパッケージがある時</para></listitem>
          <listitem><para>インストール直後、または長い間アップデートを確認していない時</para></listitem>
        </orderedlist>
      </para>
      <para>また通知エリアのアイコンにマウスポインタを合わせると、詳細な情報がツールチップで表示されます。</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="images/icon_with_tooltip.png" format="png" />
        </imageobject>
        <textobject>
          <phrase>icon with tooltip</phrase>
        </textobject>
      </mediaobject>
    </sect1>
    <sect1 id="notification-panel">
      <title>通知パネルによる通知</title>
      <para>アップデートが見つかると、アップデートの詳細を通知パネルを使って通知します。</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="images/notification_panel.png" format="png" />
        </imageobject>
        <textobject>
          <phrase>notification panel</phrase>
        </textobject>
      </mediaobject>
      <para>またアップデートを適用した結果、kernel の更新等が行われシステムの再起動が必要となった場合は、システムの再起動を促すメッセージを表示します。</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="images/notification_panel_reboot.png" format="png" />
        </imageobject>
        <textobject>
          <phrase>notification panel for reboot</phrase>
        </textobject>
      </mediaobject>
    </sect1>
    <sect1 id="menu">
      <title>メニューの説明</title>
      <para>通知エリアのアイコンを右クリックすると、以下のようなメニューが表示されます。</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="images/icon_with_menu.png" format="png" />
        </imageobject>
        <textobject>
          <phrase>icon with menu</phrase>
        </textobject>
      </mediaobject>
      <informaltable>
        <tgroup cols="2">
          <thead>
            <row><entry>メニュー項目</entry><entry>実行内容</entry></row>
          </thead>
          <tbody>
            <row><entry>全てアップグレード</entry><entry>全てのアップデートをその場でダウンロードして適用します。<footnote><para>apt-get upgrade 相当を実行します</para></footnote></entry></row>
            <row><entry>アップデートを確認</entry><entry>最新のアップデート情報をダウンロードし、アップデートの有無を確認します。<footnote><para>apt-get update 相当を実行します</para></footnote></entry></row>
            <row><entry>アップデートの一覧を表示</entry><entry>アップデートの対象パッケージを一覧で表示します。(参照:<xref linkend="update-list" />)</entry></row>
            <row><entry>パッケージマネージャを実行</entry><entry>Synaptic パッケージマネージャを実行します。</entry></row>
            <row><entry>ヘルプ</entry><entry>このヘルプをヘルプブラウザで表示します。</entry></row>
            <row><entry>終了</entry><entry>update-watch を終了します。</entry></row>
          </tbody>
        </tgroup>
      </informaltable>
      <note><para>実行時に権限が足りない場合は管理者パスワードの入力画面が表示されるので、root のパスワードを入力して OK ボタンを押してください。</para></note>
    </sect1>
    <sect1 id="update-list">
      <title>アップデートの一覧</title>
      <para>通知エリアのアイコンを右クリックしてメニューから <guimenuitem>アップデートの一覧</guimenuitem> を選択するか、アイコンをダブルクリックすると以下のような画面が表示されます。</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="images/window_update_list.png" format="png" />
        </imageobject>
        <textobject>
          <phrase>list of updates</phrase>
        </textobject>
      </mediaobject>
      <para>アップデートの一覧には、アップデートの状態を表すアイコンと各パッケージの名前、簡単な説明が表示されます。</para>
      <informaltable>
        <tgroup cols="3">
          <thead>
            <row><entry>アイコン</entry><entry>状態</entry><entry>詳細</entry></row>
          </thead>
          <tbody>
            <row>
              <entry>
                <mediaobject>
                  <imageobject>
                    <imagedata fileref="images/up.png" format="png" />
                  </imageobject>
                  <textobject>
                    <phrase>update</phrase>
                  </textobject>
                </mediaobject>
              </entry>
              <entry>アップデート</entry><entry>既にインストールされているパッケージの新しいバージョンが利用可能です。</entry>
            </row>
            <row>
              <entry>
                <mediaobject>
                  <imageobject>
                    <imagedata fileref="images/hold.png" format="png" />
                  </imageobject>
                  <textobject>
                    <phrase>hold</phrase>
                  </textobject>
                </mediaobject>
              </entry>
              <entry>保留</entry><entry>パッケージ間の依存によりアップデートが保留されています。Synaptic パッケージマネージャからアップデートを行う必要があります。</entry>
            </row>
            <row>
              <entry>
                <mediaobject>
                  <imageobject>
                    <imagedata fileref="images/new.png" format="png" />
                  </imageobject>
                  <textobject>
                    <phrase>new</phrase>
                  </textobject>
                </mediaobject>
              </entry>
              <entry>新規</entry><entry>パッケージ間の依存により新しいパッケージがインストールされます。</entry>
            </row>
            <row>
              <entry>
                <mediaobject>
                  <imageobject>
                    <imagedata fileref="images/remove.png" format="png" />
                  </imageobject>
                  <textobject>
                    <phrase>remove</phrase>
                  </textobject>
                </mediaobject>
              </entry>
              <entry>削除</entry><entry>パッケージ間の依存により既存のパッケージがアンインストールされます。</entry>
            </row>
            <row>
              <entry>
                <mediaobject>
                  <imageobject>
                    <imagedata fileref="images/duplicate.png" format="png" />
                  </imageobject>
                  <textobject>
                    <phrase>duplicate package</phrase>
                  </textobject>
                </mediaobject>
              </entry>
              <entry>重複バージョン</entry><entry>複数バージョンが同時にインストールされています。Synaptic パッケージマネージャからこの問題を解消する必要があります。</entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </sect1>
    <sect1 id="check-updates">
      <title>最新のアップデートの確認表示</title>
      <para>Vine Linuxのインストール直後や、長い間アップデートを確認していない場合に、以下のような画面が表示されます。</para>
      <mediaobject>
        <imageobject>
          <imagedata fileref="images/check-updates.png" format="png" />
        </imageobject>
        <textobject>
          <phrase>check updates</phrase>
        </textobject>
      </mediaobject>
      <para>この画面はシステムが最新の状態になっているか確認できない時に表示されます。</para>
      <para>アップデートを確認し、適用できるアップデートが見つかった時は速やかにアップグレードを実行してください。</para>
    </sect1>
  </chapter>

  <chapter id="notes">
    <title>注意点等</title>
    <itemizedlist>
      <listitem>
        <para>アップデートの確認を自動で行うためには、cron (と場合によっては anacron も)がバックグラウンドサービスとして実行されている必要があります。</para>
        <para>サービスが実行されているかどうかは、メニューの<menuchoice><guimenu>システム</guimenu><guimenuitem>システム管理</guimenuitem><guimenuitem>サービス</guimenuitem></menuchoice>を選択して、サービスの設定画面から確認できます。(*Gnomeの場合)</para>
      </listitem>
      <listitem>
        <para>保留されたアップデートについては、通知アイコンの右クリックで表示されるメニューから <guimenuitem>アップデートを適用</guimenuitem> を実行しても更新されません。</para>
        <para>その場合は Synaptic パッケージマネージャを実行して、変更内容を確認してからアップデートを適用する必要があります。</para>
      </listitem>
      <listitem><para><filename>/etc/apt/apt.conf</filename> で意図的にアップデートを保留(Hold)している場合は、update-watch の対象から除外されます。</para></listitem>
    </itemizedlist>
  </chapter>

  <chapter id="license">
    <title>ライセンス</title>
    <para>このプログラムはフリーソフトウェアです。あなたはこれを、フリーソフトウェア財団によって発行された <ulink url="ghelp:gpl">GNU General Public License</ulink> (バージョン3か、希望によってはそれ以降のバージョンのうちどれか)の定める条件の下で再頒布または改変することができます。</para>
    <para>このプログラムは有用であることを願って頒布されますが、*全くの無保証*です。商業可能性の保証や特定の目的への適合性は、言外に示されたものも含め全く存在しません。詳しくは GNU General Public License をご覧ください。</para>
    <para>GNU General Public License のコピーは GNOME ユーザーズガイド の付録に含まれています。GNU General Public License のコピーの入手は <ulink url="http://www.fsf.org/">Free Software Foundationのウェブサイト</ulink> を訪れるか、
<address>Free Software Foundation,Inc.51 Franklin Street Fifth Floor Boston,MA02110-1301USA</address>
にメールしてください。</para>
  </chapter>

</book>