diff --git a/ja_JP.eucJP/books/fdp-primer/chapters.ent b/ja_JP.eucJP/books/fdp-primer/chapters.ent
index 3fa92c30f4..33da333bbd 100644
--- a/ja_JP.eucJP/books/fdp-primer/chapters.ent
+++ b/ja_JP.eucJP/books/fdp-primer/chapters.ent
@@ -1,26 +1,29 @@
 <!-- 
      The FreeBSD Documentation Project
      The FreeBSD Japanese Documentation Project
 
-     Original revision: 1.4
+     Original revision: 1.6
      $FreeBSD$
 
      Creates entities for each chapter in the Documentation Project Primer.
      Each entity is named chap.foo, where foo is the value of the id 
      attribute on that chapter, and corresponds to the name of the 
       directory in which that chapter's .sgml file is stored.
    
      Chapters should be listed in the order in which they are referenced.
 -->
 
 <!ENTITY chap.overview		SYSTEM "overview/chapter.sgml">
 <!ENTITY chap.sgml-primer	SYSTEM "sgml-primer/chapter.sgml">
 <!ENTITY chap.tools		SYSTEM "tools/chapter.sgml">
 <!ENTITY chap.sgml-markup       SYSTEM "sgml-markup/chapter.sgml">
 <!ENTITY chap.stylesheets	SYSTEM "stylesheets/chapter.sgml">
 <!ENTITY chap.structure         SYSTEM "structure/chapter.sgml">
 <!ENTITY chap.the-website	SYSTEM "the-website/chapter.sgml">
 <!ENTITY chap.translations	SYSTEM "translations/chapter.sgml">
 <!ENTITY chap.writing-style	SYSTEM "writing-style/chapter.sgml">
 <!ENTITY chap.psgml-mode	SYSTEM "psgml-mode/chapter.sgml">
 <!ENTITY chap.see-also		SYSTEM "see-also/chapter.sgml">	
