    <section id="cvs">
    <title> CVS </title>
    <!--
    <para> The LDP is in the process of providing CVS access to
    authors. There are a few good reasons for this: </para> 
    -->
<para>LDP では、文書の著者に CVS アカウントを発行しようとしています。
それには、次のような理由があります。</para>

    <orderedlist inheritnum="ignore" continuation="restarts">
      <listitem>
        <!--
        <para> CVS will keep an off-site backup of your documents. In
        the event that you hand over a document to another author,
        they can just retrieve the document from CVS and continue
        on. In the event you need to go back to a previous version of
        a document, you can retrieve it as well.  </para>
        -->
<para>CVS なら、作成した文書のオフサイト・バックアップが持てる。他の
著者へ文書の引き継ぎをするときでも、CVS からその文書を取ってきて、
直ぐに作業に入れる。以前のバージョンの文書が必要になったときでも、
問題なく取り出すことができる。</para>
      </listitem>
      <listitem>
        <!--
        <para> It's great if you have many people working on the same
        document. You can have CVS tell you what changes were made
        while you were editing your copy by another author, and
        integrate those changes in.  </para>
        -->
<para>何人かで、ひとつの文書を作る際に非常に便利。CVS を使えば、自分が編集中
の時に、他人が加えた変更の内容を知ることができるし、そうした変更をそのまま
取り込むこともできる。</para>
      </listitem>
      <listitem>
        <!--
        <para> Keeps a log of what changes were made. These logs (and
        a date stamp) can be placed automatically inside the document
        when you use some special tags that get processed before the
        SGML processor.  </para>
        -->
<para>変更箇所のログを保存できる。SGML 処理系が実際の処理に取りかかるより先に、
前もって処理されるような特別なタグを使えば、そうしたログ(や日付スタンプ)を自動
的に文書に埋め込むことができる。</para>

      </listitem>
      <listitem>
        <!--
        <para> Can provide for a way for a program to automatically
      update the LDP web site with new documentation as it's written
      and submitted. This is not in place yet, but is a potential
      goal. Currently, CVS updates signal the HOWTO coordinator to
      update the LDP web page, meaning that if you use CVS, you're not
      required to e-mail your SGML code. </para> 
      -->
<para>新規文書を作成して提出すると、LDP ウェブサイトも自動的に更新される
ようなプログラムを作ることができる。これはまだ実現されてはいないけれど
是非やってみたいことです。今のところ、CVS の更新によって、HOWTO 
コーディネータに LDP ウェブページを更新するよう通知が行くようになって
いますが、この仕組みを使うと SGML コードをメールで送る必要がなくなります。
</para>
      </listitem>
    </orderedlist>

    <!--
    <para> If you're completely new to CVS, there are a few web pages
    you may want to look at which can help you out: </para> 
    -->
<para>CVS が全く初めてなら、いくつかウェブページがあるので、見ておくと
役に立つかもしれません。</para>

    <itemizedlist>
      <listitem>
        <para> <ulink
        url="http://www.sourcegear.com/CVS/Docs/blandy">
        http://www.sourcegear.com/CVS/Docs/blandy</ulink>
        </para>
      </listitem>
      <listitem>
        <para> <ulink
        url="https://wroclaw.art.pl/~ser/docs/cvs.html">
        https://wroclaw.art.pl/~ser/docs/cvs.html</ulink></para> 
      </listitem>
    </itemizedlist>

    <section id="getaccount">
      <title> <!--Getting a CVS account-->CVS アカウントの入手 </title>

      <!--
      <para> First you'll need to get an account at the LDP's CVS
      Repository. This is pretty much the root directory that is used
      by CVS, with various projects (HOWTOs, mini HOWTOs, etc.)
      created as subdirectories of that. </para> 
      <para> You will need to create a hashed password and userid for
      your account. The hashed password allows you to send an
      encrypted password to the CVS group without them needing to know
      your password. You can do this with the following command, from
      bash (or sh): </para> 
      -->
<para>まず、LDP にある CVS リポジトリのアカウントを入手する必要があります。
これは、CVS が使うルートディレクトリそのもので、そのサブディレクトリと
して (HOWTO や mini HOWTO などの)いくつかのプロジェクト用のディレクトリ
が作成されています。</para>
<para>アカウントを取るには、ハッシュ化されたパスワードとユーザ ID を作成しな
ければなりません。ハッシュ化されたパスワードを使うと、CVS グループが送信者の
パスワードを知らずとも、暗号化されたパスワードを CVS グループに送ることが
できます。それには、次のようなコマンドを bash (もしくは sh) から打って
ください。</para>

      <screen format="linespecific">