+<!ENTITY chap.doc-build		SYSTEM "doc-build/chapter.sgml">
+
+<!ENTITY app.examples		SYSTEM "examples/appendix.sgml">
diff --git a/ja_JP.eucJP/books/fdp-primer/overview/chapter.sgml b/ja_JP.eucJP/books/fdp-primer/overview/chapter.sgml
index 3fb37988c0..79d1f0dd73 100644
--- a/ja_JP.eucJP/books/fdp-primer/overview/chapter.sgml
+++ b/ja_JP.eucJP/books/fdp-primer/overview/chapter.sgml
@@ -1,329 +1,329 @@
 <!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
 
      Redistribution and use in source (SGML DocBook) and 'compiled' forms
      (SGML HTML, PDF, PostScript, RTF and so forth) with or without
      modification, are permitted provided that the following conditions
      are met:
 
       1. Redistributions of source code (SGML DocBook) must retain the above
          copyright notice, this list of conditions and the following
          disclaimer as the first lines of this file unmodified.
 
       2. Redistributions in compiled form (transformed to other DTDs,
          converted to PDF, PostScript, RTF and other formats) must reproduce
          the above copyright notice, this list of conditions and the
          following disclaimer in the documentation and/or other materials
          provided with the distribution.
 
      THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
      IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
      OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
      DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
      INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
      (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
      STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
      ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
      POSSIBILITY OF SUCH DAMAGE.
 
      The FreeBSD Japanese Documentation Project
 
-     Original revision: 1.18
+     Original revision: 1.19
      $FreeBSD$
 
 -->
 
 <chapter id="overview">
   <title>概要</title>
 
   <para>FreeBSD ドキュメンテーションプロジェクトへようこそ.  
     質の高い文書は, FreeBSD
     を成功させるために欠かすことができない重要なものです.   FreeBSD
     ドキュメンテーションプロジェクト(FreeBSD Documentation Project;
     FDP)は, そのような文書を数多く作成するためのプロジェクトです.  
     あなたの貢献は, 非常に貴重です.  
   </para>
 
   <para>この文書は主に <emphasis>FDP の構成</emphasis>, 
     <emphasis>文書の作成と FDP への提出方法</emphasis>および, 
     <emphasis>文書作成のために利用できるツールの効果的な利用法</emphasis>
     について解説することを目的としています.  
   </para>
 
   <para><indexterm>
       <primary>参加資格</primary>
     </indexterm>
     FDP は, どなたでも参加できます.  参加資格はありませんし, 
     毎月, 文書の作成が義務づけられているわけでもありません.  
     あなたがしなければならないのは, ただ
     &a.doc;
     メーリングリストに参加することだけです.  
   </para>
 
   <para>この文書を読み終えた後, 
     あなたは次のようになっていなければなりません.  </para>
   
   <itemizedlist>
     <listitem> 
       <para>どれが FDP が管理する文書はなのか理解して下さい.  </para>
     </listitem>
     
     <listitem>
       <para>FDP の管理する文書の SGML のソースコードを読み, 
         意味が理解できるようになってください.  
       </para>
     </listitem>
     
     <listitem> 
       <para>文書へ変更を加える操作ができるようになってください.  </para>
     </listitem>
     
     <listitem>
       <para>あなたの変更が査読を受け, FreeBSD
         の文書として採用にまわせるよう, 変更の提出ができるようになってください.  
       </para>
     </listitem> 
   </itemizedlist>
 
   <sect1 id="overview-doc">
     <title>FreeBSD 文書セット</title>
 
     <para>FDP では FreeBSD 関連文書のうち, 次の
       4 つのカテゴリを担当しています.  
     </para>
     
     <variablelist>
       <varlistentry>
         <term>マニュアルページ</term>
 
         <listitem>
           <para>システムの英語版マニュアルページは基本システムの一部であり, 
             FDP がその作成を担当しているわけではありません.  
             しかし FDP は, マニュアルページをよりわかりやすくしたり, 
             不正確な記述を修正するため, 既存のマニュアルページの改編を行なうことが
             できます.  
           </para>
 
           <para>翻訳チームは, システムのマニュアルページを他言語に翻訳する
             作業を担当しています.  この翻訳作業は, FDP の担当範囲内です.  
           </para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term>FAQ</term>
 	
         <listitem>
           <para>FAQ は, FreeBSD
             に関連するさまざまなメーリングリストやニュースグループで
             よく尋ねられる質問, あるいは質問されるべきものについて, 
             (短い質疑応答形式で)取り扱ったものです.  
             この形式では, 必要以上に長く細かい回答は許されません.  
           </para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
         <term>ハンドブック</term>
 
         <listitem>
           <para>ハンドブックは広範囲の話題を扱った FreeBSD のユーザのための
             オンライン情報源, およびリファレンスとなることを意図したものです.  
           </para>
         </listitem>
       </varlistentry>
  
       <varlistentry>
          <term>ウェブサイト</term>
 	
          <listitem>
           <para>これは, World Wide Web において中心的な FreeBSD のサイトであり, 
             <ulink url="../../../../index.html">http://www.FreeBSD.org/</ulink>
             と, 世界中に存在するたくさんのミラーサイトから見ることができます.  
             このウェブサイトは, 多くの人々が FreeBSD
             を初めて目にする場所でもあります.  
           </para>
 	</listitem>
       </varlistentry>
     </variablelist>
     
     <para>この 4 種類の文書は, いずれも FreeBSD CVS ツリーから入手することができます.  
       そのため, ファイルへの変更履歴は一般に公開されていて, 
       <application>CVSup</application> や
       <application>CTM</application> といったプログラムを使い
       誰でも文書のローカルコピーを最新のものに保つことができます.  
     </para>
     
     <para>さらに, たくさんの人々がチュートリアルや FreeBSD
       関連のウェブサイトをつくっています.  それらのなかには, 
       他の文書と同じように CVS リポジトリ(の原作者が同意した場所)に
       含まれているものもある一方, FreeBSD のリポジトリからは分離して, 
       原作者の手によって直接保守されているものもあります.  
       FDP では, そのような文書に対して可能な限り, 
       リンクを提供するように努力しています.  
     </para>
   </sect1>
 
   <sect1 id="overview-before">
     <title>はじめる前に</title>
     
     <para>この文書は, 次にあげる内容について
       あなたがすでに理解していることを前提として書かれています.  
     </para>
     
     <itemizedlist>                                                             
       <listitem>
 	<para>FreeBSD CVS リポジトリのローカルコピーを
           (<application>CVS</application>, もしくは
 	  <application>CVSup</application> か
 	  <application>CTM</application> を使って) 入手したり,
           <application>CVSup</application> を使って
 	  <emphasis>チェックアウトした(checked-out)</emphasis>コピーを
           ダウンロードすることで,
           FreeBSD の文書のローカルコピーを最新に維持する方法について.  
         </para>
       </listitem>
       
       <listitem>
 	<para>FreeBSD Ports システム, もしくは &man.pkg.add.1
           を利用して新しいソフトウェアをダウンロードし, インストールする方法について.  
         </para>
       </listitem>                                                              
     </itemizedlist>                                                            
   </sect1>
 
   <sect1 id="overview-quick-start">
     <title>まずははじめてみる</title>
 
     <para>もし何かやってみたくなって, 継続してやっていく自信があるなら,
       以下の手順を追ってみてください.</para>
 
     <procedure>
       <step>
 	<para><filename role="package">textproc/docproj</filename> メタ port を
 	  インストールします.</para>
 
 	<screen>&prompt.root; <userinput>cd /usr/ports/textproc/docproj</userinput>
 &prompt.root; <userinput>make JADETEX=no install</userinput></screen>
       </step>
 
       <step>
 	<para>FreeBSD <filename>doc</filename> ツリーのローカルコピー
 	  を入手します.
 	  CVSup を <literal>checkout</literal> モードで使うか,
 	  CVS リポジトリの完全なコピーをローカルに取り寄せるかします.
 	</para>
 
 	<para>CVS リポジトリをローカルに持つようにした場合,
 	  少なくとも <filename>doc/share</filename> と
 	  <filename>doc/en_US.ISO8859-1/share</filename> ディレクトリ
 	  をチェックアウトする必要があります.</para>
 
 	<screen>&prompt.user; <userinput>cvs checkout doc/share</userinput>
 &prompt.user; <userinput>cvs checkout doc/en_US.ISO8859-1/share</userinput></screen>
 
 	<para>ディスクスペースに余裕があるようでしたら, 全てをチェックアウト
 	  してしまうこともできます.</para>
 
 	<screen>&prompt.user; <userinput>cvs checkout doc</userinput></screen>
       </step>
 
       <step>
 	<para>既存の book もしくは article に変更を加えようと
 	  している場合には, リポジトリのその部分をチェックアウトします.
 	  新規に book や article を寄稿しようとしている場合には,
 	  既存のものをテンプレートとして使ってください.</para>
 
 	<para>例えば, FreeBSD と Windows 2000 の間に VPN を設定するような
 	  新しい article を寄稿しようとしている場合, 以下のようにします.
 	</para>
 
 	<procedure>
 	  <step>
 	    <para><filename>articles</filename> ディレクトリを
 	      チェックアウトします.</para>
 
 	    <screen>&prompt.user; <userinput>cvs checkout doc/en_US.ISO8859-1/articles</userinput></screen>
 	  </step>
 
 	  <step>
 	    <para>既存の article をテンプレートとして使うために
 	      コピーします.
 	      今回は, 新しい article は <filename>vpn-w2k</filename>
 	      というディレクトリに入れることにしましょう.</para>
 
 	    <screen>&prompt.user; <userinput>cd doc/en_US.ISO8859-1/articles</userinput>
 &prompt.user; <userinput>cp -r committers-guide vpn-w2k</userinput></screen>
 	  </step>
 	</procedure>
 
 	<para>もし <filename>doc/en_US.ISO8859-1/books/faq</filename>
 	  にある FAQ のような既存の文書に手を加える場合,
 	  リポジトリから以下のようにチェックアウトします.</para>
 
 	<screen>&prompt.user; <userinput>cvs checkout doc/en_US.ISO8859-1/books/faq</userinput></screen>
       </step>
 
       <step>
 	<para><filename>.sgml</filename> ファイルをあなたの好きな
 	  エディタで編集します.</para>
       </step>
 
       <step>
 	<para><maketarget>lint</maketarget> ターゲットでマークアップ
 	  をテストします.
 	  これにより, 時間のかかる変換を実際に行なうこと無く,
 	  文書中の間違いをすばやく見つけることができます.</para>
 
 	<screen>&prompt.user; <userinput>make lint</userinput></screen>
 
 	<para>文書を実際に構築する準備ができたら,
 	  <varname>FORMATS</varname> 変数で単一のフォーマット,
 	  もしくはフォーマットの一覧を指定することができます.
 	  今のところ,
   	  <literal>html</literal>, <literal>html-split</literal>,
   	  <literal>txt</literal>, <literal>ps</literal>,
   	  <literal>pdf</literal>, <literal>rtf</literal>
 	  が指定できます.
 	  サポートされているフォーマットの最新のリストは
 	  <filename>doc/share/mk/doc.docbook.mk</filename> ファイルの
 	  先頭を見てください.
 	  単一のコマンドで複数のフォーマットを構築しようとする際
 	  には, フォーマットの一覧を引用符で括ることを忘れないでください.
 	</para>
 
         <para>例えば, 文書を <literal>html</literal> に変換する
 	  だけなら以下のようになります:</para>
 
 	<screen>&prompt.user; <userinput>make FORMATS=html</userinput></screen>
 
         <para>文書を <literal>html</literal> と <literal>txt</literal>
 	  の両方のフォーマットに変換したい場合は, 以下のように
 	  &man.make.1; を二回にわけて実行することでできます:</para>
 
 	<screen>&prompt.user; <userinput>make FORMATS=html</userinput>
 &prompt.user; <userinput>make FORMATS=txt</userinput></screen>
 
         <para>一回のコマンドで実行するには, 以下のようになります:</para>
 
 	<screen>&prompt.user; <userinput>make FORMATS="html txt"</userinput></screen>
       </step>
 
       <step>
 	<para>変更点を &man.send-pr.1; を使って提出します.</para>
       </step>
     </procedure>
   </sect1>
 </chapter>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../chapter.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "chapter")
      End:
 -->
diff --git a/ja_JP.eucJP/books/fdp-primer/psgml-mode/chapter.sgml b/ja_JP.eucJP/books/fdp-primer/psgml-mode/chapter.sgml
index de77261a93..0d855f85d7 100644
--- a/ja_JP.eucJP/books/fdp-primer/psgml-mode/chapter.sgml
+++ b/ja_JP.eucJP/books/fdp-primer/psgml-mode/chapter.sgml
@@ -1,183 +1,183 @@
 <!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
 
      Redistribution and use in source (SGML DocBook) and 'compiled' forms
      (SGML HTML, PDF, PostScript, RTF and so forth) with or without
      modification, are permitted provided that the following conditions
      are met:
 
       1. Redistributions of source code (SGML DocBook) must retain the above
          copyright notice, this list of conditions and the following
          disclaimer as the first lines of this file unmodified.
 
       2. Redistributions in compiled form (transformed to other DTDs,
          converted to PDF, PostScript, RTF and other formats) must reproduce
          the above copyright notice, this list of conditions and the
          following disclaimer in the documentation and/or other materials
          provided with the distribution.
 
      THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
      IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
      OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
      DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
      INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
      (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
      STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
      ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
      POSSIBILITY OF SUCH DAMAGE.
 
      The FreeBSD Japanese Documentation Project
 
-     Original revision: 1.6
+     Original revision: 1.7
      $FreeBSD$
 -->
 
 <chapter id="psgml-mode">
   <title><application>Emacs</application> で
     <literal>sgml-mode</literal> を利用する</title>
 
   <para>新しいバージョンの <application>Emacs</application> や
     <application>Xemacs</application> (Ports Collection にあります)には, 
     PSGML と呼ばれる非常に便利なパッケージが附属しています.  
     これは拡張子がとなっている <filename>.sgml</filename> のファイルが読み込まれるか, 
     <command>M-x sgml-mode</command> と入力することで呼び出されます.  
     PSGML は, SGML ファイルやエレメント, 属性を扱うためのメジャーモードです.  
   </para>
 
   <para>このモードで提供されているいくつかのコマンドを知っていれば, 
     ハンドブックなどの SGML 文書をより簡単に扱うことができるようになります.  
   </para>
 
   <variablelist>
     <varlistentry>
       <term><command>C-c C-e</command></term>
       
       <listitem>
 	<para><literal>sgml-insert-element</literal> を実行します.  
           実行すると, 現在のカーソル位置に挿入すべきエレメント名が聞かれ, 
           TAB キーを使うことでエレメント名の補完ができます.  また, 
           カーソル位置に挿入できないエレメント名は入力できないようになっています.  
         </para>
 
 	<para>挿入は, 指定したエレメントのスタートタグとエンドタグが両方行なわれます.  
           もし, そのエレメントが他の必須エレメントを含む場合は, 
           その必須エレメントも同じように挿入されます.  
         </para>
       </listitem>
     </varlistentry>
     
     <varlistentry>
       <term><command>C-c =</command></term>
       
       <listitem>
 	<para><literal>sgml-change-element-name</literal> を実行します.
           カーソルをエレメントの内側に移動させてこのコマンドを実行して下さい.  
           変更するエレメント名が聞かれ, 現在のエレメントのスタートタグとエンドタグが
           入力した新しいエレメントのものに変更されます.  
         </para>
       </listitem>
     </varlistentry>
     
     <varlistentry>
       <term><command>C-c C-r</command></term>
       
       <listitem>
 	<para><literal>sgml-tag-region</literal> を実行します.
           テキストを指定(テキストの開始点に移動して C-Space を押し, 
           終了点に移動して C-Space を押す)してから, このコマンドを実行して下さい.  
           利用するエレメント名が聞かれ, 
           マークが付けられた範囲(リージョン)のすぐ前後に指定したエレメントが挿入されます.  
         </para>
       </listitem>
     </varlistentry>
 
     <varlistentry>
       <term><command>C-c -</command></term>
       
       <listitem>
 	<para><literal>sgml-untag-element</literal> を実行します.
           カーソルを削除したいエレメントのスタートタグか, エンドタグの上において
           このコマンドを実行して下さい.  すると, エレメントのスタートタグ, 
           エンドタグが両方とも削除されます.  
         </para>
       </listitem>
     </varlistentry>
     
     <varlistentry>
       <term><command>C-c C-q</command></term>
       
       <listitem>
 	<para><literal>sgml-fill-element</literal> を実行します.
           実行すると, カーソル位置のエレメントの内容に対して, 
           (整形する時のように)再帰的な文章の詰めが行なわれます.  
           この詰め作業は, 含まれている空白文字が重要なもの, たとえば
           <sgmltag>programlisting</sgmltag>
           エレメントの中などでも<emphasis>効果があります</emphasis>ので, 
           利用の際は注意して下さい.  
         </para>
       </listitem>
     </varlistentry>
     
     <varlistentry>
       <term><command>C-c C-a</command></term>
       
       <listitem>
 	<para><literal>sgml-edit-attributes</literal> を実行します.
           実行するともう一つバッファを開き, 
           最も近い閉じたエレメントのすべての属性のリストと, 現在の値を表示します.  
           TAB を使って属性間を移動することができ, <command>C-k</command> を
           押すことで, 既存の値を新しいものに置き換えることができます.  
-          また, <command>C-c</command> を押すことで, バッファを閉じて
+          また, <command>C-c C-c</command> を押すことで, バッファを閉じて
           元の文書に戻ることができます.  
         </para>
       </listitem>
     </varlistentry>
     
     <varlistentry>
       <term><command>C-c C-v</command></term>
       
       <listitem>
 	<para><literal>sgml-validate</literal> を実行します.
           実行すると(必要に応じて)現在編集中の文書をセーブするかどうか聞かれ, 
           次に SGML の正当性検査が行なわれます.  
           検査の出力は新しいバッファに表示されますので, 
           誤りのある部分へひとつひとつ移動してマークアップのミスを修正することができます.  
         </para>
       </listitem>
     </varlistentry>
   </variablelist>
   
   <para>もちろん, このモードには他にも有用な機能があります.  
     ここにあげたのは, その中でもわたしが非常に頻繁に利用しているものです.  
   </para>
 
   <para>ドキュメンテーションプロジェクトで作業するのに,
     適切な空白, インデント, コラム幅を設定するのに,
     <filename>.emacs</filename>
     に以下のエントリを使うことができます.</para>
 
   <programlisting>
     (setq sgml-mode-hook
       '(lambda ()
          (setq fill-column 70
                indent-tabs-mode nil
                next-line-add-newlines nil
                standard-indent 2)
          (auto-fill-mode t)))
   </programlisting>
 
 </chapter>
 
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../chapter.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "chapter")
      End:
 -->
 