<prompt>bash$</prompt> <command>echo your_password | perl -e "print crypt(&lt;&gt;,\
join '',('.', '/', 0..9, 'A'..'Z', 'a'..'z')[rand 64, rand 64]),\"\n\""
</command>
</screen>

      <!--
      <para>Take the output of this command, and send it with your
      proposed userid to
      <email>cvsadmin@cvslist.linuxdoc.org</email>. Your unique
      CVSROOT directory will be created and you'll get an e-mail with
      a response. When you get your response, log into your CVSROOT
      and make sure everything is set up properly: </para> 
      -->
<para>上記コマンドの出力を、希望するユーザ ID と一緒に <email>
cvsadmin@cvslist.linuxdoc.org</email> までお送りください。各自の CVSROOT 
ディレクトリが作成されたあとで、その旨の返答メールが届くので、それが
届いた時点で、CVSROOT にログインして、すべてが適切に設定されてることを
確認してください。</para>

      <screen format="linespecific">
<prompt>bash$</prompt> <command>export CVSROOT=:pserver:<replaceable>your_userid</replaceable>@cvs.linuxdoc.org:/cvsroot</command>
<prompt>bash$</prompt> <command>cvs -d $CVSROOT login</command>
</screen>

      <!--
      <para> (Replace the <replaceable>your_userid</replaceable> with what
      you were sent in the response e-mail). </para> 
      -->
<para>(<replaceable>your_userid</replaceable> の部分は、受け取った返答メール
にあるユーザ ID に置き換えます。)</para>
      <!--
      <para> You will be asked for your password, and then given
      access to the CVS Repository in read-write mode. Once you've
      used <command moreinfo="none">cvs login</command> once and have
      been given access to the system, your password is stored in
      <filename moreinfo="none">.cvspass</filename> and you will not
      have to use <command moreinfo="none">cvs login</command>
      again. Just set the CVSROOT and continue on. You can get the
      entire LinuxDoc repository with this command:  </para> 
      -->
<para>パスワードを尋ねられて、そのあとで、CVS リポジトリに読み書きモードでの
アクセス権が与えられます。<command moreinfo="none">cvs login</command> コマンド
は一度使うだけでシステムへのアクセス権が得られ、<filename moreinfo="none">
.cvspass</filename> にパスワードが保存されるので、次からは <command 
moreinfo="none">cvs login</command> を打つ必要はありません。
CVSROOT を設定して、作業を続けましょう。次のコマンドで、LinuxDoc リポジトリ
全体をコピーすることができます。</para>

      <screen>
<prompt>bash$</prompt> <command>cvs get LDP</command>
</screen>

      <!--
      <para> Or you can get the SGML source for your own document with
      these commands: </para> 
      -->
<para>ほかにも、自分で作成した文書の SGML ソースが欲しいときは、次のコマンドを
打ってください。</para>

      <screen format="linespecific">
<prompt>bash$</prompt> <command>cvs get LDP/howto/docbook/YOUR-HOWTO.sgml</command>
<prompt>bash$</prompt> <command>cvs get guide/docbook/YOURGUIDE</command> 
</screen>
    </section>


    <section id="othercvsnotes">
      <title> <!--Other CVS repository notes-->
      それ以外の CVS リポジトリへのアクセス方法 </title>

      <section id="anoncvs">
        <title> <!--Anonymous CVS access-->匿名 CVS アクセス </title>
        <!--
        <para> Anonymous CVS access is available for those who do not
        require an account (such as those wishing to publish LDP
        documents). This repository is read-only: </para> 
        -->
<para>(LDP 文書の出版を希望する方など、)アカウントの不要な方でも、
匿名 CVS アクセスが利用できます。その場合、リポジトリは読み出し専用に
なります。
</para>

        <screen>
<prompt>bash$</prompt> <command>cvs -d :pserver:cvs@anoncvs.linuxdoc.org:/cvsroot login</command>
</screen>

        <!--
        <para> As a password, use cvs. You can then get LinuxDoc
        modules as above. Note that changes to the anoncvs site may be
        a half an hour behind the main site. </para>
        -->