diff --git a/ja_JP.eucJP/books/fdp-primer/structure/chapter.sgml b/ja_JP.eucJP/books/fdp-primer/structure/chapter.sgml
index 2ba21acc15..d3fa600e45 100644
--- a/ja_JP.eucJP/books/fdp-primer/structure/chapter.sgml
+++ b/ja_JP.eucJP/books/fdp-primer/structure/chapter.sgml
@@ -1,322 +1,317 @@
 <!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
 
      Redistribution and use in source (SGML DocBook) and 'compiled' forms
      (SGML HTML, PDF, PostScript, RTF and so forth) with or without
      modification, are permitted provided that the following conditions
      are met:
 
       1. Redistributions of source code (SGML DocBook) must retain the above
          copyright notice, this list of conditions and the following
          disclaimer as the first lines of this file unmodified.
 
       2. Redistributions in compiled form (transformed to other DTDs,
          converted to PDF, PostScript, RTF and other formats) must reproduce
          the above copyright notice, this list of conditions and the
          following disclaimer in the documentation and/or other materials
          provided with the distribution.
 
      THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
      IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
      OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
      DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
      INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
      (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
      STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
      ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
      POSSIBILITY OF SUCH DAMAGE.
 
 
      The FreeBSD Japanese Documentation Project
 
-     Original revision: 1.2
-     $FreeBSD: doc/ja_JP.eucJP/books/fdp-primer/structure/chapter.sgml,v 1.1 2001/03/07 19:40:54 hrs Exp $
+     Original revision: 1.14
+     $FreeBSD$
 -->
 
 <chapter id="structure">
   <title><filename>doc/</filename> 以下に構成されている文書</title>
 
   <para><filename>doc/</filename> ソースツリーは, ある一貫した方針で構成されています.  
     また, そのうち FDP が管理する文書は, さらに別の方針で構成されています.  
     これは新しい文書をソースツリーに追加する作業の単純化に加え, </para>
 
   <orderedlist>
     <listitem>
       <para>文書を他の形式への変換を自動化しやすくすること</para>
     </listitem>
 
     <listitem>
       <para>他の異なる文書構成との間の一貫性を維持し, 
         相互に作業しやすくすること
       </para>
     </listitem>
 
     <listitem>
       <para>ソースツリー上で新しい文書を導入する場所の決定を簡単に行なえるようにすること</para>
     </listitem>
   </orderedlist>
 
   <para>を目的としています.  
     さらに文書のソースツリーは, さまざまな異なる言語や
     文字エンコーディングに対応できなければなりません.  
     文書ツリーの構造が特定の慣習や文化背景を強制するものであっては
     ならないという点は重要です.  </para>
 
-  <sect1>
+  <sect1 id="structure-top">
     <title>ソースツリーの最上位 <filename>doc/</filename></title>
 
     <para><filename>doc/</filename> の下には二種類のディレクトリがあり, 
       各ディレクトリはそれぞれ, 特別な名前と意味を持っています.  </para>
 
     <segmentedlist>
+      <segtitle>ディレクトリ</segtitle>
+
+      <segtitle>意味</segtitle>
+
       <seglistitem>
 	<seg><filename>share/</filename></seg>
 	
 	<seg>このディレクトリには, 文書の翻訳やエンコーディングに依存しないファイルが収められ, 
           その分類のためのサブディレクトリがつくられています.  
           たとえば, &man.make.1; で使用されるファイルは <filename>share/mk</filename>
           に, (FreeBSD で拡張された DocBook DTD などの) SGML 関連のファイルは
 	  <filename>share/sgml</filename> におかれています.  </seg>
       </seglistitem>
 
       <seglistitem>
 	<seg><filename><replaceable>lang</replaceable>.<replaceable>encoding</replaceable>/</filename></seg>
 	
 	<seg>各々の文書の翻訳, エンコーディングに対して, 
           それに対応する一つのディレクトリがあります.  
           具体的には, <filename>en_US.ISO8859-1/</filename> や
 	  <filename>zh_TW.Big5/</filename> というディレクトリです.  
           ディレクトリ名が長いのですが, 言語とエンコーディングを完全に記述することで, 
           翻訳チームが将来的に, 同一の言語で異なるエンコーディングの
           文書を提供する際に発生する問題を回避することができます.  
           また, Unicode に移行するとしても, この方法ならば問題はまったくありません.  </seg>
       </seglistitem>
     </segmentedlist>
   </sect1>
 
-  <sect1>
+  <sect1 id="structure-locale">
     <title>
       <filename><replaceable>lang</replaceable>.<replaceable>encoding</replaceable>/</filename>
       ディレクトリ群</title>
 
     <para>これらのディレクトリには, 文書そのものがおかれています.  
       文書はこのディレクトリからさらに, 
       それぞれ異なるディレクトリ名で示される三種類に分類されます.  </para>
 
     <segmentedlist>
+      <segtitle>ディレクトリ</segtitle>
+
+      <segtitle>内容</segtitle>
+
       <seglistitem>
 	<seg><filename>articles</filename></seg>
 	
 	<seg>DocBook の <sgmltag>article</sgmltag>(もしくはそれと同等なもの)
           でマークアップされた文書です.  
           文書は短めのもので, 構成単位は節(section)となっています.  
           通常, 一つの HTML ファイルとして生成されます.  </seg>
       </seglistitem>
 	
       <seglistitem>
 	<seg><filename>books</filename></seg>
 	
 	<seg>DocBook の <sgmltag>book</sgmltag>(もしくはそれと同等なもの)
           でマークアップされた文書です.  文書は比較的長めで, 
           構成単位は章(chapter)となっています.  通常, 
           (高速なネットワーク接続を持っている人や, 
           ブラウザからの印刷に便利なよう)大きな単一の HTML ファイルと, 
           リンクされた小さな HTML ファイルの両方が生成されます.  </seg>
       </seglistitem>
 
       <seglistitem>
 	<seg><filename>man</filename></seg>
 	
 	<seg>システムのマニュアルページの翻訳をおくためのディレクトリです.  
           このディレクトリには, さらに <filename>man<replaceable>n</replaceable></filename> という, 
           翻訳されたマニュアルのセクションに対応する複数のディレクトリがあります.  </seg>
       </seglistitem>
     </segmentedlist>
 
     <para>
       ここで説明したディレクトリすべてが, 必ずそれぞれの
       <filename><replaceable>lang</replaceable>.<replaceable>encoding</replaceable></filename>
       ディレクトリにあるというわけではありません.  
       どのディレクトリが存在するかについては, 翻訳チームがどれだけ翻訳を完了しているかに依存します.  
     </para>
   </sect1>
   
-  <sect1>
+  <sect1 id="structure-document">
     <title>特定の文書に関する情報</title>
 
     <para>このセクションでは, FDP
       が管理する特定の文書に関する注意点が書かれています.  
     </para>
 
     <sect2>
       <title>ハンドブック</title>
 
       <subtitle><filename>books/handbook/</filename></subtitle>
 
       <para>ハンドブックは, FreeBSD
         によって拡張された DocBook DTD で書かれています.  
       </para>
 
       <para>ハンドブックは, DocBook の <sgmltag>book</sgmltag>
         によって構成されています.  
         そしてそれは複数の <sgmltag>part</sgmltag> に分割され, 
         <sgmltag>part</sgmltag> はいくつかの <sgmltag>chapter</sgmltag>
         を含みます.  <sgmltag>chapter</sgmltag> は
         さらにセクション(<sgmltag>sect1</sgmltag>), サブセクション
         (<sgmltag>sect2</sgmltag>, <sgmltag>sect3</sgmltag>)
         などに分割されています.  
       </para>
   
       <sect3>
 	<title>物理的な構成</title>
 
 	<para><filename>handbook</filename> ディレクトリには, 
           数多くのファイルとディレクトリがおかれています.  </para>
 
 	<note>
 	  <para>ハンドブックの構成は, 時より変更されますので, 
             この文書では, 
             構成変更の細かな部分の記述が古くなってしまっているかも知れません.  
             ハンドブックの構成について疑問点がありましたら, 
             FreeBSD ドキュメンテーションプロジェクト
             <email>freebsd-doc@FreeBSD.org</email> まで連絡下さい.  
           </para>
 	</note>
 	
 	<sect4>
 	  <title><filename>Makefile</filename></title>
 
 	  <para><filename>Makefile</filename> は, SGML
             ソースを他の形式に変換する方法を決めたり, 
             ハンドブックを構築する各種ソースファイルを列挙する
             さまざまな変数を定義するものです.  
             このファイルは, 文書形式の変換を扱うためのコードを取り込むために
             標準の <filename>doc.project.mk</filename> をインクルードします.  
           </para>
 	</sect4>
 
 	<sect4>
 	  <title><filename>book.sgml</filename></title>
 
 	  <para>これはハンドブックの構造において最上位にあたる文書です.  
             ハンドブックの <link
 	      linkend="sgml-primer-doctype-declaration">DOCTYPE
 	      宣言</link>とハンドブックの構成を記述するためのエレメントが含まれています.  
           </para>
 
 	  <para><filename>book.sgml</filename> は, 
             <filename>.ent</filename>
             という拡張子のついたファイルをロードするために<link
               linkend="sgml-primer-parameter-entities">パラメータ実体(parameter
               entities)</link>を使います.  (後述する)これらのファイルには, 
             ハンドブックの他の部分で共通して使われる<link
               linkend="sgml-primer-general-entities">一般実体(general
               entities)</link>
             が定義されています.  </para>
 	</sect4>
 
 	<sect4>
 	  <title><filename><replaceable>directory</replaceable>/chapter.sgml</filename></title>
 
 	  <para>ハンドブックの各章は, 互いに個別に分けられたディレクトリに
 	    <filename>chapter.sgml</filename> というファイルとして格納されています.  
             それぞれのディレクトリには, <sgmltag>chapter</sgmltag> エレメントの
             <literal>id</literal> 属性の値と同じ名前が付けられています.  
           </para>
 
 	  <para>たとえば, ある章のファイルが</para>
 	  
 	  <programlisting><![ CDATA [
 <chapter id="kernelconfiguration">
 ...
 </chapter>]]></programlisting>
 
 	  <para>のようになっていたとすれば, それは
             <filename>kernelconfiguration</filename> という
             ディレクトリ中の <filename>chapter.sgml</filename>
             というファイルです.  通常, 
             その章の内容はすべてこのファイルに書かれています.  </para>
 
 	  <para>HTML 版のハンドブックを構築する時,  この章は
             <filename>kernelconfiguration.html</filename>
             というファイル名として生成されます.   これは
             <literal>id</literal> の値に関係するもので, 
             ディレクトリ名との関連はありません.  </para>
 
 	  <para>ハンドブックの以前の版では, 文書のファイルは
             <filename>book.sgml</filename> と同じディレクトリにおかれていて, 
             ファイル名は <sgmltag>chapter</sgmltag> エレメントの
             <literal>id</literal> 属性の値になっていました.  
             これを個別のディレクトリに分けて移動させたのはハンドブックの
             将来的な計画の準備のためです.  具体的には, こうすることで, 
             特に変更することなく各章に画像を追加することが可能になります.  
             また, それぞれの画像ファイルを章のテキストファイルと同じディレクトリに
             おくことは, 大きな一つのディレクトリにすべてのテキストファイルと
             画像ファイルをおいて管理しようとするより分かりやすくなります.  
             名前空間の衝突が発生したとしても, 
             格納ファイルの少ないディレクトリで作業する方が, 
             数多くのファイルがディレクトリにある場合よりも対処しやすくなるでしょう.  </para>
 
 	  <para>ここまでを簡単にまとめると, 
             個々に <filename>chapter.sgml</filename>
             というファイルを含むディレクトリがたくさんあり, それらは
 	    <filename>basics/chapter.sgml</filename>,
 	    <filename>introduction/chapter.sgml</filename>,
 	    <filename>printing/chapter.sgml</filename>
             などという名前になっているということです.  </para>
 	  
 	  <important>
 	    <para>章とディレクトリは, 
               ハンドブックの並び順を反映した方法で名付けられるべきではありません.  
               順番はハンドブックの改訂の際に変更される可能性があります.  
               (章全体が階層構造の中で上下に移動するような場合でなければ)
               こういった改訂が行なわれる場合にファイル名を変更する必要性が
               (なるべく) 生じないようにするべきです.  
             </para>
 	  </important>
 
 	  <para>各々の <filename>chapter.sgml</filename> ファイルは, 
             完全な SGML 文書ではありません.  詳しく言えば, 
             それらのファイルの先頭には DOCTYPE 宣言の行が書かれていません.  
           </para>
       
 	  <para>これには, 二つの欠点があります.  </para>
-	  
-	  <itemizedlist>
-	    <listitem>
-	      <para>これらのファイルは一般的な SGML
-                ファイルとして扱うことができないため, 
-                HTML, RTF, PS などの形式に変換するのに, 
-                ハンドブック全体の生成に用いている方法と同じ方法を単純に用いることができません.  
-                そのため, ただ一つの章だけを変更し, その結果を確認しようという場合には, 
-                毎回ハンドブック全体を<emphasis>構築し直さなければならない</emphasis>ことになります.  
-              </para>
-	    </listitem>
-	    
-	    <listitem>
-	      <para>Emacs の <literal>sgml-mode</literal> を使う場合, 
-                文書が利用している DTD を認識できないために
-                <literal>sgml-mode</literal>
-                の便利な機能(エレメントの補完入力, 
-                自動チェック機能など)が利用できなくなります.  
-              </para>
-	    </listitem>
-	  </itemizedlist>
+
+	  <para>これらのファイルは一般的な SGML ファイルとして扱うことが
+	    できないため, HTML, RTF, PS などの形式に変換するのに,
+	    ハンドブック全体の生成に用いている方法と同じ方法を
+	    単純に用いることができないという欠点があります.
+	    そのため, ただ一つの章だけを変更し,
+	    その結果を確認しようという場合には, 毎回ハンドブック全体を
+	    <emphasis>構築し直さなければならない</emphasis>ことになります.</para>
 	</sect4>
       </sect3>
     </sect2>
   </sect1>
 </chapter>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../chapter.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "chapter")
      End:
 -->
 
diff --git a/ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.sgml b/ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.sgml
index 5d4e1da2ab..d22f960b58 100644
--- a/ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.sgml
+++ b/ja_JP.eucJP/books/fdp-primer/stylesheets/chapter.sgml
@@ -1,89 +1,114 @@
 <!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
 
      Redistribution and use in source (SGML DocBook) and 'compiled' forms
      (SGML HTML, PDF, PostScript, RTF and so forth) with or without
      modification, are permitted provided that the following conditions
      are met:
 
       1. Redistributions of source code (SGML DocBook) must retain the above
          copyright notice, this list of conditions and the following
          disclaimer as the first lines of this file unmodified.
 
       2. Redistributions in compiled form (transformed to other DTDs,
          converted to PDF, PostScript, RTF and other formats) must reproduce
          the above copyright notice, this list of conditions and the
          following disclaimer in the documentation and/or other materials
          provided with the distribution.
 
      THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
      IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
      OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
      DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
      INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
      (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
      STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
      ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
      POSSIBILITY OF SUCH DAMAGE.
 
 
      The FreeBSD Japanese Documentation Project
 
-     Original revision: 1.4
+     Original revision: 1.10
      $FreeBSD$
 -->
 
 <chapter id="stylesheets">
   <title>* スタイルシート</title>
 
   <para>SGML は, 文書が利用者にどのように表示されるかということや, 
     紙の上にどう配置されるかということについては何も定義していません. 
     それらを行なうためにスタイルシートを記述するさまざまな言語が開発されています. 
     その言語には, DynaText, Panorama, SPICE, JSSS, FOSI, CSS, DSSSL
     などがあります. 
   </para>
 
   <para>わたしたちは, DocBook 文書用として DSSSL で書かれたスタイルシートを, 
     HTML 文書用として CSS を利用しています. </para>
 
-  <sect1>
+  <sect1 id="stylesheets-dsssl">
     <title>* DSSSL</title>
 
     <para>ドキュメンテーションプロジェクトでは, 
       Norm Walsh 氏による Modular DocBook Stylesheets
       を少しカスタマイズしたものを使っています. </para>
     
     <para>このスタイルシートは, 
-      <filename>textproc/dsssl-docbook-modular</filename>
+      <filename role="package">textproc/dsssl-docbook-modular</filename>
       から入手できます. </para>
 
     <para>変更が加えられたスタイルシートは, ports システムに含まれていません. 
       それらはドキュメンテーションプロジェクトのソースリポジトリの一部であり, 
       <filename>doc/share/sgml/freebsd.dsl</filename> におかれています. 
       変更が加えられたスタイルシートには詳細なコメントが付けられていますので, 
       この章が完成するまで, 標準のスタイルシートにあるオプションが
       どういった風に FreeBSD ドキュメンテーションプロジェクト用に
       カスタマイズされているのか, このファイルを見て調べてみてください. 
       このファイルには FreeBSD 独自のエレメントを組版するために
       スタイルシートを適用するエレメントを追加する方法の例も含まれています. 
     </para>
   </sect1>
 
-  <sect1>
-    <title>* CSS</title>
-
-    <para></para>
+  <sect1 id="stylesheets-css">
+    <title>CSS</title>
+
+    <para>Cascading Stylesheets (CSS) はスタイル情報
+      (フォント, ウェイト, 大きさ, 色などなど)
+      を HTML 文書の要素に付加する機構です.</para>
+
+    <sect2>
+      <title>ウェブサイト (HTML 文書)</title>
+
+      <para>FreeBSD のウェブサイトは現在 CSS を使用していません.
+	残念ながら, 見た目とその印象は HTML の各属性で直接調整されており,
+	人によってその度合は異なります.
+	この問題は解決すべきであり, ドキュメンテーションプロジェクトに
+	貢献するに値する良いプロジェクトになるでしょう.</para>
+    </sect2>
+
+    <sect2>
+      <title>DocBook 文書</title>
+
+      <para>FreeBSD の DSSSL スタイルシートには, スタイルシート
+	<filename>docbook.css</filename> への参照が含まれています.
+	このスタイルシートは HTML ファイルと同一のディレクトリに
+	存在することが想定されています.
+	プロジェクトにまたがる CSS ファイルは,
+	文書が HTML に変換される時に
+	<filename>doc/share/misc/docbook.css</filename>
+	から複製され, 自動的にインストールされます.</para>
+    </sect2>
   </sect1>
 </chapter>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../chapter.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "chapter")
      End:
 -->