<para>パスワードには、"cvs" を使います。そうすれば、上記と同じように LinuxDoc 
モジュールが入手できます。匿名 CVS サイトの更新は、メインサイトより 30 分ほど
遅れるので注意してください。</para>
      </section>
      
      <section id="cvsweb">
        <title> <!--CVS Files via web-->Web 経由での CVS ファイル </title>
        <!--
        <para> You can access the CVS repository via the web at <ulink
        url="http://cvsweb.linuxdoc.org/index.cgi/LDP">
        http://cvsweb.linuxdoc.org/index.cgi/LDP</ulink>.
        </para>
        -->
<para>CVS リポジトリには、Web 経由でもアクセスできます。<ulink
        url="http://cvsweb.linuxdoc.org/index.cgi/LDP">
        http://cvsweb.linuxdoc.org/index.cgi/LDP</ulink> </para>
      </section>

      <section id="cvsgraphics">
        <title> <!--Graphical access to CVS-->
           グラフィカルインターフェイスを使う </title>
        <!--
        <para> There are graphical interfaces to CVS, and you can get
        a list of them at <ulink
        url="http://freshmeat.net/appindex">
        http://freshmeat.net/appindex</ulink>.
        Search for CVS. </para>
        -->
<para>CVS にはグラフィカルインターフェイスがあります。
<ulink url="http://freshmeat.net/appindex">
http://freshmeat.net/appindex</ulink> で CVS をキーワードに検索すれば、
一覧が表示されます。</para>

      </section>
    </section>

    <section id="updatefiles">
      <title> <!--Updating files and CVS-->ファイルの更新と CVS </title>
      <!--
      <para> CVS has a special tag, <emphasis>$Id&dollar;</emphasis>, that you
      can use to automatically insert the date and version directly
      into the document. After committing, CVS will turn this tag into
      <emphasis>$Id: cvs.sgml,v 1.3 2001/08/01 16:09:14 takei Exp $
      </emphasis>. By including this tag in your document, you
      can have that automatically change each time you change the
      file, allowing the revision mark to increment each time. </para> 
      -->
<para>CVS には、<emphasis>$Id&dollar;</emphasis> という特別なタグがあり、
これを使って文書に直接日付とバージョンを自動的に入れることができます。
commit した後で、CVS がこのタグを <emphasis>$Id: cvs.sgml,v 1.3 2000/08/24 
20:31:01 markk Exp $</emphasis> のように変更します。このタグを文書内に書いて
おくと、ファイルを変更するたびに自動的にそのタグが書き換えられ、
変更するごとにリビジョン番号を上げることができます。</para>
      <!--
      <para> When you're ready to upload changes to the CVS server,
      use the command <command moreinfo="none">cvs ci -m
      &quot;comment&quot; YOUR-HOWTO.sgml</command>. The -m
      &quot;comment&quot; isn't necessary, but if you don't include
      it, you'll be brought into the editor (usually vi, or whatever
      your <envar>EDITOR</envar> environment variable is) and be given
      the chance to add a comment about the changes. </para> 
      -->
<para>更新した文書を CVS サーバにアップロードする準備が整ったら、
<command moreinfo="none">cvs ci -m &quot;comment&quot; 文書名.sgml</command> 
とコマンドを打ってください。-m &quot;comment&quot; は必要ではありませんが、
これを入れないと、(普通は vi か、環境変数 <envar>EDITOR</envar> に設定された
何らかの)エディタが立ち上がって、変更点についてのコメントを追加するよう
求められます。</para>
      <!--
      <para> You can follow more of the CVS discussion on the
      ldp-discuss list. </para>
      -->
<para>ldp-discuss メーリングリスト上での議論からも詳しい情報が得られます。
</para>
      <!--
      <para>If you are using the LDP CVS tree while developing your
      document, the LDP will need to be notified when your
      document is ready to be published. E-mail should be sent to
      <email>ldp-submit@lists.linuxdoc.org</email>. Indicate
      the title of your document and the relative path to the
      file(s) in the LDP CVS tree within your message. </para>
      -->
<para>文書の作成中に LDP CVS ツリーを使っている場合は、公開準備が整った
時点で LDP に知らせる必要があります。<email>ldb-submit@lists.linuxdoc.org
</email> にメールを送ってください。その際、文書のタイトルと、文書ファイルの 
LDP CVS ツリー内での相対パス名を本文に書いておいてください。</para>
    </section>
  </section>