diff --git a/ja_JP.eucJP/books/fdp-primer/tools/chapter.sgml b/ja_JP.eucJP/books/fdp-primer/tools/chapter.sgml
index deec842422..5369e3ead0 100644
--- a/ja_JP.eucJP/books/fdp-primer/tools/chapter.sgml
+++ b/ja_JP.eucJP/books/fdp-primer/tools/chapter.sgml
@@ -1,305 +1,307 @@
 <!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved.
 
      Redistribution and use in source (SGML DocBook) and 'compiled' forms
      (SGML, HTML, PDF, PostScript, RTF and so forth) with or without
      modification, are permitted provided that the following conditions
      are met:
 
       1. Redistributions of source code (SGML DocBook) must retain the above
          copyright notice, this list of conditions and the following
          disclaimer as the first lines of this file unmodified.
 
       2. Redistributions in compiled form (transformed to other DTDs,
          converted to PDF, PostScript, RTF and other formats) must reproduce
          the above copyright notice, this list of conditions and the
          following disclaimer in the documentation and/or other materials
          provided with the distribution.
 
      THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
      IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
      OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
      DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
      INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
      (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
      SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
      STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
      ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
      POSSIBILITY OF SUCH DAMAGE.
 
 
      The FreeBSD Japanese Documentation Project
 
-     Original revision: 1.10
-     $FreeBSD: doc/ja_JP.eucJP/books/fdp-primer/tools/chapter.sgml,v 1.1 2001/03/07 19:40:55 hrs Exp $
+     Original revision: 1.25
+     $FreeBSD$
 -->
 
 <chapter id="tools">
   <title>ツール</title>
 
   <para>FDP では FreeBSD の文書を管理したり, 
     他の出力形式にに整形したりするため, さまざまなソフトウェアツールを利用します.  
     FreeBSD の文書で作業するには, あなた自身がそれらのツールを使う必要があります.  
   </para>
 
   <para>これらのツールはすべて FreeBSD の port や package として入手可能で, 
     インストール作業は非常に簡単です.  
   </para>
   
   <para>以下の章に書かれた例を試すには, あらかじめ
     これらのツールがインストールされていなければなりません.  
     各ツールの実際の利用方法は, その例が書かれた章で説明されています.  
   </para>
 
-  <important>
-    <title>できるだけ <filename>textproc/docproj</filename> を利用してください</title>
+  <tip>
+    <title>できるだけ <filename role="package">textproc/docproj</filename> を利用してください</title>
 
-    <para><filename>textproc/docproj</filename> の port
+    <para><filename role="package">textproc/docproj</filename> の port
       を使うとインストールする手間を大きく省くことができます.  これは
-      <emphasis>メタ(meta) port</emphasis> と呼ばれる port で, 
+      <emphasis>メタ (meta) port</emphasis> と呼ばれる port で, 
       その中にソフトウェアが含むかわりに, 他のさまざまな port
       が正しくインストールされるように依存関係がつくられているものです.  
       この port をインストールすると, 
       この章であげられているソフトウェアが
       自動的に<emphasis>すべてダウンロードされ, インストールされます</emphasis>.  
     </para>
 
     <para>必要となるパッケージの一つに, JadeTeX マクロセットというものがあります.  
       このマクロセットは, インストール時に TeX
       がインストールされていることを必要とします.  TeX
       は非常に大きなパッケージですが, Postscript や PDF
       形式の出力を行なわないならばインストールの必要はありません.  
     </para>
 
     <para>時間とディスクスペースの節約のため, 
-      この port をインストールする際に, JadeTeX(すなわち TeX を含む)
+      この port をインストールする際に, JadeTeX (すなわち TeX を含む)
       を必要とするかどうかを指定する必要があります.  
       次のいずれかを, 場合に応じて実行して下さい.  
 
       <screen>&prompt.root; <userinput>make JADETEX=yes install</userinput></screen>
 
       <screen>&prompt.root; <userinput>make JADETEX=no install</userinput></screen>
+      <makevar>JADETEX=no</makevar> を指定してツールをインストールすると,
+      HTML や ACSII テキストだけを出力することができます.
+      PostScript や PDF を出力するには TeX が必要です.
     </para>
-  </important>
+  </tip>
 
-  <sect1>
+  <sect1 id="tools-mandatory">
     <title>必須のツール</title>
 
     <sect2>
       <title>ソフトウェア</title>
 
       <para>以下のプログラムは, FreeBSD
-        の文書で快適に作業するために必要なものです.  これらはすべて, 
-	<filename>textproc/docproj</filename>
+        の文書で快適に作業するために必要なものであり, 文書を
+        HTML, プレインテキストや RTF 形式に変換することができます.
+        これらはすべて, 
+	<filename role="package">textproc/docproj</filename>
         に含まれています.  </para>
       
       <variablelist>
 	<varlistentry>
 	  <term><application>SP</application>
-	    (<filename>textproc/sp</filename>)</term>
+	    (<filename role="package">textproc/sp</filename>)</term>
 	  
 	  <listitem>
 	    <para>正当性検査のための SGML パーサや
               SGML 正規化ツールを含むアプリケーションのセットです.  
             </para>
 	  </listitem>
 	</varlistentry>
 	
 	<varlistentry>
 	  <term><application>Jade</application>
-	    (<filename>textproc/jade</filename>)</term>
+	    (<filename role="package">textproc/jade</filename>)</term>
 	  
 	  <listitem>
 	    <para>DSSSL の実装です.  これはマークアップされた文書を HTML
               や TeX といった他の形式に変換するために使われます.  </para>
 	  </listitem>
 	</varlistentry>
 	
 	<varlistentry>
 	  <term><application>Tidy</application>
-	    (<filename>www/tidy</filename>)</term>
+	    (<filename role="package">www/tidy</filename>)</term>
 	  
 	  <listitem>
 	    <para>HTML 整形ツールです.  
               これは自動生成された HTML 文書を整形し, 
               より利用しやすいものにするために使われます.  
             </para>
 	  </listitem>
 	</varlistentry>
 	
 	<varlistentry>
-	  <term><application>W3M</application>
-	    (<filename>www/w3m</filename>)</term>
+	  <term><application>Links</application>
+	    (<filename role="package">www/links</filename>)</term>
 	  
 	  <listitem>
-	    <para>
-              テキストモードの WWW ブラウザです.  &man.w3m.1;
-              は, HTML
-              ファイルをプレインテキストに変換することができます.  
-            </para>
+	    <para>HTML ファイルをプレインテキストに変換することのできる
+	      テキストモードの WWW ブラウザです.  </para>
+	  </listitem>
+	</varlistentry>
+
+	<varlistentry>
+	  <term><application>peps</application>
+	    (<filename role="package">graphics/peps</filename>)</term>
+  
+	  <listitem>
+	    <para>いくつかの文書には画像が含まれており, その中には
+	      EPS 形式で格納されているファイルがあります.
+	      ウェブブラウザが表示できるように
+	      PNG 形式に変換するために使われます.  </para>
 	  </listitem>
 	</varlistentry>
       </variablelist>
     </sect2>
 
     <sect2>
-      <title>文書型定義(DTD)と実体宣言(entity)</title>
+      <title>文書型定義 (DTD) と実体宣言 (entity)</title>
 
-      <para>以下にあげるのは, FDP で使われている DTD と実体宣言集合(entity set)です.  
+      <para>以下にあげるのは, FDP で使われている DTD と実体宣言集合 (entity set)です.  
         これらはいずれも, 文書を取り扱う前に必要となります.  
       </para>
       
       <variablelist>
 	<varlistentry>
-	  <term>HTML DTD (<filename>textproc/html</filename>)</term>
+	  <term>HTML DTD (<filename role="package">textproc/html</filename>)</term>
 	  
 	  <listitem>
 	    <para>HTML は, World Wide Web で採用されているマークアップ言語です.  
               これは FreeBSD ウェブサイト全体でも利用されます.  </para>
 	  </listitem>
 	</varlistentry>
 	
 	<varlistentry>
-	  <term>LinuxDoc DTD (<filename>textproc/linuxdoc</filename>)</term>
-	  
-	  <listitem>
-	    <para>FreeBSD の文書には, LinuxDoc でマークアップされたものがあります.  
-              FDP では, LinuxDoc から DocBook への移行を積極的にすすめています.  
-            </para>
-	  </listitem>
-	</varlistentry>
-	
-	<varlistentry>
-	  <term>DocBook DTD (<filename>textproc/docbook</filename>)</term>
+	  <term>DocBook DTD (<filename role="package">textproc/docbook</filename>)</term>
 	  
 	  <listitem>
-	    <para>DocBook は, 技術文書のマークアップのために設計された DTD であり, 
-              FDP では LinuxDoc から DocBook への移行をすすめています.  
-              この原稿を執筆している時点で, FreeBSD ハンドブックが
-              DockBook によってマークアップされています.  
+	    <para>DocBook は, 技術文書のマークアップのために設計された DTD です.
+              FreeBSD の文書はすべて DocBook で記述されています.
             </para>
 	  </listitem>
 	</varlistentry>
 	
 	<varlistentry>
 	  <term>ISO 8879 公開実体宣言
-	    (<filename>textproc/iso8879</filename>)</term>
+	    (<filename role="package">textproc/iso8879</filename>)</term>
 	  
 	  <listitem>
 	    <para>ISO 8879:1986 に規定された 19 種類の 文字実体集合です.  
               これはたくさんの DTD で利用されるもので, 数学記号や latin
-              文字集合の追加文字(アクセント記号, 発音記号など), 
+              文字集合の追加文字 (アクセント記号, 発音記号など), 
               ギリシャ文字などが含まれます.  
             </para>
 	  </listitem>
 	</varlistentry>
       </variablelist>
     </sect2>
 
     <sect2>
       <title>スタイルシート</title>
 
       <para>スタイルシートは, 文書を画面表示や印刷などに利用される形式に変換, 
         整形するために使われます.  
       </para>
       
       <variablelist>
 	<varlistentry>
 	  <term>Modular DocBook Stylesheets
-	    (<filename>textproc/dsssl-docbook-modular</filename>)</term>
+	    (<filename role="package">textproc/dsssl-docbook-modular</filename>)</term>
 	  
 	  <listitem>
 	    <para>Modular DocBook Stylesheets は, 
               DocBook DTD でマークアップされた文書を HTML や RTF
               形式に変換するのに使われます.  </para>
 	  </listitem>
 	</varlistentry>
       </variablelist>
     </sect2>
   </sect1>
 
-  <sect1>
-    <title>必須でない(optional)ツール</title>
+  <sect1 id="tools-optional">
+    <title>必須でない (optional) ツール</title>
 
     <para>もし必要性を感じないなら, 以下にあげるソフトウェアはインストールしなくともかまいません.  
       しかしインストールしていれば, 文書の取り扱いに便利だと感じるでしょうし, 
       これらを使うことで, より多様な出力形式で文書を出力することが可能となります.  
     </para>
 
     <sect2>
       <title>ソフトウェア</title>
       
       <variablelist>
 	<varlistentry>
 	  <term><application>JadeTeX</application> および
 	    <application>teTeX</application>
-	    (<filename>print/jadetex</filename> および
-	    <filename>print/teTeX</filename>)</term>
+	    (<filename role="package">print/jadetex</filename> および
+	    <filename role="package">print/teTeX</filename>)</term>
 	  
 	  <listitem>
 	    <para><application>Jade</application> と
 	      <application>teTeX</application> は, 
               DocBook 文書を DVI, Postscript, PDF の各形式に変換するのに使われます.  
 	      また, このとき <application>JadeTeX</application> マクロも必要となります.  
             </para>
 
 	    <para>文書をそのような形式に変換しなくて良い
-              (たとえば HTML, プレインテキスト, RTF で十分であるような)場合には, 
+              (たとえば HTML, プレインテキスト, RTF で十分であるような) 場合には, 
               <application>JadeTeX</application> および
 	      <application>teTeX</application> をインストールする必要はありません.  
               これらのインストールには大きなディスクスペースと時間を必要とします.  
               <application>teTeX</application> は, 30MB を超える大きなものです.  
             </para>
 
 	    <important>
 	      <para><application>JadeTeX</application> と
 		<application>teTeX</application> 
                 をインストールする場合には, 
                 <application>JadeTeX</application> がインストールされた後, 
                 <application>teTeX</application> の設定を行なわなければなりません.  
                 必要な手順の詳細は, 
-                <filename>print/jadetex/pkg/MESSAGE</filename>
+                <filename>print/jadetex/pkg-message</filename>
                 に説明されています.  </para>
 	    </important>
 	  </listitem>
 	</varlistentry>
 	
 	<varlistentry>
 	  <term><application>Emacs</application> もしくは
 	    <application>xemacs</application> 
-	    (<filename>editors/emacs</filename> もしくは
-	    <filename>editors/xemacs</filename>)</term>
+	    (<filename role="package">editors/emacs</filename> もしくは
+	    <filename role="package">editors/xemacs</filename>)</term>
 	  
 	  <listitem>
 	    <para>このエディタは両方とも, SGML DTD
               でマークアップされた文書を編集するための特別なモードを備えています.  
               このモードには, 
               必要なタイプ量や誤りをを低減するためのコマンドがあります.  
             </para>
 
 	    <para>どのようなテキストエディタでもマークアップされた文書を編集することは可能ですので, 
               これらを使う必要があるというわけではありません.  
               しかしおそらく, これらは便利なものだと感じると思います.  
             </para>
 	  </listitem>
 	</varlistentry>
       </variablelist>
 
       <para>もし, この他に SGML 文書を扱うために有用なソフトウェアをご存知でしたら, 
-        Nik Clayton(<email>nik@FreeBSD.org</email>) までお知らせ下さい.  
+        &nik; までお知らせ下さい.  
         このリストに加えさせていただきます.  
       </para>
     </sect2>
   </sect1>
 </chapter>
 
 <!--
      Local Variables:
      mode: sgml
      sgml-declaration: "../chapter.decl"
      sgml-indent-data: t
      sgml-omittag: nil
      sgml-always-quote-attributes: t
      sgml-parent-document: ("../book.sgml" "part" "chapter")
      End:
 -->