<!--
     The FreeBSD Documentation Project
     The FreeBSD Japanese Documentation Project

     Original revision: 1.163
     $FreeBSD$
-->

<!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
%man;

<!ENTITY % bookinfo PUBLIC "-//FreeBSD//ENTITIES DocBook BookInfo Entities//EN">
%bookinfo;

<!ENTITY % ja-authors PUBLIC "-//FreeBSD//ENTITIES DocBook Author Entities//JA">
%ja-authors;
<!ENTITY % authors PUBLIC "-//FreeBSD//ENTITIES DocBook Author Entities//EN">
%authors;
<!ENTITY % mailing-lists PUBLIC "-//FreeBSD//ENTITIES DocBook Mailing List Entities//JA">
%mailing-lists;
]>

<book>
  <bookinfo>
    <title>FreeBSD port 作成者のためのハンドブック</title>

    <authorgroup>
      <corpauthor>FreeBSD ドキュメンテーションプロジェクト</corpauthor>
    </authorgroup>

    <pubdate>2000 年 4 月</pubdate>

    <copyright>
      <year>2000</year>
      <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation
        Project</holder>
    </copyright>

    <abstract>
      <para>このハンドブックは FreeBSD の port 作成者 (porter) 向けに,
        具体的な port の作成方法や注意点などをまとめたものです.</para>

      <para>日本語版の作成は FreeBSD 日本語ドキュメンテーション
        プロジェクト (FreeBSD doc-jp) が行なっています.
        日本語訳および, 日本語版のみに関することは FreeBSD &a.jp.doc-jp; に
        おいて日本語で議論されています.
      </para>

      <para>文書の日本語訳に関するお問い合わせや,
        文書の原文に関する問い合わせをしたいが英語が得意でないという方は,
        FreeBSD &a.jp.doc-jp; まで日本語でコメントをお寄せください.</para>
    </abstract>

    &bookinfo.legalnotice;
  </bookinfo>

  <chapter>
    <title>自分で port を作成するには</title>

    <para>自分で port を作ることや, 既存の port の
      更新作業に興味があるのですか. それはすばらしい!</para>

    <para>ここでは FreeBSD 用の port を作る際の
      ガイドラインをいくつか示します.
      既存の port を更新したいと考えている場合であっても,
      まずこの章を読んでから, 次に
      <xref linkend="port-upgrading"> を読むようにしてください.</para>

    <para>この文書では充分に詳細がわからない場合には,
      <filename>/usr/ports/Mk/bsd.port.mk</filename> を参照してください.
      このファイルは, port の Makefile が例外なくインクルードしているものです.
      これには細かくコメントが書かれていますので, Makefile を読むのに
      あまり慣れていない人でも, たくさんの情報を得ることができるでしょう.
      それでも解決できないような質問は, &a.ports; にポストしてみるのも
      良いでしょう.</para>

    <note>
      <para>この文書では, 上書き可能な
        変数 (<makevar><replaceable>VAR</replaceable></makevar>) のうち
        一部のものについてだけ述べています.
        (すべてでは無いかもしれませんが,) ほとんどの変数は
        <filename>bsd.port.mk</filename> の先頭部分に記述されています.
        なお, このファイルは非標準のタブ設定を使用しています.
        <application>Emacs</application> や <application>Vim</application> は,
        この設定をファイルの読み込み時に認識するはずです.
        <command>vi</command> と <command>ex</command> では,
        一旦ファイルを読み込んでから <command>:set tabstop=4</command> と
        タイプすることで, 正しい値に設定することができます.</para>
    </note>
  </chapter>

  <chapter id="quick-porting">
    <title>3 分間 porting</title>

    <para>このセクションでは, 簡単な port の作り方について説明します.
      多くの場合, これだけでは不充分ですが,
      まあ うまくいくかどうか試してみて損はないでしょう.</para>

    <para>まず, 元の tar ファイルを
      <makevar>DISTDIR</makevar> に置きます. この変数の
      デフォルト値は <filename>/usr/ports/distfiles</filename> です.</para>

    <note>
      <para>以下の例では, そのソフトウェアが
        そのままコンパイル可能なものと仮定しています.
        つまり, FreeBSD マシンで動かすために,
        変更がまったく必要ないという意味です.
        もし何か変更が必要な場合には, 次のセクションも
        参照する必要があるでしょう.</para>
    </note>

    <sect1>
      <title><filename>Makefile</filename> の作成</title>

      <para>最小限の <filename>Makefile</filename> は
        次のようなものになります.</para>

      <programlisting># New ports collection makefile for:   oneko
# Date created:     5 December 1994
# Whom:             asami
#
# &dollar;FreeBSD&dollar;
#

PORTNAME=       oneko
PORTVERSION=    1.1b
CATEGORIES=     games
MASTER_SITES=   ftp://ftp.cs.columbia.edu/archives/X11R5/contrib/

MAINTAINER=     asami@FreeBSD.org

MAN1=           oneko.1
MANCOMPRESSED=  yes
USE_IMAKE=      yes

.include &lt;bsd.port.mk&gt;</programlisting>

      <para>おわかりでしょうか. <literal>&dollar;FreeBSD&dollar;</literal> を
        含む行の内容については, 気にする必要はありません.
        この行は, このファイルが FreeBSD の ports ツリーに
        取り込まれる際に, CVS によって自動的に書き込まれます.
        もっと詳しい例が見たい場合には,
        <link linkend="porting-samplem">Makefile のサンプル</link>の
        セクションをご覧ください.</para>
    </sect1>

    <sect1>
      <title>package 記述ファイルの作成</title>

      <para>package にするしないに関わらず, どのような port でも
        三つの記述ファイルが必要です. それは
        <filename>pkg-comment</filename>,
        <filename>pkg-descr</filename>, と
        <filename>pkg-plist</filename> の３つで, ファイル名が
        <filename>pkg-</filename> で始まっていることで
        他のファイルと区別できるようになっています.</para>

      <sect2>
        <title><filename>pkg-comment</filename></title>

        <para>このファイルには, その port についての説明を一行で書きます.
          package の名前だとか, バージョン番号などを
          含めては<emphasis>いけません</emphasis>.
          説明は大文字で始め, 最後にピリオドは付けないでください.
          たとえば, こんな具合です.</para>

        <programlisting>A cat chasing a mouse all over the screen</programlisting>
      </sect2>

      <sect2>
        <title><filename>pkg-descr</filename></title>

        <para>このファイルには, その port についての少し長い説明を書きます.
          その port が何をするのかについての, 
          数段落程度の簡潔な解説があれば充分です.</para>

        <note>
          <para>これはマニュアルでもなければ, 使用方法やコンパイル方法に
            ついての細かい説明書でも<emphasis>ありません</emphasis>.
            <emphasis><filename>README</filename> ファイルや
            マニュアルを引用するつもりなら注意が必要です</emphasis>.
            これらは多くの場合, その port の簡潔な説明になっていなかったり,
            扱いにくい形式になっていたりします.
            (マニュアルの場合, 行を揃えるために空白が調整されていたりします.)
            このソフトウェアに公式のウェブサイトがあるのなら,
            ここに書いてください. その際自動化ツールが正しく動作するように,
            ウェブサイトのうちの<emphasis>一つ</emphasis>には,
            先頭に <literal>WWW:</literal> をつけておいてください.</para>
        </note>

        <para>このファイルの最後に, あなたの名前を書くことが推奨されています.
          たとえば, こんな具合です.</para>

        <programlisting>This is a port of oneko, in which a cat chases a poor mouse all over
the screen.
 :
(うんぬん.)

WWW: http://www.oneko.org/

- Satoshi
asami@cs.berkeley.edu</programlisting>
      </sect2>

      <sect2>
        <title><filename>pkg-plist</filename></title>

        <para>このファイルには, その port によってインストールされる
          すべてのファイルを列挙します.
          このファイルは package を作る際のリストとして使われるため,
          <quote>パッキングリスト (packing list)</quote> とも呼ばれます.
          ここに書くパス名は, インストール時のプレフィックス
          (通常 <filename>/usr/local</filename> または
          <filename>/usr/X11R6</filename>) からの相対パスです.
          <makevar>MAN<replaceable>n</replaceable></makevar> 変数を
          使用している場合 (使用することが推奨されています), このリストに
          マニュアルは入れないようにしてください.</para>

        <para>簡単な例を載せておきましょう.</para>

        <programlisting>bin/oneko
lib/X11/app-defaults/Oneko
lib/X11/oneko/cat1.xpm
lib/X11/oneko/cat2.xpm
lib/X11/oneko/mouse.xpm
@dirrm lib/X11/oneko</programlisting>

        <para>パッキングリストの詳細については,
          &man.pkg.create.1; のマニュアルを参照してください.</para>

        <note>
          <para>このリストには, すべてのファイルを列挙しなければ
            なりませんが, ディレクトリそのものは列挙する必要がありません.
            また, この port がインストール時に独自のディレクトリを
            作成する場合には, この port が削除されるときに
            そのディレクトリも削除されるよう, <literal>@dirrm</literal> の行を
            追加しておくのを忘れないでください.</para>

          <para>このファイルでは, すべてのファイル名を
            アルファベット順にソートしておくことを推奨します.
            そうすることで, port を更新する際の
            変更点の確認が楽になります.</para>

          <para>パッキングリストを手作業で作成するのは, 
            時にとても退屈な作業になります.
            その port が非常に多数のファイルをインストールするとしたら,
            <link linkend="porting-autoplist"> パッキングリストの
            自動生成</link>を行なえば, 時間の節約になるかもしれません.</para>
        </note>
      </sect2>
    </sect1>

    <sect1>
      <title>チェックサムファイルの作成</title>

      <para><command>make makesum</command> と入力するだけで,
        (訳注: <filename>bsd.port.mk</filename> に書かれている)
        port 生成ルールに従い,
        自動的に <filename>distinfo</filename> ファイルが生成されます.</para>
    </sect1>

    <sect1 id="porting-testing">
      <title>port のテスト</title>

      <para>package 化も含め, その port が思った通りに
        動くことを確認してください.
        確認の必要な重要ポイントは以下の通りです.</para>

      <itemizedlist>
        <listitem>
          <para>その port がインストールしないものが
            <filename>pkg-plist</filename> に含まれていないこと.</para>
        </listitem>

        <listitem>
          <para>その port がインストールする, すべてのものが
            <filename>pkg-plist</filename> に含まれていること.</para>
        </listitem>

        <listitem>
          <para><maketarget>reinstall</maketarget>
            ターゲットを使うことで, その port が
            何度でもインストール可能なこと.</para>
        </listitem>

        <listitem>
          <para>その port が deintall される際には
            <link linkend="porting-cleaning">後片付け</link>をすること.</para>
        </listitem>
      </itemizedlist>

      <procedure>
        <title>推奨されるテストの手順</title>

        <step>
          <para><command>make install</command></para>
        </step>

        <step>
          <para><command>make package</command></para>
        </step>

        <step>
          <para><command>make deinstall</command></para>
        </step>

        <step>
          <para><command>pkg_add <replaceable>package 名</replaceable>
            </command></para>
        </step>

        <step>
          <para><command>make deinstall</command></para>
        </step>

        <step>
          <para><command>make reinstall</command></para>
        </step>

        <step>
          <para><command>make package</command></para>
        </step>
      </procedure>

      <para><maketarget>package</maketarget> および
        <maketarget>deinstall</maketarget> の段階で,
        どんな警告 (warning) も出力されないことを確認してください.
        ステップ 3 の後, (訳注: その port が作成した) すべての新しい
        ディレクトリが正しく消去されていることを確認してください.
        また, ステップ 4 の後にそのソフトウェアを使用してみて,
        package からインストールされた場合にも正しく動作することを
        確認してください.</para>
    </sect1>

    <sect1 id="porting-portlint">
      <title><command>portlint</command> によるチェック</title>

      <para><command>portlint</command> を使い, その port が FreeBSD の
        ガイドラインに沿っているかどうかを確認してください.
        <command>portlint</command> プログラムは ports collection に
        含まれています.
        特に, <link linkend="porting-samplem">Makefile</link> が
        正しい形式になっているか,
        <link linkend="porting-pkgname">package</link> の
        名前が正しいかどうかをチェックするのに良いでしょう.</para>
    </sect1>

    <sect1 id="porting-submitting">
      <title>port の提出</title>

      <para>まず, <link linkend="porting-dads"> やって良いこと悪いこと</link>の
        セクションを読んでください.</para>

      <para>さて, 満足のいく port が完成したら, 残るは
        それを FreeBSD のメインの ports ツリーに置いて,
        他の人にも使ってもらうだけです.
        <filename>work</filename> ディレクトリや
        <filename>pkgname.tgz</filename> といった package は
        必要ありませんから, まずこれらを消去してください.
        あとは <command>shar `find port_dir`</command> の出力を
        バグレポートに入れ, &man.send-pr.1; プログラムを使用して
        送ってください (&man.send-pr.1; についての詳細は<ulink
        url="../handbook/contrib-how.html#CONTRIB-GENERAL">バグ報告と
        一般的な論評</ulink>を参照してください).
        もし, 圧縮していない状態で 20KB 以上あるような port であれば,
        それを ひとつの tar ファイルにまとめて圧縮し,
        バグレポートに入れる前に &man.uuencode.1; を使用してください
        (20KB 以下のものを tar ファイルにして送っても良いのですが,
        あまり歓迎されません).
        バクレポートの category は必ず <literal>ports</literal>,
        class は <literal>change-request</literal> としてください
        (レポートを <literal>confidential</literal> (機密) 指定には
        しないでください!).
        また, port 化したプログラムの短い説明文を
        バグレポートの <quote>Description</quote> フィールドに追加して,
        <quote>Fix</quote> フィールドには shar したファイル,
        もしくは uuencode した tar ファイルを追加するようにしてください.
        後者は, ports 管理の作業をスクリプトで行なっている
        コミッターの助けとなります.</para>

      <para>もう一度, <emphasis>オリジナルのソースファイルや
        <filename>work</filename> ディレクトリ,
        <command>make package</command> で作成した package が
        含まれていないこと</emphasis>を確認してください.</para>

      <note>
        <para>以前には, 新しい port を提出する際に FreeBSD の FTP サイト
          (<hostid role="fqdn">ftp.FreeBSD.org</hostid>) に
          アップロードするように お願いしていたことがあります.
          現在このサイトの <filename>incoming</filename> ディレクトリは
          読み出し不可になっており, アップロードは推奨されていません.
          たくさんの海賊版ソフトウェアがそこに置かれたためです.</para>
      </note>

      <para>わたしたちはその port をチェックし, 必要なら
        あなたに確認して, それをツリーへ置きます.
        あなたの名前は FreeBSD ハンドブックやその他のファイルの
        <quote>Additional FreeBSD contributors</quote> の
        リストにも載るでしょう.
        う〜ん, 素晴らしい. <!-- smiley -->:-)</para>
      <!-- kuriyama - should use link tag? -->

      <note>
        <para>わたしたちが作業しやすいように,
          障害報告の概要 (synopsis) は適切に記述してください.
          たとえば新しい port の提出なら
          <quote>New port: &lt;port の簡単な説明&gt;</quote>,
          port の更新なら
          <quote>Update port: &lt;カテゴリ&gt;/&lt;port 名&gt; &lt;更新内容の簡単な説明&gt;</quote>
          といった形式が歓迎されます.
          こういう方法で報告するように心がけていれば, あなたの報告 (PR) が
          すぐに誰かの目にとまる確率が ぐっと高くなるのです.</para>
      </note>
    </sect1>
  </chapter>

  <chapter>
    <title>本格的な port</title>

    <para>残念ながら移植がそう簡単ではなく, それを動かすために
      多少の変更が必要になる場合もあるでしょう.
      このセクションでは, 模範的な ports の作法に従い,
      どのように変更を行なって動くようにするのかを
      順を追って説明します.</para>

    <sect1>
      <title>port 構築の詳細</title>

      <para>まず, あなたが port のディレクトリで
        <command>make</command> と
        入力してから起こる一連の出来事について,
        順を追って説明します.
        ここを読むときには, 別のウィンドウに
        <filename>bsd.port.mk</filename> を表示しておくと
        理解の助けになるかもしれません.</para>

      <para>しかし, <filename>bsd.port.mk</filename> が何をしているのか
        完全に理解できなくても 心配する必要はありません.
        それほど多くの人が理解している というわけでは ありませんから...
        <!-- smiley --><emphasis>f(^_^;)</emphasis></para>

      <procedure>
        <step>
          <para>まず, <maketarget>fetch</maketarget> という
            ターゲットが実行されます.
            この <maketarget>fetch</maketarget> ターゲットは,
            配布ファイルがローカルの <makevar>DISTDIR</makevar> に
            存在することを保証する役目を持っています.
            もし必要なファイルが <makevar>DISTDIR</makevar> に
            存在しなければ, <maketarget>fetch</maketarget> ターゲットは
            <filename>Makefile</filename> で指定された
            <makevar>MASTER_SITES</makevar> 中の URL や,
            FreeBSD のメイン FTP サイト <ulink
            url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/">
            ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/</ulink>
            (ここにはバックアップとして, われわれ ports 管理者が確認した
            配布ファイルを置いてあります) を探しにいきます.
            <command>make</command> を実行するマシンがインターネットに
            接続されていて, 目的のファイルを <makevar>FETCH</makevar> で
            取ってこれた場合には, それを <makevar>DISTDIR</makevar> に
            保存します.</para>
        </step>

        <step>
          <para>次に <maketarget>extract</maketarget> ターゲットが実行されます.
            このターゲットは <makevar>DISTDIR</makevar> から
            配布ファイル (普通は gzip された tar ファイル) を読み込み,
            その内容を作業ディレクトリ <makevar>WRKDIR</makevar>
            (デフォルトでは <filename>work</filename>) に展開します.</para>
        </step>

        <step>
          <para>次に <maketarget>patch</maketarget> ターゲットが実行されます.
            まず, <makevar>PATCHFILES</makevar> にパッチファイルが
            指定されていれば, そのパッチを適用します.

            次に, <makevar>PATCHDIR</makevar> ディレクトリ
            (デフォルトでは <filename>files</filename> サブディレクトリ) に
            <filename>patch-<replaceable>*</replaceable></filename> という
            名前のパッチファイルが存在すれば,
            これらをアルファベット順に適用します.</para>
        </step>

        <step>
          <para>次に <maketarget>configure</maketarget> ターゲットが
            実行されます.
            これには, いろいろな場合があります.</para>

          <orderedlist>
            <listitem>
              <para><filename>scripts/configure</filename> が
                存在する場合には, そのスクリプトが実行されます.</para>
            </listitem>

            <listitem>
              <para><makevar>HAS_CONFIGURE</makevar> または
                <makevar>GNU_CONFIGURE</makevar> がセットされていれば,
                <filename><makevar>WRKSRC</makevar>/configure</filename> が
                実行されます.</para>
            </listitem>

            <listitem>
              <para><makevar>USE_IMAKE</makevar> がセットされていれば,
                <makevar>XMKMF</makevar>
                (デフォルトでは <command>xmkmf -a</command>) が
                実行されます.</para>
            </listitem>
          </orderedlist>
        </step>

        <step>
          <para>最後に <maketarget>build</maketarget> ターゲットが実行されます.
            これは作業ディレクトリ (<makevar>WRKSRC</makevar>) に降りていき,
            ビルド (コンパイル) を実行するのが役目です.
            <makevar>USE_GMAKE</makevar> がセットされていれば
            GNU <command>make</command> が使用され,
            セットされていなければ FreeBSD の <command>make</command> が
            使用されます.</para>
        </step>
      </procedure>

      <para>上記はデフォルトの動作です. これに加えて
        <maketarget>pre-<replaceable> 何とか</replaceable></maketarget>や
        <maketarget>post-<replaceable> 何とか</replaceable></maketarget>という
        ターゲットを定義したり, そのような名前のスクリプトを
        <filename>scripts</filename> サブディレクトリに置くことも可能で,
        それぞれデフォルトの動作の前や後に実行されます.</para>

      <para>たとえば, <maketarget>post-extract</maketarget> ターゲットが
        <filename>Makefile</filename> に定義されていて,
        <filename>scripts</filename> サブディレクトリに
        <filename>pre-build</filename> というファイルが置かれている場合,
        <maketarget>post-extract</maketarget> ターゲットは
        通常の展開動作の後に呼び出され,
        <filename>pre-build</filename> スクリプトは
        デフォルトのコンパイル動作の前に実行されます.
        実行する動作が簡単であれば, スクリプトよりも
        <filename>Makefile</filename> のターゲットを使用することが
        推奨されています.
        なぜなら, その port では どのような非標準の動作が必要とされるのか,
        一箇所にまとめて書いてあった方が他の人に理解しやすいからです.</para>

      <para>デフォルトの動作は <filename>bsd.port.mk</filename> の
        <maketarget>do-<replaceable> 何とか</replaceable></maketarget>という
        ターゲットで実行されます.
        たとえば port を展開するコマンドは
        <maketarget>do-extract</maketarget> ターゲットに書かれています.
        もしデフォルトのターゲットに不満があれば,
        <filename>Makefile</filename> 中で
        <maketarget>do-<replaceable> 何とか</replaceable></maketarget>という
        ターゲットを再定義することにより,
        好きなように変更することができます.</para>

      <note>
        <para><quote>メイン</quote>のターゲット
          (たとえば <maketarget>extract</maketarget>,
          <maketarget>configure</maketarget>, その他) は, 
          すべての前段階が実行されていることを確認してから,
          実際のターゲットやスクリプトを呼び出す以外のことは
          行ないませんし, これらが変更されることも想定されていません.
          もし展開の方法を変更したいときには
          <maketarget>do-extract</maketarget> の変更によって実現し,
          絶対に <maketarget>extract</maketarget> には
          手を触れないでください.</para>
      </note>

      <para>これで, ユーザが <command>make</command> と
        入力したときに何が起こるのかが理解できたと思います.
        では, 完璧な port を作成するための推奨手順を
        順に見ていきましょう.</para>
    </sect1>

    <sect1>
      <title>オリジナルのソースの入手</title>

      <para>(通常の場合,) 圧縮された tar ファイルの形
        (<filename><replaceable>foo</replaceable>.tar.gz</filename> あるいは
        <filename><replaceable>foo</replaceable>.tar.Z</filename>) で
        オリジナルのソースを入手して, 
        それを <makevar>DISTDIR</makevar> にコピーします.
        できる限り, <emphasis>主流の</emphasis>ソースを
        使用するようにしてください.</para>

      <para>ネットワークへの接続の良好な FTP/HTTP サイトを
        見つけることができなかったり, 頭にくるような非標準的な形式しか
        置いていないサイトしか見つけられないときには,
        自分の管理下にあり信頼できる FTP サーバや http サーバ
        (たとえば, あなた自身のホームページ) に置くこともできます.
        あなたが選んだサーバが <makevar>MASTER_SITES</makevar> に
        正しく反映されていることを確認してください.</para>

      <para>そのような便利かつ信頼のおける置き場所が見つからない場合,
        我々が <hostid>ftp.FreeBSD.org</hostid> に
        置き場所を提供することもできます.
        配布ファイルは, 誰かの <hostid>freefall</hostid> アカウントの
        <filename>~/public_distfiles/</filename> に置かれることでしょう.
        その port をコミットする人に, 置いてもらえるように頼んでください.
        その人は配布ファイルを置いて, <makevar>MASTER_SITES</makevar> を
        <makevar>MASTER_SITE_LOCAL</makevar> にセットし,
        <makevar>MASTER_SITE_SUBDIR</makevar> には
        自分の <hostid>freefall</hostid> ユーザ名を
        入れておいてくれるでしょう.</para>

      <para>その port の配布ファイルが特に理由もなく
        しょっちゅう変わる場合には, その配布ファイルを
        あなたのホームページに置いて, <makevar>MASTER_SITES</makevar> の
        最初に指定することも考えてみてください.
        そうすれば, ユーザが <errorname>checksum mismatch</errorname> エラーに
        悩まされることもなくなりますし, FreeBSD の FTP サイトの
        保守担当者の負担も減らすこともできます.
        また, その port にマスターサイトが一つしか存在しない場合には,
        あなたのサイトにバックアップを置き,
        それを <makevar>MASTER_SITES</makevar> の 2 番目に
        指定すると良いでしょう.</para>

      <para>その port がインターネット上で入手できる追加パッチを
        必要とするのなら, それも取ってきて
        <makevar>DISTDIR</makevar> に置いてください.
        それらがメインのソースの tar ファイルとは別のサイトに
        あったとしても, 心配する必要はありません.
        そのような状況にも ちゃんと対応できるようになっています
        (後述の <link linkend="porting-patchfiles">PATCHFILES の記述</link>を
        ご覧ください).</para>
    </sect1>

    <sect1>
      <title>port の修正</title>

      <para>作業用のディレクトリに tar ファイルを展開し,
        最新バージョンの FreeBSD 上で正しくコンパイルするために必要な,
        あらゆる変更を行ないます.
        この処理は最終的に自動化するわけですから,
        何を行なったかを<emphasis>注意深く記録しておきましょう</emphasis>.
        この port が完成した暁には, ファイルの削除, 追加,
        修正を含むすべての処理が自動化されたスクリプトや
        パッチファイルで行なえるようになっていなければなりません.</para>

      <para>その port のコンパイルやインストールのために必要な手作業が
        あまりに多いようならば, Larry Wall の芸術的な
        <application>Configure</application> スクリプトを
        参考にしたほうが良いかもしれません.
        新しい ports collection は, エンドユーザにとって個々の port が
        可能な限り<quote>プラグ &amp; プレイ</quote>かつ
        最小のディスク消費で make できることを目指しています.</para>

      <note>
        <para>明示的に記述されている場合を除き, あなたが作成して
          FreeBSD の ports collection に寄付したパッチファイル,
          スクリプトおよびその他のファイルは, 標準的な BSD の
          著作権条件によりカバーされているものと見なされます.</para>
      </note>
    </sect1>

    <sect1>
      <title>パッチの適用</title>

      <para>port の準備段階で追加されたり変更されたりしたファイルは,
        再帰的 diff によりパッチファイル化することができます.
        パッチは適当にまとめて
        <filename>patch-<replaceable>*</replaceable></filename>
        という名前のファイルに入れてください.
        <filename><replaceable>*</replaceable></filename> は
        パッチが適用される順番を示します &mdash; これらは
        <emphasis>アルファベット順</emphasis>,
        つまり <literal>aa</literal> が最初,
        <literal>ab</literal> が その次といった順番で処理されます.
        お望みなら, <filename>patch-Imakefile</filename> とか
        <filename>patch-src-config.h</filename> のように,
        パッチ対象のファイルのパス名を示す名前を使うこともできます.
        これらのファイルは <makevar>PATCHDIR</makevar> に置いてください.
        そうすれば自動的に適用されるようになっています.
        すべてのパッチは <makevar>WRKSRC</makevar> からの相対パスにする
        べきです (通常, <makevar>WRKSRC</makevar> は port の tar ファイルが
        展開されるディレクトリで, make が実行されるところと同じです).
        修正やアップグレードを容易にするため, 複数のパッチで
        同じファイルを修正するのは避けてください
        (たとえば, <filename>patch-aa</filename> と
        <filename>patch-ab</filename> が共に
        <filename><makevar>WRKSRC</makevar>/foobar.c</filename> を
        修正するなど).</para>
    </sect1>

    <sect1>
      <title>コンフィグレーション</title>

      <para>カスタマイズのために追加したいコマンドがあれば,
        <filename>configure</filename> という名前のスクリプトに入れて
        <filename>scripts</filename> サブディレクトリに置いてください.
        上で述べたように, <filename>pre-configure</filename>
        あるいは <filename>post-configure</filename> という
        <filename>Makefile</filename> ターゲットや,
        スクリプトで処理することもできます.</para>
    </sect1>

    <sect1>
      <title>ユーザからの入力の扱い</title>

      <para>もし, その port がビルド, コンフィグレーション, または
        インストールの際にユーザからの入力を必要とするならば,
        <filename>Makefile</filename> 中で
        <makevar>IS_INTERACTIVE</makevar> をセットしてください.
        これにより, ユーザが環境変数 <envar>BATCH</envar> を
        セットしている場合には, この port の処理がスキップされるので
        &ldquo;夜間の無人ビルド&ldquo; が実行可能になります.
        (逆に環境変数 <envar>INTERACTIVE</envar> がセットされていると,
        ユーザからの入力を必要とする port <emphasis>だけ</emphasis>が
        コンパイルされます).</para>

      <para>もし, 適切なデフォルト設定が存在するのであれば,
        <makevar>PACKAGE_BUILDING</makevar> 変数をチェックして,
        それが設定されている場合には
        ユーザ入力のスクリプトを起動しないようにしてください.
        こうすることによって, 我々 ports 管理者が
        CDROM や FTP に 置く package を作成することができます.
      </para>
    </sect1>
  </chapter>

  <chapter>
    <title><filename>Makefile</filename> の作成</title>

    <para><filename>Makefile</filename> の作成は非常に単純です.
      繰り返しますが, 始めるまえに既存の例を見ておくことを推奨します.
      また, このハンドブックには <link
      linkend="porting-samplem">Makefile のサンプル</link>があります.
      それを見て, Makefile 内の変数の順番や
      空行を入れるところなどの参考にしてください.
      そうすると他の人々にも読みやすいものとなります.</para>

    <para>では, <filename>Makefile</filename> を設計するときに
      問題となるところを順に追って見てみましょう.</para>

    <sect1>
      <title>オリジナルのソース</title>

      <para>ソースは <filename>foozolix-1.2.tar.gz</filename> といった名前の
        標準的な gzip された tar ファイルの形式で
        <makevar>DISTDIR</makevar> に置かれていますか?
        そうなっていれば, 次のステップに進めます.
        異なっている場合には, 変数 <makevar>DISTNAME</makevar>, 
        <makevar>EXTRACT_CMD</makevar>,
        <makevar>EXTRACT_BEFORE_ARGS</makevar>,
        <makevar>EXTRACT_AFTER_ARGS</makevar>,
        <makevar>EXTRACT_SUFX</makevar>,
        <makevar>DISTFILES</makevar> のうち
        いくつかを書き換える必要があります.
        どれだけ変更しないといけないかは, その port の配布ファイルが
        どの程度標準からかけはなれているかによります
        (最もよくあるのは gzip ではなく普通の compress コマンドで
        tar ファイルが圧縮されている場合で, そのときは
        <literal>EXTRACT_SUFX=.tar.Z</literal> とするだけです).</para>

      <para>最悪の場合には, 自分で
        <maketarget>do-extract</maketarget> ターゲットを作成して,
        デフォルトを上書きすることもできます.
        しかし, そこまでする必要があることはめったにないでしょう.</para>
    </sect1>

    <sect1>
      <title><makevar>PORTNAME</makevar> および
        <makevar>PORTVERSION</makevar></title>

      <para><makevar>DISTNAME</makevar> には
        port の名前の基幹部分を入れ,
        <makevar>PORTVERSION</makevar>
        には port のバージョン番号を入れます.</para>
    </sect1>

    <sect1>

      <title><makevar>PORTREVISION</makevar> および
        <makevar>PORTEPOCH</makevar></title>

      <sect2>
        <title><makevar>PORTREVISION</makevar></title>

        <para><makevar>PORTREVISION</makevar> 変数は単調増加する値です.
          <makevar>PORTVERSION</makevar> が増加した時 (つまり,
          新しいオフィシャルベンダーリリースが行なわれた時) には
          いつでも 0 にリセットされます.
          また, その値が 0 でない場合には package 名に追加されます.
          その port から作られる package の内容や構造に
          大きな影響を与える変更を行なった時には,
          <makevar>PORTREVISION</makevar> を増やしてください.</para>

        <para>PORTREVISION を上げる必要がある変更の例:</para>

        <itemizedlist>
          <listitem>
            <para>セキュリティ上の脆弱性やバグを修正するため, または
              その port に新しい機能性を追加するためのパッチの追加.</para>
          </listitem>

          <listitem>
            <para>package のコンパイル時オプションの有効化や
              無効化のための Makefile の変更.</para>
          </listitem>

          <listitem>
            <para>パッキングリストの変更や, package のインストール時の
              挙動の変更 (たとえば, ssh のホストキーのような package の
              初期データを生成するスクリプトの変更など).</para>
          </listitem>

          <listitem>
            <para>その port が依存する共有ライブラリのバージョンを
              上げる場合 (新しいバージョンの共有ライブラリが
              インストールされた後に, そのライブラリに依存していた
              古い package をインストールを試みる場合,
              その package は新しい libfoo.(x+1) ではなく
              古い libfoo.x を探そうとするため, インストールに失敗します.
              (訳注: そのため, PORTREVISION を上げた package を
              作成する必要があるわけです)).</para>
          </listitem>

          <listitem>
            <para>ひそかに port 配布ファイルの変更が行なわれ,
              その機能に大きな変化があった場合.
              つまり, <filename>distinfo</filename> の修正を
              必要とするような配布ファイルの変更が行なわれ, 
              新旧のバージョンの <command>diff -ru</command> を取ると
              些細とは言えない変更が認められるにもかかわらず,
              オリジナルのバージョン番号が変更されていないことから
              <makevar>PORTVERSION</makevar> の変更は難しい場合.</para>
          </listitem>
        </itemizedlist>

        <para>PORTREVISION を上げる必要の無い変更の例:</para>

        <itemizedlist>
          <listitem>
            <para>生成される package に機能の変化が起らないような
              port スケルトンのスタイル変更.</para>
          </listitem>

          <listitem>
            <para>生成される package に影響しないような
              <makevar>MASTER_SITES</makevar> その他の
              port に対する機能変更.</para>
          </listitem>

          <listitem>
            <para>誤植の修正などの些細な変更で, その package のユーザが
              アップグレードを必要とするほどには重要でないパッチ.</para>
          </listitem>

          <listitem>
            <para>以前にはコンパイルが通らなかった package を
              ビルド可能にするための修正 (その port が以前にビルド可能だった
              プラットフォームにおいて, その変更により何らかの機能的な
              違いが発生しない場合に限ります).
              <makevar>PORTREVISION</makevar> は package の内容を
              反映したものなので, その package が以前にビルド可能でなければ
              内容の変更も無いため, <makevar>PORTREVISION</makevar> を
              増やす必要はありません.</para>
          </listitem>
        </itemizedlist>

        <para>経験的な判断方法としては, ある port にコミットされた変更が
          (それが強化や修正によるものであれ, 新しい package による
          実質的な効能であれ), アップデートすることにより誰かがどこかで
          利益を受けるような何か かどうか自問してみることです.

          もし答がイエスであれば, 新しい package が利用可能になった事実を
          (例えば <command>pkg_version</command> 等の) 自動化ツールが
          強調することができるように, <makevar>PORTREVISION</makevar> を
          上げるべきでしょう.</para>
      </sect2>

      <sect2>
        <title><makevar>PORTEPOCH</makevar></title>

        <para>ソフトウェアのベンダや FreeBSD の port 作成者は,
          以前のものよりも小さい数字のバージョン番号をつけたソフトウェアを
          リリースするといった, 何か馬鹿げたことをすることが時々あります.
          例をあげると, ある port が foo-20000801 から foo-1.0 になる
          といった具合です (数字として見ると 20000801 は 1 よりも大きいため,
          間違って前者の方が新しいバージョンとして扱われてしまいます).</para>

        <para>このような場合には <makevar>PORTEPOCH</makevar> バージョンを
          増やしてください.
          上のセクション 0 で説明したように,
          <makevar>PORTEPOCH</makevar> がゼロでない場合には,
          それがパッケージ名の後ろにつけられます.
          <makevar>PORTEPOCH</makevar> は減らされたり, ゼロに
          リセットされることはありません.
          さもないと, 以前に作成された package との比較に失敗する
          (つまり, その package が古くなっていることがわからない) ためです:
          新しいバージョン番号 (上の例では<literal>1.0,1</literal>) は
          依然として前のバージョン番号 (20000801) よりも
          数字としては小さいのですが, 自動化ツールが
          サフィックス <literal>,1</literal> を特別扱いすることで,
          以前の package には明示されていないサフィックス ",0" よりも
          新しいことがわかります.</para>

        <para>大多数の ports では, <makevar>PORTEPOCH</makevar> が
          必要になることは まず無いものと考えられています.
          また, 注意深く <makevar>PORTVERSION</makevar> を
          使用することで, そのソフトウェアの将来のリリースが
          バージョン構造を変更する必要が出てきた場合にも, 多くの場合
          前もって対応しておくことができるでしょう.
          しかし, 「スナップショット」リリースのように, オフィシャルな
          バージョン番号を持たないベンダーリリースが行なわれた時には,
          FreeBSD 版の port 作者によるケアが必要になります.
          そういったリリースに対し, リリース日付を使ったラベルを
          付けたいという誘惑にかられることがあるでしょうが,
          そうすると新しい「オフィシャル」リリースが行なわれた時に,
          上の例で示したような問題が起きることでしょう.</para>

        <para>例えば, あるソフトウェアのスナップショットリリースが
          20000917 に行なわれ, 以前のバージョン番号が 1.2 だったとすると,
          そのスナップショットの <makevar>PORTVERSION</makevar> には
          20000917 ではなく 1.2.20000917 か何か, そのような番号を
          指定するのが良いでしょう.
          そうしておけば, 例えばバージョン番号 1.3 として後続のリリースが
          行なわれた場合にも, 大小関係が崩されずにすむわけです.</para>
      </sect2>

      <sect2>
        <title><makevar>PORTREVISION</makevar> と
          <makevar>PORTEPOCH</makevar> の使い方の例</title>

        <para>gtkmumble の port, バージョン 0.10 が
          ports collection にコミットされます.</para>

        <programlisting>PORTNAME=       gtkmumble
PORTVERSION=    0.10</programlisting>

        <para><makevar>PKGNAME</makevar> は
          <literal>gtkmumble-0.10</literal> になります.</para>

        <para>ローカルな FreeBSD パッチを必要とする
          セキュリティホールが発見されました.
          それに合わせて <makevar>PORTREVISION</makevar> を増やします.</para>

        <programlisting>PORTNAME=       gtkmumble
PORTVERSION=    0.10
PORTREVISION=   1</programlisting>

        <para><makevar>PKGNAME</makevar> は
          <literal>gtkmumble-0.10_1</literal> になります.</para>

        <para>ベンダから 0.2 という番号が振られた
          新バージョンがリリースされます (これにより,
          作者は <literal>0.10</literal> という番号を
          <quote>0.9 の次という意味ではなく</quote>,
          実際には <literal>0.1.0</literal> のつもりで
          使用していたことがわかります - あらら, 今さら遅すぎる).
          新しいマイナーバージョン <literal>2</literal> は数字として
          以前のバージョン番号 <literal>10</literal> より小さいので,
          強制的に新しい package の方を「より新しい」と認識させるため
          <makevar>PORTEPOCH</makevar> を増やす必要があります.
          これは新しいベンダーリリースなので,
          <makevar>PORTREVISION</makevar> は 0 にリセット
          (または Makefile から削除) されます.</para>

         <programlisting>PORTNAME=       gtkmumble
PORTVERSION=    0.2
PORTEPOCH=      1</programlisting>

        <para><makevar>PKGNAME</makevar> は
          <literal>gtkmumble-0.2,1</literal> になります.</para>

        <para>次のリリースは 0.3 です.
          <makevar>PORTEPOCH</makevar> は減少することが無いため,
          今度のバージョン変数は次のようになります:</para>

         <programlisting>PORTNAME=       gtkmumble
PORTVERSION=    0.3
PORTEPOCH=      1</programlisting>

        <para><makevar>PKGNAME</makevar> は
          <literal>gtkmumble-0.3,1</literal> になります.</para>

        <note>
          <para>もし, このアップグレードによって
            <makevar>PORTEPOCH</makevar> が <literal>0</literal> に
            リセットされたとすると, <literal>3</literal> は数字として
            <literal>10</literal> よりも小さいため,
            gtkmumble-0.10_1 の package をインストールした誰かは
            gtkmumble-0.3 の package の方が新しいことに
            気がつかないことになるでしょう.</para>
        </note>
      </sect2>
    </sect1>

    <sect1>
      <title><makevar>PKGNAMEPREFIX</makevar> および
        <makevar>PKGNAMESUFFIX</makevar></title>

      <para>二つのオプション変数 <makevar>PKGNAMEPREFIX</makevar> と
        <makevar>PKGNAMESUFFIX</makevar> は,
        <makevar>PORTNAME</makevar> および
        <makevar>PORTVERSION</makevar> と結合され,
        <makevar>PKGNAME</makevar> を
        <literal>${PKGNAMEPREFIX}${PORTNAME}${PKGNAMESUFFIX}-${PORTVERSION}</literal>
        として定義します.
        この時, <link linkend="porting-pkgname">適切な package 名を選ぶための
        ガイドライン</link>に沿っているかどうかを確認してください.
        特に, <makevar>PORTVERSION</makevar> 中に
        ハイフン (<literal>-</literal>) を使用することは禁止されています.
        また, package 名に
        <replaceable>language-</replaceable> もしくは
        <replaceable>compiled.specifics</replaceable> 部分が
        含まれる場合, それぞれ <makevar>PKGNAMEPREFIX</makevar> と
        <makevar>PKGNAMESUFFIX</makevar> を使用してください.
        これらを <makevar>PORTNAME</makevar> の一部としてはいけません.</para>
    </sect1>

    <sect1>
      <title><makevar>DISTNAME</makevar></title>

      <para><makevar>DISTNAME</makevar> は製作者が決めたソフトウェアの名前です.
        デフォルトでは <makevar>DISTNAME</makevar> は
        <literal>${PORTNAME}-${PORTVERSION}</literal> になりますが,
        必要に応じて書き換えることができます.
        <makevar>DISTNAME</makevar> は二つの場所でしか使われません.
        一つ目は配布ファイルリスト (<makevar>DISTFILES</makevar>) のデフォルト
        <makevar>${DISTNAME}</makevar><makevar>${EXTRACT_SUFX}</makevar> で,
        二つ目は配布ファイルが展開される
        サブディレクトリ <makevar>WRKSRC</makevar> のデフォルト
        <filename>work/<makevar>${DISTNAME}</makevar></filename> です.</para>

      <note>
        <para><makevar>PKGNAMEPREFIX</makevar> や
          <makevar>PKGNAMESUFFIX</makevar> は
          <makevar>DISTNAME</makevar> に影響を与えません.
          また, 元のソースアーカイブが
          <makevar>${PORTNAME}-${PORTVERSION}${EXTRACT_SUFX}</makevar> という
          名前ではないのに, <makevar>WRKSRC</makevar> を
          <filename>work/<makevar>${PORTNAME}-${PORTVERSION}</makevar></filename> と
          設定している場合, おそらく <makevar>DISTNAME</makevar> は
          そのままにしておく必要があることに注意してください &mdash;
           <makevar>DISTNAME</makevar> と <makevar>WRKSRC</makevar> の
           両方を (そして おそらく <makevar>EXTRACT_SUFX</makevar> も)
           セットするよりは, <makevar>DISTFILES</makevar> を
           定義する方が楽でしょう.</para>
      </note>
    </sect1>

    <sect1>
      <title><makevar>CATEGORIES</makevar></title>

      <para>完成した package の実体は
        <filename>/usr/ports/packages/All</filename> に置かれ,
        一つかそれ以上の <filename>/usr/ports/packages</filename> の
        サブディレクトリからのシンボリックリンクが作られます.
        これらのサブディレクトリの名前は <makevar>CATEGORIES</makevar> という
        変数によって指定されます.
        これは, ユーザが FTP サイトや CDROM 上の package の山を
        渡り歩くことを容易にするためのものです.
        既存の<link linkend="porting-categories">カテゴリ</link>を見て,
        その port に適したものを選んでください.</para>

      <para>このリストは, この port が port ツリーの
        どこに取り込まれるかも決定します.
        二つ以上のカテゴリを指定した場合には,
        最初のカテゴリで指定されるサブディレクトリに置かれることになります.
        適切なカテゴリを選ぶ方法については,
        <link linkend="porting-categories">カテゴリ</link>のセクションを
        参照してください.</para>

      <para>本当にその port が現存するカテゴリのいずれにも
        当てはまらない場合には, 新しいカテゴリ名を作ることもできます.
        その場合, 新しいカテゴリ名を提案するメールを &a.ports; あてに
        送ってください.</para>
    </sect1>

    <sect1>
      <title><makevar>MASTER_SITES</makevar></title>

      <para>元になる配布ファイルを指し示す, FTP/HTTP の URL のファイル名を
        除いた部分を <makevar>MASTER_SITES</makevar> に設定します.
        最後にスラッシュ (<filename>/</filename>) をつけることを
        お忘れなく!</para>

      <para>このシステム上に配布ファイルが見つからなかった場合,
        <command>make</command> マクロは <makevar>FETCH</makevar> を使って
        この変数に指定されたサイトから配布ファイルを取得しようとします.</para>

      <para>このリストには, できれば異なる大陸に存在する
        複数のサイトを入れておくことが推奨されています.
        これにより, 広域ネットワークのトラブルに対する
        耐性を高めることができます.
        さらに私たちは, 自動的に最も近いマスタサイトを判断して,
        そこから取ってくるメカニズムの導入を計画しています.</para>

      <para>元になる tar ファイルが X-contrib や GNU, Perl CPAN 等の
        有名なアーカイブサイトに置かれている場合には,
        <makevar>MASTER_SITE_<replaceable>*</replaceable></makevar> を使って
        これらのサイトを簡潔に
        (例えば <makevar>MASTER_SITE_XCONTRIB</makevar> とか,
        <makevar>MASTER_SITE_PERL_CPAN</makevar> のように)
        指定することができます.
        <makevar>MASTER_SITES</makevar> を これらの変数の一つにセットし,
        サイト内でのパスを <makevar>MASTER_SITE_SUBDIR</makevar> に
        指定するだけです.
        以下に例を示します.</para>

      <programlisting>MASTER_SITES=         ${MASTER_SITE_XCONTRIB}
MASTER_SITE_SUBDIR=   applications</programlisting>

      <para>これらの変数は <filename>/usr/ports/Mk/bsd.sites.mk</filename> で
        定義されています.
        いつでも新しいアーカイブサイトが追加されますので,
        port を提出する前に このファイルの最新版を
        チェックするように心掛けてください.</para>

      <para>ユーザは <filename>/etc/make.conf</filename> 中で
        <makevar>MASTER_SITE_*</makevar> 変数を上書きすることもできます.
        そうすることで, これらの有名なアーカイブそのものではなく,
        好みのミラーサイトを使用することができます.</para>
    </sect1>

    <sect1 id="porting-patchfiles">
      <title><makevar>PATCHFILES</makevar></title>

      <para>その port が配布ファイルの他に FTP や HTTP で手に入る
        追加パッチを必要とする場合には, <makevar>PATCHFILES</makevar> には
        そのパッチのファイル名を, <makevar>PATCH_SITES</makevar> には
        そのファイルが置かれているディレクトリの URL をセットしてください.
        (書き方は <makevar>MASTER_SITES</makevar> と同じです.)</para>

      <para>そのパッチに記録されているファイル名に余計なパス名が
        ついていて, ソースツリーのトップディレクトリ (つまり
        <makevar>WKRSRC</makevar>) からの相対パスになっていない場合には,
        それに応じた <makevar>PATCH_DIST_STRIP</makevar> を指定してください.
        たとえば, パッチ内のすべてのファイル名の先頭に,
        余計な <literal>foozolix-1.0/</literal> がついている場合には,
        <literal>PATCH_DIST_STRIP=-p1</literal> としてください.</para>

      <para>これらのパッチは圧縮されていても大丈夫です.
        ファイル名が <filename>.gz</filename> や <filename>.Z</filename> で
        終わる場合には, 自動的に展開されるようになっています.</para>

      <para>もしパッチが, ドキュメント等その他のファイルと一緒に
        gzip された tar ファイルで配布されている場合には,
        単に <makevar>PATCHFILES</makevar> を使うだけではうまくいきません.
        このような場合には, このパッチの tar ファイルの名前と場所を
        <makevar>DISTFILES</makevar> と <makevar>MASTER_SITES</makevar> に
        追加しておきます.
        それから, <makevar>EXTRA_PATCHES</makevar> 変数に
        それらのパッチを指定すれば, <filename>bsd.port.mk</filename> が
        自動的にパッチを適用してくれます.
        特に注意が必要なのは, パッチファイルを <makevar>PATCHDIR</makevar>
        ディレクトリにコピー<emphasis>してはならない</emphasis>ことです
        &mdash; (訳注: port が CD-ROM 上に置かれている等の場合には,) 
        そのディレクトリには書き込みができないかもしれません.</para>

      <note>
        <para>それが普通の gzip か compress された tar ファイルであれば,
          通常のソースファイルと一緒にパッチ適用時までに展開されていますので,
          明示的に展開する必要はないことに注意してください.
          もしパッチを <makevar>DISTFILES</makevar> に追加した場合には,
          パッチを含むファイルが展開される際に, そのディレクトリにある
          何かを上書きしないように注意してください.
          さらに, コピーされたパッチファイルを削除するコマンドを
          <maketarget>pre-clean</maketarget> ターゲットに追加することを
          忘れないでください.</para>
      </note>
    </sect1>

    <sect1>
      <title><makevar>MAINTAINER</makevar></title>

      <para>あなたのメールアドレスをここに入れてください.
        お願いします.
        <!-- smiley --><emphasis remap=tt>:-)</emphasis></para>

      <para>保守担当者 (maintainer) の責任に関する詳細説明は,
        <ulink url="../handbook/policies.html#POLICIES-MAINTAINER">Makefile 中の MAINTAINER</ulink> の
        セクションを参照してください.</para>
    </sect1>

    <sect1>
      <title>依存関係</title>

      <para>多くの port は他の port に依存しています.
        必要なものすべてがユーザのマシン上に存在することを
        保証するために使用可能な, 5 つの変数が用意されています.
        よくあるケースのためにあらかじめ設定された依存変数に加え,
        いくつかの依存関係の制御のための変数があります.</para>

      <sect2>
        <title><makevar>LIB_DEPENDS</makevar></title>

        <para>その port が必要とする共有ライブラリを, この変数で指定します.
          (訳注: libc 等, 標準のライブラリは指定する必要がありません.) 
          これは <replaceable>lib</replaceable>:<replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional> という
          組のリストです.
          <replaceable>lib</replaceable> が共有ライブラリの名前,
          <replaceable>dir</replaceable> が
          そのライブラリが見つからない場合に
          インストールされる port のディレクトリ,
          <replaceable>target</replaceable>が
          そのディレクトリで呼ばれるターゲットです.
          たとえば,

        <programlisting>LIB_DEPENDS= jpeg.9:${PORTSDIR}/graphics/jpeg:install</programlisting>

          と指定されていた場合, まずメジャーバージョンが 9 の jpeg 共有
          ライブラリがインストールされているかどうかを確認します.
          インストールされていない場合には, ports ツリーの
          <filename>graphics/jpeg</filename> サブディレクトリに移動し,
          <replaceable>target</replaceable> のコンパイルとインストールを
          行ないます.
          <replaceable>target</replaceable> の部分は,
          それが <makevar>DEPENDS_TARGET</makevar>
          (デフォルトでは <literal>install</literal>) と
          等しいときには省略することができます.</para>

        <note>
          <para>先頭の <replaceable>lib</replaceable> の部分は
            <command>ldconfig -r | grep -wF</command> への
            引数になります.
            この変数には正規表現を入れないようにしてください.
          </para>
        </note>

        <para>
          この依存関係のチェックは,
          <maketarget>extract</maketarget> ターゲットと
          <maketarget>install</maketarget> ターゲットの中で, 2 回行なわれます.
          (訳注: これは, その port をビルドするマシンと
          インストールされるマシンが違う場合, どちらのマシンでも
          そのライブラリが利用できることを確認するためです.)
          同様に, 依存するライブラリの名前は package 中にも書き込まれていて,
          <command>pkg_add</command> 実行時に そのライブラリが
          ユーザのシステムに存在していなければ, 自動的にインストールされます.
        </para>
      </sect2>

      <sect2>
        <title><makevar>RUN_DEPENDS</makevar></title>

        <para>この port の実行時に必要となるプログラム,
          またはファイルがあるときにはこの変数で指定します.
          これは <replaceable>path</replaceable>:<replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional> という
          組のリストです.
          <replaceable>path</replaceable> がファイルまたはプログラムの名前,
          <replaceable>dir</replaceable> が それが見つからない場合に
          インストールされる port のディレクトリ,
          <replaceable>target</replaceable> が そのディレクトリで呼ばれる
          ターゲットです.
          <replaceable>path</replaceable> の最初の文字が
          スラッシュ (<literal>/</literal>) の場合には
          ファイルかディレクトリとみなし, 存在するかどうか
          <command>test -e</command> を使ってチェックします.
          そうでない場合には実行可能ファイルであると考えて,
          そのプログラムがユーザのサーチパス上にあるかどうか
          <command>which -s</command> を使って確認します.</para>

        <para>たとえば Makefile に以下のように書いてあるとします.</para>

          <programlisting>RUN_DEPENDS=   ${PREFIX}/etc/innd:${PORTSDIR}/news/inn \
                wish8.0:${PORTSDIR}/x11-toolkits/tk80</programlisting>

        <para>まず, <filename>/usr/local/etc/innd</filename> という
          ファイルかディレクトリが存在するか確認します.
          存在しない場合には, ports ツリーの
          <filename>news/inn</filename> というサブディレクトリで
          ビルドとインストールを行ないます.
          さらに, <command>wish8.0</command> というプログラムが
          ユーザのサーチパス中にあるかどうか探します.
          ない場合には同じく ports ツリーの
          <filename>x11-toolkits/tk80</filename> というサブディレクトリで
          コンパイルとインストールを行ないます.</para>

        <note>
          <para>この例で, <command>innd</command> は実際にはプログラムです.
            このように, プログラムであっても一般ユーザのサーチパスに
            含まれているとは考えにくいところに置かれているものの場合には,
            絶対パスで指定してください.</para>
        </note>

        <para>この依存関係は <maketarget>install</maketarget> ターゲット中で
          チェックされます.
          また, <command>pkg_add</command> によるインストールの際に,
          その package が依存するものがユーザのシステムに存在しない場合には
          自動的に追加インストールできるように,
          依存するものの名前も package 中に記録されます.
          <replaceable>target</replaceable> の部分が
          <makevar>DEPENDS_TARGET</makevar> と同じ場合には,
          <replaceable>target</replaceable> の部分を省略することができます.
        </para>
      </sect2>

      <sect2>
        <title><makevar>BUILD_DEPENDS</makevar></title>

        <para>この port のビルド時に必要となるプログラム,
          またはファイルがあるときにはこの変数で指定します.
          <makevar>RUN_DEPENDS</makevar> と同様に,
          これは <replaceable>path</replaceable>:<replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional> という
          組のリストです.
          たとえば,

          <programlisting>BUILD_DEPENDS=unzip:${PORTSDIR}/archivers/unzip</programlisting>

          と指定されていた場合, まず <command>unzip</command> という名前の
          プログラムがインストールされているかどうかを確認します.
          インストールされていない場合には ports ツリーの
          <filename>archivers/unzip</filename> サブディレクトリに移動し,
          ビルドとインストールを行ないます.</para>

        <note>
          <para>ここで言う<quote>ビルド</quote>とは, ファイルの展開から
            コンパイルまでのすべての処理を意味します.
            この依存関係は, <maketarget>extract</maketarget> ターゲットの中で
            チェックされます.
            <replaceable>target</replaceable> の部分は,
            <makevar>DEPENDS_TARGET</makevar> と同じ場合には
            省略することができます.</para>
        </note>
      </sect2>

      <sect2>
        <title><makevar>FETCH_DEPENDS</makevar></title>

        <para>この port を取ってくるのに必要となるプログラム,
          またはファイルがあるときにはこの変数で指定します.
          上の二つと同様に, これは <replaceable>path</replaceable>:<replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional> という
          組のリストです. たとえば,

          <programlisting>FETCH_DEPENDS=ncftp2:${PORTSDIR}/net/ncftp2</programlisting>

          と指定されていれば, <command>ncftp2</command> という名前の
          プログラムを探します.
          見つからない場合には, ports ツリーの
          <filename>net/ncftp2</filename> サブディレクトリで
          ビルドとインストールを行ないます.

        <para>この依存関係は <maketarget>fetch</maketarget> ターゲット中で
          チェックされます.
          <replaceable>target</replaceable> の部分は,
          <makevar>DEPENDS_TARGET</makevar> と同じ場合には
          省略することができます.
      </sect2>

      <sect2>
        <title><makevar>DEPENDS</makevar></title>

        <para>上記の四つのいずれにもあてはまらないような依存関係がある場合,
          または他の port がインストールされているだけではなく
          ソースが展開されている必要がある場合には, この変数を使います.
          これは上記の四つと違い, 特に<quote>確認</quote>するものが
          ありませんので,
          <replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional>
          という形式のリストになります.
          <replaceable>target</replaceable> の部分は
          <makevar>DEPENDS_TARGET</makevar> と同じ場合には
          省略することができます.</para>
      </sect2>

      <sect2>
        <title>よくある依存関係を表す変数</title>

        <para>その ports が X Window System を必要とするのであれば,
          <literal>USE_XLIB=yes</literal> を定義してください
          (これは <makevar>USE_IMAKE</makevar> が定義されていれば
          自動的に定義されます).
          BSD <command>make</command> ではなく
          GNU <command>make</command> を必要とする場合には
          <literal>USE_GMAKE=yes</literal> を,
          GNU autoconf を実行する必要がある場合には
          <literal>USE_AUTOCONF=yes</literal> を,
          最新の qt toolkit を使用する場合には
          <literal>USE_QT=yes</literal> を,
          perl 言語のバージョン 5 を必要とする場合には
          <literal>USE_PERL5=yes</literal> を定義してください
          (特に最後のものは重要です.
          FreeBSD のバージョンにより, 基本システムに perl5 が
          含まれていたり, いなかったりします).</para>
      </sect2>

      <sect2>
        <title>依存関係に関する注意</title>

        <para>上で述べたように, 依存する ports が必要になったときに
          呼ばれるデフォルトのターゲットは
          <maketarget>DEPENDS_TARGET</maketarget> で,
          そのデフォルトは <literal>install</literal> です.
          これはユーザが使用する変数であり,
          port の <filename>Makefile</filename> で定義するものではありません.
          もし, その port が特別な方法で依存関係を扱う必要がある場合には,
          <makevar>DEPENDS_TARGET</makevar> を再定義するのではなく
          <makevar>*_DEPENDS</makevar> 変数の
          <literal>:target</literal> 部分を使用してください.</para>

        <para><command>make clean</command> と入力したときには,
          その port が依存する port も自動的に clean されます.
          そうならないようにしたい場合には,
          環境変数 <makevar>NOCLEANDEPENDS</makevar> を設定してください.</para>

        <para>無条件に他の port に依存させるには,
          <makevar>BUILD_DEPENDS</makevar> や
          <makevar>RUN_DEPENDS</makevar> の最初のフィールドに
          <makevar>${NONEXISTENT}</makevar> という変数を指定してください.
          これは, 他の port のソースが必要なときのみ使用してください.
          ターゲットも指定することで,
          コンパイルの時間を節約できる場合もあります.
          たとえば

          <programlisting>BUILD_DEPENDS=   ${NONEXISTENT}:${PORTSDIR}/graphics/jpeg:extract</programlisting>

          とすると, 常に JPEG port のディレクトリに行って
          ソースの展開を行ないます.</para>

        <para>あなたがやりたいことが他の方法ではできない場合以外には
          <makevar>DEPENDS</makevar> を使わないでください.
          これは常に他の port の作成を行ない (さらにデフォルトでは
          インストールも行ない), package まで作成します.
          この動作が本当に所望のものでしたら,
          それを <literal>BUILD_DEPENDS</literal> と
          <literal>RUN_DEPENDS</literal> に書くべきでしょう
          &mdash; 少なくとも意図を明確にすることができます.</para>
      </sect2>
    </sect1>

    <sect1>
      <title>オプション選択可能な依存ライブラリ</title>

      <para>巨大なアプリケーションの中には, 複数のコンフィギュレーションで
        ビルドすることができるものがあります.
        つまり, いくつもの外部ライブラリやアプリケーションの中の,
        あるものが利用可能な場合に, それを拡張機能として使用するように
        設定することができるということです.
        それらのライブラリやアプリケーションを, 必ずしも すべてのユーザが
        必要としているわけではありませんので, ports システムでは
        どのコンフィギュレーションがビルドされるべきかを port 作者が
        決めるために使えるフックを用意しています.
        これらを適切にサポートすることにより, ユーザをハッピーにしたり,
        port 1 つ分のコストで 2 つまたはそれ以上の port を提供するのと
        同様の効率化を行なうことが可能です.</para>

      <para>これらのフックのうちで最も簡単に使えるものは
        <makevar>WITHOUT_X11</makevar> でしょう.
        その port が X Window System のサポートありと,
        サポートなしの設定でビルドできるのであれば,
        通常は X Window System サポートありでビルドするべきでしょう.
        ビルド時に <makevar>WITHOUT_X11</makevar> が定義されていれば,
        その時は X Window System サポートなしのバージョンが
        ビルドされるべきです.</para>

      <para>GNOME 環境の様々なパーツも, そのようなノブ (フック) を
        持っていますが, それらは幾分使いにくいものです.
        <filename>Makefile</filename> 中で その目的に使用される変数は
        <makevar>WANT_*</makevar> と <makevar>HAVE_*</makevar> になります.
        そのアプリケーションが, 以下に示されている依存ライブラリの
        一つについて, サポートあり, なしの両方でビルドできる場合,
        <filename>Makefile</filename> には <makevar>WANT_PKG</makevar> を
        セットする必要があります.
        そして, ビルド時に <makevar>HAVE_PKG</makevar> が定義されていれば
        <makevar>PKG</makevar> を使うバージョンがビルドされることになります.

      <para>現在, このような形でサポートされている
        <makevar>WANT_*</makevar> 変数は,
        <makevar>WANT_GLIB</makevar>, <makevar>WANT_GTK</makevar>,
        <makevar>WANT_ESOUND</makevar>, <makevar>WANT_IMLIB</makevar>,
        そして <makevar>WANT_GNOME</makevar> です.</para>
    </sect1>

    <sect1>
      <title>ビルドのメカニズム</title>

      <para>そのソフトウェアがビルドの際に GNU <command>make</command> を
        使う場合には, <literal>USE_GMAKE=yes</literal> をセットしてください.
        <command>configure</command> を使う場合には,
        <literal>HAS_CONFIGURE=yes</literal> をセットしてください.
        GNU <command>configure</command> を使う場合には,
        <literal>GNU_CONFIGURE=yes</literal> をセットしてください (これにより
        <literal>HAS_CONFIGURE</literal> もセットされます).
        <command>configure</command> に追加の引数を渡したい場合には,
        追加部分を <makevar>CONFIGURE_ARGS</makevar> に指定してください.
        (デフォルトの引数リストは, GNU <command>configure</command> では
        <literal>--prefix=&dollar;{PREFIX}</literal> に,
        GNU でない <command>configure</command> では空リストになります.)
        GNU <command>autoconf</command> を使う場合には,
        <literal>USE_AUTOCONF=yes</literal> をセットしてください.
        これにより <makevar>GNU_CONFIGURE</makevar> もセットされ,
        <command>configure</command> を実行する前に
        <command>autoconf</command> が実行されます.</para>

      <para>そのソフトウェアが X Window System のアプリケーションなどで,
        <command>imake</command> を使って <filename>Imakefile</filename> から
        <filename>Makefile</filename> を作成する場合には,
        <literal>USE_IMAKE=yes</literal> を指定してください.
        そうするとコンフィグレーションステージで自動的に
        <command>xmkmf -a</command> が実行されます.
        もし <option>-a</option> フラグが問題を引き起こすなら,
        さらに <literal>XMKMF=xmkmf</literal> をセットしてください.
        もし, その port が <command>imake</command> を使用するけれども
        <maketarget>install.man</maketarget> ターゲットを持たない場合には,
        <literal>NO_INSTALL_MANPAGES=yes</literal> をセットしてください.
        ついでに, そのソフトウェアの作者を探し出して八つ裂きにすると
        いいでしょう.
        <!-- smiley --><emphasis>(-_-#)</emphasis></para>

      <para>そのソフトウェアの元々の <filename>Makefile</filename> が
        <maketarget>all</maketarget> 以外のものをメインのターゲットと
        している場合には, それを <makevar>ALL_TARGET</makevar> に
        指定してください.
        <maketarget>install</maketarget> と
        <makevar>INSTALL_TARGET</makevar> も同様です.</para>
    </sect1>
  </chapter>

  <chapter>
    <title>特別な配慮</title>

    <para>port を作成する場合, 考慮しなくてはいけないことが
      他にもいくつかあります.
      このセクションでは, それらのうちでも
      特によくあることについて説明します.</para>

    <sect1 id="porting-shlibs">
      <title>共有ライブラリ</title>

      <para>その port が共有ライブラリのインストールを行なう場合,
        make 変数 <makevar>INSTALLS_SHLIB</makevar> を定義してください.
        これにより, <filename>bsd.port.mk</filename> が
        <maketarget>post-install</maketarget> ターゲットの実行時に
        新しいライブラリがインストールされたディレクトリ (通常は
        <filename><makevar>PREFIX</makevar>/lib</filename>) に
        <literal>&dollar;{LDCONFIG} -m</literal> を実行し,
        共有ライブラリキャッシュへの登録が行なわれるようになります.
        また, この変数が定義されている場合, 共有ライブラリを
        インストールしたユーザが それをすぐに使い始められるように,
        また, 削除の際には そのライブラリが まだ存在していると
        システムに誤認されないように,
        適切な <literal>@exec /sbin/ldconfig -m</literal> と
        <literal>@unexec /sbin/ldconfig -R</literal> のペアが
        <filename>pkg-plist</filename> ファイルに
        指定されているように扱われます.</para>

      <para>必要であれば, 共有ライブラリがインストールされるディレクトリの
        リストを格納する make 変数 <makevar>LDCONFIG_DIRS</makevar> を
        定義することにより, 新しいライブラリがインストールされる
        デフォルトの位置を上書きすることも可能です.
        例えば, その port が共有ライブラリを
        <filename><makevar>PREFIX</makevar>/lib/foo</filename> と
        <filename><makevar>PREFIX</makevar>/lib/bar</filename> に
        インストールする場合, <filename>Makefile</filename> で
        以下の記述を使用することができます:</para>

      <programlisting>INSTALLS_SHLIB= yes
LDCONFIG_DIRS=  %%PREFIX%%/lib/foo %%PREFIX%%/lib/bar</programlisting>

      <para><filename>pkg-plist</filename> の他の部分と同様に,
        <makevar>LDCONFIG_DIRS</makevar> の内容も &man.sed.1; による
        処理が行なわれるため, ここでも <makevar>PLIST_SUB</makevar> に
        指定した置換が行なわれることに注意してください.
        <makevar>PREFIX</makevar> には <literal>%%PREFIX%%</literal> を,
        <makevar>LOCALBASE</makevar> には <literal>%%LOCALBASE%%</literal>,
        <makevar>X11BASE</makevar> には <literal>%%X11BASE%%</literal> を
        使用することを推奨します.</para>

    </sect1>
  </chapter>

<!--

  <chapter>
    <title>ELF 対応</title>

    <para>FreeBSD は 3.0-RELEASE で ELF に移行しましたので,
      共有ライブラリを作成するたくさんの port を
      ELF 対応にする必要があります.
      3.0 システムは ELF としても a.out としても動作しますし,
      わたしたちは非公式ではありますが,
      できるだけ長い間 2.2
      システムのサポートをしたいと思っていますので状況は複雑です.
      以下は a.out のみに対応している port
      をどのように a.out と ELF 両方に対応させるかのガイドラインです.</para>

    <para>このリストの一部は移行時にしかあてはまらないものもありますが,
      古い port をアップグレードしたい場合に参考になるようにしばらくのあいだは残しておきます.</para>

    <sect1>
      <title>a.out ライブラリの退避</title>

      <para>すべての a.out ライブラリは
        <filename>/usr/local/lib</filename> から
        <filename>aout</filename> サブディレクトリに移動しなくはなりません
        (もし移動しないと, ELF ports
        がそれらをあっさり上書きしてしまいます).
        3.0-CURRENT の <filename>src/Makefile</filename> にある
        <maketarget>move-aout-libs</maketarget> ターゲット
        (<maketarget>aout-to-elf</maketarget> から呼ばれます)
        がその移動をしてくれます.
        a.out ライブラリを移動するだけなので,
        ELF と a.out の両方のライブラリが標準的なディレクトリにあるシステムでは,
        このターゲットを実行しても安全です.</para>
    </sect1>

    <sect1>
      <title>フォーマット</title>

      <para>ports ツリーは, そのマシンの (訳注: オブジェクト) フォーマットで
        package を作成します.
        つまり, 2.2 のマシンでは a.out で作成され,
        3.0 のマシンでは <command>`objformat`</command> の結果によって
        a.out か ELF で作成されるということです.
        また, いったん a.out ライブラリをサブディレクトリに移動すると
        a.out ライブラリの作成はサポート外となります.
        (つまり, 自分が何をやっているのかを理解していれば, 移動後にも
        うまく作成できる可能性もあるけれど, 自力でやらなければならない
        ということです.)</para>

      <note>
        <para>もし port が a.out でしか動作しないのなら,
          <makevar>BROKEN_ELF</makevar>
          に原因を説明する文字列を設定してください.
          この変数が設定された port は, ELF
          システム上でのビルドの際スキップされます.</para>
      </note>
    </sect1>

    <sect1>
      <title>PORTOBJFORMAT</title>

      <para><filename>bsd.port.mk</filename> において
        <makevar>PORTOBJFORMAT</makevar> は
        <literal>aout</literal> か
        <literal>elf</literal> に設定され, 環境変数
        <envar>CONFIGURE_ENV</envar>,
        <envar>SCRIPTS_ENV</envar>,
        <envar>MAKE_ENV</envar> の中で export されます
        (2.2-STABLE
        では常に <literal>aout</literal> になります).
        また,
        <literal>PORTOBJFORMAT=${PORTOBJFORMAT}</literal> として
        <maketarget>PLIST_SUB</maketarget> に渡されます
        (以下にある
        <literal>ldconfig</literal>
        に関するコメントを参照してください).</para>

      <para>この変数は, 以下のようにして
        <filename>bsd.port.mk</filename> 中で設定されます.</para>

      <programlisting>PORTOBJFORMAT!= test -x /usr/bin/objformat && /usr/bin/objformat || echo aout</programlisting>

      <para>この変数を使って, port の make
        の過程で何をすべきかを決定すべきですが,
        もし port の <filename>configure</filename> スクリプトが元々
        ELF システムを自動的に検出するのであれば,
        <makevar>PORTOBJFORMAT</makevar>
        を参照する必要はありません.</para>
    </sect1>

    <sect1>
      <title>共有ライブラリの作成</title>

      <para>以下は, a.out と ELF
        での共有ライブラリの扱いの違いです.</para>

      <itemizedlist>
        <listitem>
          <para>共有ライブラリのバージョン</para>

          <para>ELF の共有ライブラリは
            <filename>libfoo.so.<replaceable>M</replaceable></filename>
            という名前になっていなければなりません.
            ここで <replaceable>M</replaceable>
            は単一のバージョン番号を表します.
            一方 a.out のライブラリは
            <filename>libfoo.so.<replaceable>M</replaceable>.<replaceable>N</replaceable></filename>
            という名前で,
            <replaceable>M</replaceable> はメジャーバージョン番号,
            <replaceable>N</replaceable>
            はマイナーバージョン番号になっている必要があります.
            これらを混同しないでください.
            <filename>libfoo.so.<replaceable>N</replaceable>.<replaceable>M</replaceable></filename>
            という名の ELF 共有ライブラリや
            <filename>libfoo.so.<replaceable>N</replaceable></filename>
            という名の a.out 共有ライブラリ
            (あるいはシンボリックリンク)
            は<emphasis>絶対にインストールしないでください</emphasis>.</para>
        </listitem>

        <listitem>
          <para>リンカコマンドライン</para>

          <para>直接 <command>ld</command> を使用せずに
            <command>cc -shared</command> を使用してください.
            たった一つの違いは, ELF には,
            <option>-Wl,-<replaceable>soname,libfoo.so.M</replaceable></option>
            コマンドラインにを加える必要があることです.</para>
          < ! - - kuriyama - strange Japanese representation - - >
        </listitem>
      </itemizedlist>

      <para>ELF のリンカを満足させるためには,
        <filename>libfoo.so</filename> から
        <filename>libfoo.so.<replaceable>N</replaceable></filename>
        へのシンボリックリンクを作る必要があります.
        これは <filename>pkg-plist</filename> にも加えなくてはいけませんし,
        a.out の場合でも害にはならないので
        (一部の port
        ではダイナミックリンクローディングのために必要でもあります),
        <makevar>PORTOBJFORMAT</makevar>
        の設定を気にせずに, ただ単純にリンクを作成してください.</para>
    </sect1>

    <sect1>
      <title><makevar>LIB_DEPENDS</makevar></title>

      <para>すべての port の <filename>Makefile</filename> を編集して
        <makevar>LIB_DEPENDS</makevar>
        からマイナー番号を除去する必要があり,
        正規表現のサポートも除去する必要があります
        (たとえば,
        <literal>foo\\.1\\.\\(33|40\\)</literal> から
        <literal>foo.2</literal>).
        マッチングは <command>grep -wF</command>
        を使って行なわれます.</para>
    </sect1>

    <sect1>
      <title><filename>pkg-plist</filename></title>

      <para><filename>pkg-plist</filename> は
        a.out のマイナー番号が 0 であれば短い
        (ELFの) 共有ライブラリの名前を含み,
        そうでなければ長い (a.out の) 名前を含んでいる必要があります.
        <makevar>PORTOBJFORMAT</makevar> が
        <literal>aout</literal> であれば,
        <filename>bsd.port.mk</filename> は自動的に
        <literal>.0</literal> を短い共有ライブラリの名前の行に付け加え,
        <makevar>PORTOBJFORMAT</makevar> が <literal>elf</literal>
        であれば,
        マイナー番号を長い共有ライブラリの名前から削除します.</para>

      <para>ELF システムで二つのバージョン番号を持つ共有ライブラリをインストールしたり,
        a.out システムで一つのバージョン番号しか持たない共有ライブラリをインストールするのが避けられない場合
        (たとえば他のオペレーティングシステム用の互換ライブラリをインストールする port など),
        <makevar>NO_FILTER_SHLIBS</makevar>
        変数を定義すれば前のセクションで説明されている
        <filename>pkg-plist</filename>
        編集の機能が停止されます.</para>
    </sect1>

    <sect1>
      <title><literal>ldconfig</literal></title>

      < ! - - kuriyama - Eng. why literal? - - >
      <para><filename>Makefile</filename> 中の
        <literal>ldconfig</literal>
        の行は以下のようになります.</para>

      <programlisting>${SETENV} OBJFORMAT=${PORTOBJFORMAT} ${LDCONFIG} -m ....</programlisting>

      <para>また <filename>pkg-plist</filename> 中では,</para>

      <programlisting>@exec /usr/bin/env OBJFORMAT=%%PORTOBJFORMAT%% /sbin/ldconfig -m ...
@unexec /usr/bin/env OBJFORMAT=%%PORTOBJFORMAT%% /sbin/ldconfig -R</programlisting>

      <para>となります. これは,
        システムのデフォルトフォーマットではなく package のフォーマットに応じて,
        正しい
        <command>ldconfig</command>
        が呼ばれることを保証するためのものです.</para>
    </sect1>
  </chapter>

-->

  <chapter id="porting-masterdir">
    <title><makevar>MASTERDIR</makevar></title>

    <para>その port の変数 (たとえば解像度とか紙のサイズなど) を
      変えたりした, 少しだけ違うバージョンを作成する必要があるときには,
      ユーザが分りやすいように package ごとに別々のサブディレクトリを作成し,
      できるだけ port 間でファイルを共有するようにしてください.
      ほとんどの場合, うまく変数を使えば, 一つを除くすべてのディレクトリには
      とても短い <filename>Makefile</filename> を置くだけで済みます.
      その短い <filename>Makefile</filename> では,
      <makevar>MASTERDIR</makevar> を使って,
      残りのファイルがあるディレクトリを指定できます.
      また, <link
      linkend="porting-pkgname"><makevar>PKGNAMESUFFIX</makevar></link> の
      一部に変数に使って, package が別々の名前を持つようにしてください.</para>

    <para>具体的な例を示すのが一番わかりやすいでしょう.
      これは <filename>japanese/xdvi300/Makefile</filename> の一部です.</para>

    <programlisting>PORTNAME=       xdvi
PORTVERSION=    17
PKGNAMEPREFIX=  ja-
PKGNAMESUFFIX=  ${RESOLUTION}
 :
# default
RESOLUTION?=   300
.if ${RESOLUTION} != 118 && ${RESOLUTION} != 240 && \
       ${RESOLUTION} != 300 && ${RESOLUTION} != 400
       @${ECHO} "Error: invalid value for RESOLUTION: \"${RESOLUTION}\""
       @${ECHO} "Possible values are: 118, 240, 300 (default) and 400."
       @${FALSE}
.endif</programlisting>

    <para><filename>japanese/xdvi300</filename> には
      <filename>Makefile</filename> の他に通常のパッチや,
      package ファイル等が置かれています.
      このディレクトリで <command>make</command> を実行すると,
      デフォルトの解像度 (300) を使って,
      普通に port のビルドを行ないます.</para>

    <para>他の解像度に関していうと,
      <filename>xdvi118/Makefile</filename> に
      必要なのは<emphasis>これだけ</emphasis>です:</para>

    <programlisting>RESOLUTION=     118
MASTERDIR=      ${.CURDIR}/../xdvi300

.include ${MASTERDIR}/Makefile</programlisting>

    <para>(<filename>xdvi240/Makefile</filename> や
      <filename>xdvi400/Makefile</filename> も同様のものになります).
      <filename>bsd.port.mk</filename> は,
      <makevar>MASTERDIR</makevar> の定義から
      <makevar>FILESDIR</makevar> や <makevar>SCRIPTDIR</makevar> 等の
      通常のサブディレクトリが <filename>xdvi300</filename> 以下に
      存在することを理解します.
      <literal>RESOLUTION=118</literal> の行が,
      <filename>xdvi300/Makefile</filename> の
      <literal>RESOLUTION=300</literal> の行を上書きし,
      port は解像度を 118 として作成されます.</para>
  </chapter>

  <chapter>
    <title>共有ライブラリのバージョン</title>

    <para>まず <ulink url="../handbook/policies-shlib.html">共有ライブラリの
      バージョンについての指針</ulink>を読んで, 一般的に
      共有ライブラリのバージョンをどうすれば良いかを理解してください.
      ソフトウェアの作者は自分がしていることを理解していると,
      盲目的に信じていてはいけません; 多くの場合は理解していないのです.
      細部にわたって注意深く考慮することは大変重要です.
      なぜなら我々は, 互換性がないかもしれない大量のソフトウェアを
      共存させようとする特殊な状況にあるからです.
      むかし, 不注意な port の導入が共有ライブラリに関する重大な問題を
      引き起してしまったことがあります (なぜ <filename>jpeg-6b</filename> の
      共有ライブラリのバージョン番号が 9 なのか, 今まで不思議に思ったことは
      ありませんか?).
      もし疑問があれば, &a.ports; にメールを送ってください.
      ほとんどの時間は正しい共有ライブラリのバージョンを決めることと,
      それを実現するためのパッチを作成することに終始します.</para>

<!--

    <para>しかしながら,
      同じソフトウェアの違ったバージョンのソフトウェアが既にツリーにある場合には,
      状況は非常に複雑です. < ! - - kuriyama - strange translation? - - >
      つまり FreeBSD ではユーザがリンカにどのバージョンの共有ライブラリを使用するかを指定できないからです
      (リンカは常にもっとも高いバージョンを選びます).
      これは, もし <filename>libfoo.so.3.2</filename> と
      <filename>libfoo.so.4.0</filename>
      がシステムに存在するときに, リンカに特別なアプリケーションだけ
      <filename>libfoo.so.3.2</filename>
      をリンクするよう指示する方法がないことを意味します.
      これはコンパイル時のリンクという意味では完全に見劣りします.
      この場合の唯一の解決方法は,
      共有ファイルの名前の<emphasis>ベース</emphasis>部分を変えることです.
      たとえば
      <filename>libfoo.so.4.0</filename> を
      <filename>libfoo4.so.1.0</filename> へ変えることによって,
      バージョン 3.2 とバージョン 4.0 共に他の
      port からリンクされることができるようになります.</para>

-->
    </chapter>

  <chapter id="porting-manpages">
    <title>マニュアルページ</title>

    <para><makevar>MAN[1-9LN]</makevar> 変数に指定したマニュアルは
      自動的に <filename>pkg-plist</filename> に追加されます (つまり,
      マニュアルを <filename>pkg-plist</filename> に加えては
      <emphasis>いけません</emphasis>&mdash; <link
        linkend="porting-plist">pkg-plist の生成</link>を参照してください).
      また, <filename>/etc/make.conf</filename> 中の
      <makevar>NOMANCOMPRESS</makevar> の設定に従って, インストール時に
      マニュアルを自動的に圧縮したり復元したりします.</para>

    <para>その port が, シンボリックリンクやハードリンクを用いて,
      複数のファイル名を持つマニュアルをインストールする場合には,
      それらを識別するために <makevar>MLINKS</makevar> 変数を
      使用しなければなりません.
      port によってインストールされたリンクは, 意図したファイルを
      きちんと指しているかどうか確認するため,
      <filename>bsd.port.mk</filename> によって
      削除されたり, 再作成されたりします.
      MLINKS に指定されたマニュアルも, <filename>pkg-plist</filename> に
      含めてはいけません.</para>

    <para>マニュアルをインストール時に圧縮するかどうかを
      指定するには, <makevar>MANCOMPRESSED</makevar> 変数を使用します.
      この変数は <literal>yes</literal>, <literal>no</literal> そして
      <literal>maybe</literal> の三つの値をとることができます,
      <literal>yes</literal> はマニュアルが既に圧縮されてインストール
      されていること, <literal>no</literal> は圧縮されていないこと,
      <literal>maybe</literal> は既にそのソフトウェアが
      <makevar>NOMANCOMPRESS</makevar> の値に従っていて,
      <filename>bsd.port.mk</filename> は
      特別なにもする必要がないことを意味します.</para>

    <para><makevar>USE_IMAKE</makevar> がセットされていて,
      <makevar>NO_INSTALL_MANPAGES</makevar> がセットされていなければ,
      <makevar>MANCOMPRESSED</makevar> は自動的に <literal>yes</literal> に
      設定されます.
      それ以外の場合には, <makevar>MANCOMPRESSED</makevar> は
      <literal>no</literal> に設定されます.
      その port にとって, デフォルトの設定が適切でない場合以外には,
      明示的に設定する必要はありません.</para>

    <para><makevar>PREFIX</makevar> 以外のディレクトリの下に
      マニュアルを置くような port では, そのディレクトリを
      <makevar>MANPREFIX</makevar> で指定することができます.
      さらに, いくつかの Perl モジュールの ports のように,
      特定のセクションのマニュアルだけを非標準の場所に
      インストールする場合, 個々のマニュアルのパスを
      <makevar>MAN<replaceable>sect</replaceable>PREFIX</makevar>
      (ここで <replaceable>sect</replaceable> は <literal>1-9</literal>,
      <literal>L</literal>, または <literal>N</literal> のいずれか) により
      指定することができます.</para>

    <para>マニュアルが言語特有のサブディレクトリに置かれる場合には,
      その言語名を <makevar>MANLANG</makevar> に設定してください.
      この変数のデフォルト値は <literal>""</literal> に
      なっています (つまり, 英語のみ).</para>

    <para>これは, 全部をまとめた例です.</para>

    <programlisting>MAN1=           foo.1
MAN3=           bar.3
MAN4=           baz.4
MLINKS=         foo.1 alt-name.8
MANLANG=        "" ja
MAN3PREFIX=     ${PREFIX}/share/foobar
MANCOMPRESSED=  yes</programlisting>

    <para>これは, この port により以下の 6 個のファイルが
      インストールされることを表しています.</para>

      <programlisting>${PREFIX}/man/man1/foo.1.gz
${PREFIX}/man/ja/man1/foo.1.gz
${PREFIX}/share/foobar/man/man3/bar.3.gz
${PREFIX}/share/foobar/man/ja/man3/bar.3.gz
${PREFIX}/man/man4/baz.4.gz
${PREFIX}/man/ja/man4/baz.4.gz</programlisting>

    <para>さらに
      <filename>${PREFIX}/man/man8/alt-name.8.gz</filename> が
      この port によってインストールされるかどうかわかりませんが,
      それとは無関係に foo(1) と alt-name(8) のマニュアルページを指す
      シンボリックリンクが作成されます.</para>
  </chapter>

  <chapter id="porting-motif">
    <title>Motif を必要とする port</title>

    <para>コンパイルに Motif ライブラリを必要とするアプリケーションが
      いくつかあります (Motif 自体は有料のものがいくつかの会社から
      手に入りますし, <filename>x11-toolkits/lesstif</filename> には
      多くのアプリケーションを動作させることが可能な
      無料の互換ライブラリもあります).
      Motif は広く使われているツールキットですし, 有料のもののライセンスでも
      ライブラリを静的にリンクした実行形式の再配布が認められている場合が
      多いので, Motif を必要とするソフトウェアを簡単に
      (port からコンパイルする人々のために) 動的にでも,
      (package を配布する人々のために) 静的にでも
      リンクできるような仕組みが用意されています.</para>

    <sect1>
      <title><makevar>REQUIRES_MOTIF</makevar></title>

      <para>Motif が無いとコンパイルできない port の
        <filename>Makefile</filename> では, この変数を指定してください.
        これにより, Motif を持っていない人が
        この port をコンパイルしようとするのを未然に防ぎます.</para>
    </sect1>

    <sect1>
      <title><makevar>MOTIFLIB</makevar></title>

      <para>この変数は <filename>bsd.port.mk</filename> によって
        Motif ライブラリの指定に置き換えられます.
        ソース内の Makefile や Imakefile で Motif ライブラリを指定している
        ところを, この変数に置き換えるようにパッチを適用してください.</para>

      <para>代表的な例としては以下の二つがあげられます:</para>

      <orderedlist>
        <listitem>
          <para>Makefile か Imakefile の中で Motif ライブラリが
            <option>-lXm</option> として使われている場合には,
            かわりに
            <makevar>MOTIFLIB</makevar>
            と書いてください.</para>
        </listitem>

        <listitem>
          <para>Imakefile の中で <literal>XmClientLibs</literal>
            が使われている場合には, それを
            <literal>&dollar;{MOTIFLIB} &dollar;{XTOOLLIB} &dollar;{XLIB}</literal>
            と書きかえてください.</para>
        </listitem>
      </orderedlist>

      <para>なお
        <makevar>MOTIFLIB</makevar> は通常,
        <literal>-L/usr/X11R6/lib   -lXm</literal> か
        <literal>/usr/X11R6/lib/libXm.a</literal>
        に置き換えられます.
        したがって前に <option>-L</option> や
        <option>-l</option> をつける必要はありません.</para>
    </sect1>
  </chapter>

  <chapter>
    <title>X11 のフォント</title>

    <para>もし, あなたの port が X window system
      のフォントをインストールするのであれば,
      それらを
      <filename><makevar>X11BASE</makevar>/lib/X11/fonts/local</filename>
      に置くようにしてください. このディレクトリは XFree86 release 3.3.3
      で新設されたものです.
      もしそれが存在しなければ作成し,
      ユーザに XFree86 を 3.3.3 かそれより新しいものに更新か,
      少なくともこのディレクトリを
      <filename>/etc/XF86Config</filename>
      のフォントパスに加えるように促すメッセージを出力するようにしてください.
    </para>
  </chapter>

  <chapter id="porting-info">
    <title>Info ファイル</title>

    <para>新しい版の texinfo
      (2.2.2-RELEASE およびそれ以降に入っています)
      には
      <command>install-info</command> というコマンドが含まれており,
      <filename>dir</filename>
      ファイルに項目を追加したり削除したりすることができます.
      もし, あなたの port が info 文書をインストー ルするのであれば,
      以下の指示に従ってその port および package
      が正しくユーザの
      <filename>&dollar;{PREFIX}/info/dir</filename>
      ファイルを更新するようにしてください
      (このセクションはとても長くてすいません.
      しかし info ファイルを作りあげるためにはこれらは不可欠です.
      正しく行なえば<emphasis>美しい</emphasis>リストができますので,
      辛抱してください!
      <!-- smiley --><emphasis>:-)</emphasis></para>

    <para>まず, これを知っておかなければなりません.</para>

    <screen>&prompt.user; <userinput>install-info --help</userinput>
install-info [OPTION]... [INFO-FILE [DIR-FILE]]
  Install INFO-FILE in the Info directory file DIR-FILE.
  (訳注: Info ディレクトリの INFO-FILE を DIR-FILE にインストールする)
Options:
--delete          Delete existing entries in INFO-FILE;
                    don't insert any new entries.
                  (訳注: INFO-FILE の中の項目を削除,
                   新しい項目は一切追加しない.)
 :
--entry=TEXT      Insert TEXT as an Info directory entry.
                  (訳注: TEXT を Info ディレクトリの項目として追加する.)
 :
--section=SEC     Put this file's entries in section SEC of the directory.
                  (訳注: このファイルの項目を Info ディレクトリの SEC
                   というセクションに置く.)
 :</screen>

    <note>
      <para>このプログラムは, 実際には info
        ファイルを<emphasis>インストール</emphasis>しません.
        単に
        <filename>dir</filename>
        ファイルにエントリを挿入したり削除したりするだけです.</para>
    </note>

    <para>これから, <command>install-info</command>
      を使用するように, ports を変換する 7 段階の工程を示します.
      例として
      <filename>editors/emacs</filename>
      を使用します.</para>

    <procedure>
      <step>
        <para>まず, texinfo のソースを見て,
          <literal>@dircategory</literal> と
          <literal>@direntry</literal> 文がないファイルについて,
          それらを追加するパッチを作成します. 以下は,
          ここでの例での patchの一部です:</para>

        <programlisting>--- ./man/vip.texi.org  Fri Jun 16 15:31:11 1995
+++ ./man/vip.texi      Tue May 20 01:28:33 1997
@@ -2,6 +2,10 @@

 @setfilename ../info/vip
 @settitle VIP
+@dircategory The Emacs editor and associated tools
+@direntry
+* VIP: (vip).          A VI-emulation for Emacs.
+@end direntry

 @iftex
 @finalout
 :</programlisting>

        <para>フォーマットについては見ればわかると思います.
          <filename>dir</filename>
          というファイルに必要な項目を書いておいてくれる作者も多いので,
          まず自分で書く前にさがしてみてください.
          また, 関係する ports も調べて,
          セクションの名前やインデントなどがきちんと合っているかどうかを確認してください
          (項目のテキスト は, すべて 4 つめのタブ・ストップ
          (tab stop) から始めることを推奨します).</para>

        <note>
          <para>一つファイルに対して一つの info
            の項目しか書けないことに注意してください.
            これは
            <command>install-info --delete</command>
            <!-- kuriyama - not email --> のバグにより
            <email>@direntry</email>
            セクションに複数の項目を書いても初めの一つの項目しか削除してくれないからです.</para>
        </note>

        <para>texinfo のソースにパッチを適用する代わりに
          <literal>dir</literal> の項目を
          <command>install-info</command> の引数
          (<option>--section</option>, <option>--entry</option>)
          として与えることもできますが, あまり良い方法とは言えません.
          なぜなら同じ情報を三つの場所
          (<filename>Makefile</filename>,
          <filename>pkg-plist</filename> の
          <literal>@exec</literal>/<literal>@unexec</literal>:
          以下参照)
          に重複して書く必要があるからです.
          しかし, もし日本語
          (あるいは, 他のマルチバイト文字)の info
          ファイルがある場合には
          <command>install-info</command>
          の特別な引数を使用する必要があるでしょう.
          なぜなら <command>makeinfo</command> がこのような
          texinfo ソースファイルを扱えないからです.
          (このようなものをどう扱うかの例としては
          <filename>japanese/skk</filename> の
          <filename>Makefile</filename> と
          <filename>pkg-plist</filename> を見てください).</para>
      </step>

      <step>
        <para>portのディレクトリに戻って
          <command>make clean; make</command> を実行し,
          info ファイルが texinfo ソースファイルから再び生成されることを確認してください.
          texinfo ソースファイルのほうが info ファイルよりも新しいので
          <command>make</command> と入力すれば
          info ファイルは再構築されるはずですが, 多くの
          <filename>Makefile</filename>
          には info ファイルの正しい依存関係が書かれていません.
          <command>emacs</command> の場合, info ファイルの再構築の際には
          <filename>man</filename> サブディレクトリに降りるように
          メインの <filename>Makefile.in</filename> に
          パッチを適用する必要がありました.</para>

        <programlisting>--- ./Makefile.in.org   Mon Aug 19 21:12:19 1996
+++ ./Makefile.in       Tue Apr 15 00:15:28 1997
@@ -184,7 +184,7 @@
 # Subdirectories to make recursively.  `lisp' is not included
 # because the compiled lisp files are part of the distribution
 # and you cannot remake them without installing Emacs first.
-SUBDIR = lib-src src
+SUBDIR = lib-src src man

 # The makefiles of the directories in $SUBDIR.
 SUBDIR_MAKEFILES = lib-src/Makefile man/Makefile src/Makefile oldXMenu/Makefile lwlib/Makefile
--- ./man/Makefile.in.org       Thu Jun 27 15:27:19 1996
+++ ./man/Makefile.in   Tue Apr 15 00:29:52 1997
@@ -66,6 +66,7 @@
        ${srcdir}/gnu1.texi \
        ${srcdir}/glossary.texi

+all: info
 info: $(INFO_TARGETS)

 dvi: $(DVI_TARGETS)</programlisting>

        <para><filename>man</filename>
          メインの <filename>Makefile</filename> からは,
          <maketarget>all</maketarget> として呼びたいのですが,
          サブディレクトリでのデフォルトターゲットは
          <maketarget>info</maketarget> になっています.
          このため, 二つ目のパッチが必要になります.
          また, <filename>info</filename> info ファイルのインストールも削除しました.
          なぜなら, それは同じ名前ですでに
          <filename>/usr/share/info</filename>
          にあるからです
          (そのパッチはここでは示しません).</para>
      </step>

      <step>
        <para>もし, <filename>Makefile</filename> に
          <filename>dir</filename>
          ファイルをインストールする個所があれば削除します.
          あなたの port がインストールしてはいけません.
          また, <filename>dir</filename>
          ファイルを壊してしまうようなコマンドの類も削除します.</para>

        <programlisting>--- ./Makefile.in.org   Mon Aug 19 21:12:19 1996
+++ ./Makefile.in       Mon Apr 14 23:38:07 1997
@@ -368,14 +368,8 @@
        if [ `(cd ${srcdir}/info &amp;&amp; /bin/pwd)` != `(cd ${infodir} &amp;&amp; /bin/pwd)` ]; \
        then \
          (cd ${infodir};  \
-          if [ -f dir ]; then \
-            if [ ! -f dir.old ]; then mv -f dir dir.old; \
-            else mv -f dir dir.bak; fi; \
-          fi; \
           cd ${srcdir}/info ; \
-          (cd $${thisdir}; ${INSTALL_DATA} ${srcdir}/info/dir ${infodir}/dir); \
-          (cd $${thisdir}; chmod a+r ${infodir}/dir); \
           for f in ccmode* cl* dired-x* ediff* emacs* forms* gnus* info* message* mh-e* sc* vip*; do \
             (cd $${thisdir}; \
              ${INSTALL_DATA} ${srcdir}/info/$$f ${infodir}/$$f; \
              chmod a+r ${infodir}/$$f); \</programlisting>
      </step>

      <step>
        <para>(これは, 既存のportを修正するときのみ必要です.)
          <filename>pkg-plist</filename> を見て,
          <filename>info/dir</filename>
          にパッチをあてようとするものすべてを削除します.
          これらは
          <filename>pkg-install</filename>
          やその他のファイルにもあるかもしれないので,
          いろいろさがしてみてください.</para>

        <programlisting>Index: pkg-plist
===================================================================
RCS file: /usr/cvs/ports/editors/emacs/pkg/pkg-plist,v
retrieving revision 1.15
diff -u -r1.15 pkg-plist
--- pkg-plist   1997/03/04 08:04:00     1.15
+++ pkg-plist   1997/04/15 06:32:12
@@ -15,9 +15,6 @@
 man/man1/emacs.1.gz
 man/man1/etags.1.gz
 man/man1/ctags.1.gz
-@unexec cp %D/info/dir %D/info/dir.bak
-info/dir
-@unexec cp %D/info/dir.bak %D/info/dir
 info/cl
 info/cl-1
 info/cl-2</programlisting>
      </step>

      <step>
        <para><maketarget>post-install</maketarget> ターゲットを
          <filename>Makefile</filename>
          に加えてインストールされた info ファイルについては,
          <maketarget>install-info</maketarget>
          を実行するようします
          (<filename>dir</filename>
          ファイルが存在しない場合にそれを作成するようにする必要はなくなりました.
          <command>install-info</command>
          はこのファイルが存在しなければ自動的に作成します).
        </para>

        <programlisting>Index: Makefile
===================================================================
RCS file: /usr/cvs/ports/editors/emacs/Makefile,v
retrieving revision 1.26
diff -u -r1.26 Makefile
--- Makefile    1996/11/19 13:14:40     1.26
+++ Makefile    1997/05/20 10:25:09     1.28
@@ -20,5 +20,11 @@
 post-install:
 .for file in emacs-19.34 emacsclient etags ctags b2m
        strip ${PREFIX}/bin/${file}
 .endfor
+.for info in emacs vip viper forms gnus mh-e cl sc dired-x ediff ccmode
+       install-info ${PREFIX}/info/${info} ${PREFIX}/info/dir
+.endfor

 .include &lt;bsd.port.mk&gt;</programlisting>
      </step>

      <step>
        <para><filename>pkg-plist</filename> を編集して, 同じ働きをする
          <literal>@exec</literal> 文,
          それに <command>pkg_delete</command> のために
          <literal>@unexec</literal> 文を加えてください.</para>

        <programlisting>Index: pkg-plist
===================================================================
RCS file: /usr/cvs/ports/editors/emacs/pkg-plist,v
retrieving revision 1.15
diff -u -r1.15 pkg-plist
--- pkg-plist   1997/03/04 08:04:00     1.15
+++ pkg-plist   1997/05/20 10:25:12     1.17
@@ -16,7 +14,14 @@
 man/man1/etags.1.gz
 man/man1/ctags.1.gz
+@unexec install-info --delete %D/info/emacs %D/info/dir
 :
+@unexec install-info --delete %D/info/ccmode %D/info/dir
 info/cl
 info/cl-1
@@ -87,6 +94,18 @@
 info/viper-3
 info/viper-4
+@exec install-info %D/info/emacs %D/info/dir
 :
+@exec install-info %D/info/ccmode %D/info/dir
 libexec/emacs/19.34/i386--freebsd/cvtmail
 libexec/emacs/19.34/i386--freebsd/digest-doc</programlisting>

        <note>
          <para><literal>@unexec install-info --delete</literal>
            コマンドは info ファイル自身より先に置き,
            コマンドがファイルを読めるようにしておかなければならないことに注意してください.
            また
            <literal>@exec install-info</literal> コマンドは,
            info ファイルおよび <filename>dir</filename>
            ファイルを作る
            <literal>@exec</literal>
            コマンドより後におかなければなりません.</para>
        </note>
      </step>

      <step>
        <para><link linkend="porting-testing">テスト</link>
          をして出来栄えに感服しましょう
          <!-- smiley --><emphasis>:)</emphasis>
          各段階の前後に
          <filename>dir</filename>
          ファイルをチェックしましょう.</para>
      </step>
    </procedure>
  </chapter>

  <chapter>
    <title><filename>pkg-<replaceable>*</replaceable></filename> ファイル</title>

    <para><filename>pkg-<replaceable>*</replaceable></filename> ファイルには,
      まだ取り上げていない何かと重宝なトリックがいくつかあります.</para>

    <sect1 id="porting-message">
      <title><filename>pkg-message</filename></title>

      <para>もしインストールする人にメッセージを表示する必要がある場合には,
        そのメッセージを
        <filename>pkg-message</filename> に置くことができます.
        この機能は
        <command>pkg_add</command>
        の後の追加のインストール手続きを表示するときなどに重宝します.</para>

      <note>
        <para>
          <filename>pkg-message</filename> ファイルは
          <filename>pkg-plist</filename> に加える必要はありません.
          また, もしユーザが package ではなく
          port を使用している場合には自動的には表示されませんので,
          明示的に
          <maketarget>post-install</maketarget>
          で表示するようにするべきでしょう.</para>
      </note>
    </sect1>

    <sect1>
      <title><filename>pkg-install</filename></title>

      <para>バイナリパッケージが
        <command>pkg_add</command>
        でインストールされるときに実行する必要のあるコマンドがあれば,
        <filename>pkg-install</filename>
        スクリプトを使って実行することができます.
        このスクリプトは自動的に package に加えられ,
        <command>pkg_add</command> によって 2 回実行されます.
        1 回目は
        <literal>&dollar;{SH} pkg-install &dollar;{PKGNAME} PRE-INSTALL</literal>
        として, 2 回目には
        <literal>&dollar;{SH} pkg-install &dollar;{PKGNAME} POST-INSTALL</literal>
        として実行されます.
        どちらのモードで実行されているかは
        <literal>&dollar;2</literal> を調べることによってわかります.
        環境変数 <envar>PKG_PREFIX</envar> には
        package がインストールされるディレクトリが設定されます.
        詳細は &man.pkg.add.1; を見てください.</para>

      <note>
        <para>
          port を <command>make install</command>
          でインストールするときにはこのスクリプトは自動的に実行されません.
          もし実行される必要があるならば port の Makefile
          から明示的に呼ぶ必要があります.
        </para>
      </note>
    </sect1>

    <sect1>
      <title><filename>pkg-req</filename></title>

      <para>(訳注: 実行されるマシンの状態に応じて) その port を
        インストールするべきか, そうでないかを判断する必要があるときには,
        <quote>要件 (requirements)</quote> スクリプト
        <filename>pkg-req</filename> を作ることができます.
        インストールや削除を実行すべきかどうか判断するために,
        このスクリプトがインストールや削除を実行する際に自動的に
        実行されます.</para>

      <para>このスクリプトはインストール時には <command>pkg_add</command> により
        <literal>pkg-req &dollar;{PKGNAME} INSTALL</literal> として実行され,
        削除時には <command>pkg_delete</command> により
        <literal>pkg-req &dollar;{PKGNAME} DEINSTALL</literal> として
        実行されます.</para>
    </sect1>

    <sect1 id="porting-plist">
      <title>make の変数にあわせた
        <filename>pkg-plist</filename> の変更</title>

      <para>いくつかの port, 特に p5-ports などは
        configure のオプション
        (あるいは, p5-ports の場合は perl のバージョン)
        によって
        <filename>pkg-plist</filename> を変える必要があります.
        これを容易に実現するために
        <filename>pkg-plist</filename> 中の
        <literal>%%OSREL%%</literal>,
        <literal>%%PERL_VER%%</literal>,
        <literal>%%PERL_VERSION%%</literal> は適切に置き換えられるようになっています.
        <literal>%%OSREL%%</literal> の値はオペレーティングシステムの数字で表されたリビジョンです
        (たとえば <literal>2.2.7</literal>).
        <literal>%%PERL_VERSION%%</literal> は perl
        のバージョン番号全体
        (たとえば <literal>5.00502</literal>)
        で, <literal>%%PERL_VER%%</literal>
        はバージョン番号からパッチレベルを引いたものです
        (たとえば <literal>5.005</literal>).</para>

      <para>他の置き換えが必要であれば, <makevar>PLIST_SUB</makevar>
        変数に
        <literal><replaceable>VAR</replaceable>=<replaceable>VALUE</replaceable></literal>
        という形式のペアのリストを設定することによって,
        <filename>pkg-plist</filename> 中の
        <literal>%%<replaceable>VAR</replaceable>%%</literal>
        は
        <replaceable>VALUE</replaceable> に置き換えられます.
        たとえばバージョンに固有のたくさんのファイルをインストールする場合には,
        <filename>Makefile</filename> に</para>
      <!-- kuriyama - Eng ver has unneeded quote above -->

      <programlisting>OCTAVE_VERSION= 2.0.13
PLIST_SUB=      OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>

      <para>と書いて, <filename>PLIST</filename>
        中のバージョン番号が表われるすべてのところに,
        <literal>%%OCTAVE_VERSION%%</literal> と書きます.
        このようにしておけば, port をアップグレードするときに,
        何十行 (時として, 何百行) も
        <filename>pkg-plist</filename>
        を書き替えないですみます.</para>

      <para>この書き換えは
        (<link linkend="porting-manpages">マニュアル</link>の追加も)
        <maketarget>do-install</maketarget> と
        <maketarget>post-install</maketarget> ターゲットの間に
        <makevar>pkg-plist</makevar> を読み
        <makevar>TMPPLIST</makevar>
        (デフォルトは <filename><makevar>WRKDIR</makevar>/.PLIST.mktmp</filename>)
        に書き込むことによって行なわれます.
        もし, あなたの port が
        <makevar>PLIST</makevar> を実行時に生成するのであれば,
        <maketarget>do-install</maketarget>
        の間かその前に行なうようにしてください.
        また, 書きかえられたあとのファイルを編集する必要がある場合には,
        <maketarget>post-install</maketarget>
        で <makevar>TMPPLIST</makevar> を書きかえてください.</para>
    </sect1>

    <sect1>
      <title id="porting-pkgfiles"><filename>pkg-<replaceable>*</replaceable></filename>ファイルの名前変更</title>

      <para><filename>pkg-<replaceable>*</replaceable></filename>ファイルの
        名前はすべて変数を使用して定義されていますので,
        必要であれば
        <filename>Makefile</filename> 中で変更可能です.
        いくつかの ports で一つの
        <filename>pkg-<replaceable>*</replaceable></filename>
        ファイルを共有する場合や,
        上記のファイルに書き込みをしなければならないときなど特に便利です
        (<filename>pkg-<replaceable>*</replaceable></filename>
        サブディレクトリに直接書き込むのが良くない理由については
        <link linkend="porting-wrkdir">WRKDIR
          以外への書きこみ</link> を参照してください).</para>

      <para>以下に変数名と そのデフォルト値のリストを示します.
        (<makevar>PKGDIR</makevar> のデフォルト値は
        <makevar>${MASTERDIR}</makevar> になっています.)</para>

      <informaltable frame="none">
        <tgroup cols="2">
          <thead>
            <row>
              <entry>変数名</entry>
              <entry>デフォルト値</entry>
            </row>
          </thead>

          <tbody>
            <row>
              <entry><makevar>COMMENT</makevar></entry>
              <entry><literal>${PKGDIR}/pkg-comment</literal></entry>
            </row>

            <row>
              <entry><makevar>DESCR</makevar></entry>
              <entry><literal>${PKGDIR}/pkg-descr</literal></entry>
            </row>

            <row>
              <entry><makevar>PLIST</makevar></entry>
              <entry><literal>${PKGDIR}/pkg-plist</literal></entry>
            </row>

            <row>
              <entry><makevar>PKGINSTALL</makevar></entry>
              <entry><literal>${PKGDIR}/pkg-install</literal></entry>
            </row>

            <row>
              <entry><makevar>PKGDEINSTALL</makevar></entry>
              <entry><literal>${PKGDIR}/pkg-deinstall</literal></entry>
            </row>

            <row>
              <entry><makevar>PKGREQ</makevar></entry>
              <entry><literal>${PKGDIR}/pkg-req</literal></entry>
            </row>

            <row>
              <entry><makevar>PKGMESSAGE</makevar></entry>
              <entry><literal>${PKGDIR}/pkg-message</literal></entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>

      <para><makevar>PKG_ARGS</makevar>
        を上書きせずにこれらの変数を変更するようにしてください.
        <makevar>PKG_ARGS</makevar>
        を変更すると, これらのファイルは port から正しく
        <filename>/var/db/pkg</filename>
        にインストールされなくなります.</para>
    </sect1>
  </chapter>

  <chapter>
    <title>ライセンス上の問題</title>

    <para>ソフトウェアによっては, 制約の厳しいライセンス条件が
      定められている場合もありますし,
      国によっては (特許権の侵害などで) 法律的に問題がある可能性もあります.
      それらをどう扱えばいいかは, それぞれのライセンスの文面によって
      大きく異なります.</para>

    <note>
      <para>ソフトウェア移植者として,
        あなたにはライセンスをよく読み
        FreeBSD プロジェクトが FTP または CD-ROM
        で配布してはいけないソフトウェアを配布してしまうことのないよう注意する義務があります.
        何か疑問がある場合には
        &a.ports; に聞いてみてください.</para>
    </note>

    <para>よく見られるケースに対処するために,
      <filename>Makefile</filename> に指定できる二つの変数が用意されています.</para>

    <orderedlist>
      <listitem>
        <para>ソフトウェアに<quote>有償再配布を禁ずる</quote>という趣旨のライセン スがついてきた場合には,
          <makevar>NO_CDROM</makevar>
          という変数にその理由を記述してください.
          わたしたちはこれがついている port を
          CDROM リリースに入れないようにしますが,
          オリジナルのソースファイルと package を
          FTP で取れるようにしておきます.</para>
      </listitem>

      <listitem>
        <para>もし生成される package が個々のサイトで独自に構築される必要があったり,
          ライセンスによって生成されるバイナリが配布できない場合には
          <makevar>NO_PACKAGE</makevar> 変数にその理由を記述してください.
          そのような package は FTP サイトに置かれたり,
          リリース 時の CDROM へ入らないようにします.
          ただし, いずれの場合も
          配布ファイルは (FTP や CD-ROM に)
          含まれるようになります.</para>
      </listitem>

      <listitem>
        <para>(特許などの関係で) 使用者によっては法律上の問題が生じたり,
          <quote>商用利用を禁ずる</quote>ライセンスを持つ port の場合には,
          その理由を <makevar>RESTRICTED</makevar> という変数に入れてください.
          このような port の場合には, 配布ファイルや package も
          FreeBSD の FTP サイトに置かれないようになります.</para>
      </listitem>
    </orderedlist>

    <note>
      <para>GNU 一般公有使用許諾書 (GPL) は,
        バージョン 1, 2 とも port 作成上何ら問題にはなりません.</para>
    </note>

    <note>
      <para>もしあなたがソースツリー管理者 (committer) であれば,
        ソースツリーにこのような port を入れる際に
        <filename>ports/LEGAL</filename>
        ファイルを書き換えるのを忘れないようにしてください.</para>
    </note>
  </chapter>

  <chapter id="port-upgrading">
    <title>アップグレード</title>

    <para>port のバージョンが原作者からのものに比べて古いことに気がついたら,
      まずはあなたの持っている port が私たちの最新のもの
      (FTP ミラーサイトの <filename>ports/ports-current</filename>
      というディレクトリにあります)
      であることを確認してください.
      また, Ports Collection 全体を最新の状態に保つために
      CVSup を利用することもできます.
      詳しくは
      <ulink url="../handbook/synching.html#CVSUP-CONFIG">FreeBSD
        ハンドブック</ulink>をご覧ください.</para>

    <para>次に port の
      <filename>Makefile</filename> に
      <makevar>MAINTAINER</makevar> (保守担当者)
      のアドレスが書いてある場合には, その人にメールを出してみましょう.
      保守担当者の人がすでにアップグレードの準備をしているかも知れませんし,
      (新しいバージョンの安定度に問題があるなど)
      あえてアップグレードをしない理由があるのかも知れません.</para>

    <para>保守担当者にアップグレードをしてくれと頼まれた場合,
      あるいは, そもそも port の Makefile に保守担当者が書いてない場合などは,
      あなたがアップグレードをしてくださると助かります.
      その場合にはアッ プグレードをした後,
      変更前と変更後のディレクトリの再帰的 diff
      (unified diff と context diff のどちらでもいいのですが,
      port のコミッター達は unified diff の方を好むようです)
      をとって送ってください
      (たとえば変更前のディレクトリが
      <filename>superedit.bak</filename>
      という名前でとってあり, 変更後のものが
      <filename>superedit</filename>
      に入っているなら,
      <command>diff -ruN superedit.bak superedit</command>
      の結果を送ってください).
      diff の出力を見て,
      すべての変更が正しくなされているか確認してください.
      変更箇所については, &man.send-pr.1;
      (カテゴリは <literal>ports</literal>)
      に diff の出力結果を添えて, わたしたちに送ってもらうのが一番良いです.
      commit する際に CVS に明確に記述しなければならないので,
      付け加えたり削除したりしたファイルがあればそれについて書いておいてください.
      もし diff の大きさが 20 KB 程度を超えるようであれば,
      圧縮したものを uuencode してください.
      そうでなければそのまま PR に入れるだけで構いません.</para>

    <note>
      <para>繰り返しになりますが, 既存の ports の変更を送るときには
          &man.shar.1; ではなく &man.diff.1; を使用してください!</para>
    </note>
  </chapter>

  <chapter id="porting-dads">
    <title>やっていいことといけないこと</title>
    <!-- kuriyama - why Eng ver has anchor tag? -->

    <para>このセクションではソフトウェアを port する上で,
      良くある落し穴などについて説明します.
      このリストを使ってあなた自身が作成した port のチェックはもとより,
      PR データベースにある,
      他の人が作成した port のチェックもできます.
      あなたがチェックした port
      についてのコメントを<ulink url="../handbook/contrib-how.html#CONTRIB-GENERAL">バグ報告と一般的な論評</ulink>にしたがって送ってください.
      PR データベースにある port をチェックすると,
      わたしたちがそれらを commit するのを早くし,
      あなたが何をしているか理解していることも示します.</para>
    <!-- 2000/07/16:hrs strange translation -->

    <sect1>
      <title>バイナリの strip</title>

      <para>バイナリは strip してください.
        オリジナルのソースがバイナリを
        strip してくれる場合は良いですが,
        そうでない場合には port の
        <filename>Makefile</filename> が
        <literal>install</literal> ターゲットを持っているなら
        <makevar>BSD_INSTALL_PROGRAM</makevar> を,
        持っていないなら
        strip するための <literal>post-install</literal> ルールを追加して
        strip するようにするとよいでしょう.
        たとえばこんな風になります:</para>

      <programlisting>post-install:
        strip ${PREFIX}/bin/xdl</programlisting>

      <para>インストールされた実行形式がすでに strip
        されているかどうかは <command>file</command>
        コマンドで確認できます.
        <quote>not stripped</quote>
        と表示されなければ strip されていることを示しています.</para>
    </sect1>

    <sect1>
      <title><makevar>INSTALL_*</makevar> マクロ</title>

      <para>あなた自身の <maketarget>*-install</maketarget>
        ターゲットでファイルの正しいモードとオーナを保証するために,
        必ず
        <filename>bsd.port.mk</filename>
        で提供されているマクロを使用してください.</para>

      <itemizedlist>
        <listitem>
          <para><makevar>${INSTALL_PROGRAM}</makevar>
            は実行可能なバイナリをインストール
            (し, その過程で strip 処理)するコマンドです.</para>
        </listitem>

        <listitem>
          <para><makevar>${INSTALL_SCRIPT}</makevar>
            は実行可能なスクリプトをインストールするコマンドです.</para>
        </listitem>

        <listitem>
          <para><makevar>${INSTALL_DATA}</makevar>
            は共有可能なデータをインストールするコマンドです.</para>
        </listitem>

        <listitem>
          <para><makevar>${INSTALL_MAN}</makevar>
            はマニュアルとその他の文書をインストールするコマンドです
            (圧縮はしません).</para>
        </listitem>
      </itemizedlist>

      <para>これらは基本的に <command>install</command>
        コマンドに適切なフラグを与えたものです.
        それらは distfile の <filename>Makefile</filename>
        で, 頭に <quote>BSD_</quote> が付けられた
        (つまり BSD_INSTALL_PROGRM というような)
        形で使うことができます.
        どのようにこれらを使用するかは以下の例を見てください.
      </para>
    </sect1>

    <sect1 id="porting-wrkdir">
      <title><makevar>WRKDIR</makevar></title>

      <para><makevar>WRKDIR</makevar> の外に存在するファイルには
        何も書き込んではいけません.
        port のビルド中に書き込み可能なことが保証されているのは
        <makevar>WRKDIR</makevar> の中だけです (書き込み不可のツリー上での
        port ビルドの例については,
        <ulink url="../handbook/ports-using.html#PORTS-CD">CDROM からの
        ports のコンパイル</ulink> を参照のこと).
        <filename>pkg-<replaceable>*</replaceable></filename> ファイルを
        変更する必要があるときには, ファイルを上書きするのではなく
        <link linkend="porting-pkgfiles">変数の再定義</link>により
        行なうようにしてください.</para>
    </sect1>

    <sect1 id="porting-wrkdirprefix">
      <title><makevar>WRKDIRPREFIX</makevar></title>

      <para><makevar>WRKDIRPREFIX</makevar>
        を尊重していることを確認してください.
        特に, 別の port の
        <makevar>WRKDIR</makevar> を参照しているときには気を付けてください.
        正しい場所は,
        <filename><makevar>WRKDIRPREFIX</makevar><makevar>PORTSDIR</makevar>/<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename>
        です,
        <filename><makevar>PORTSDIR</makevar>/<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename>
        や
        <filename><makevar>.CURDIR</makevar>/../../<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename>
        ではありません.</para>

      <para>また,
        自分で <makevar>WRKDIR</makevar> 定義するときには先頭に
        <literal>&dollar;{WRKDIRPREFIX}&dollar;{.CURDIR}</literal>
        が付いていることを確認してください.</para>
    </sect1>

    <sect1 id="porting-versions">
      <title>OS の種類やバージョンの識別</title>

      <para>どのバージョンの Unix で動かすかによって, 変更や
        条件つきコンパイルが必要なコードに出くわすこともあるでしょう.
        そのような変更を行なう場合には,
        FreeBSD 1.x システムへのバックポートや,
        CSRG の 4.4BSD, BSD/386, 386BSD, NetBSD, OpenBSD 等,
        他の BSD システムへの移植が可能なように,
        できるだけ汎用的な変更を行なうことを心がけてください.</para>

      <para>4.3BSD/Reno (1990) と, それより新しいバージョンの BSD コードを
        区別するには, <filename>&lt;sys/param.h&gt;</filename> で定義されている
        <literal>BSD</literal> マクロを利用するのがよいでしょう.
        このファイルがすでにインクルードされていれば良いのですが,
        そうでない場合には, その <filename>.c</filename> ファイルの
        適当な場所に以下のコードを追加してください.</para>

      <programlisting>#if (defined(__unix__) || defined(unix)) &amp;&amp; !defined(USG)
#include &lt;sys/param.h&gt;
#endif</programlisting>

      <para>これらの二つのシンボルが定義されているシステムには必ず
        <filename>sys/param.h</filename> があるはずです.
        もしそうでないシステムを発見したら,
        &a.ports; までメールを送ってわたしたちに伝えてください.</para>

      <para>あるいは, GNU Autoconf のスタイルを使用することもできます,</para>

      <programlisting>#ifdef HAVE_SYS_PARAM_H
#include &lt;sys/param.h&gt;
#endif</programlisting>

      <para>この方法を使用するときには,
        <filename>Makefile</filename> 中の
        <makevar>CFLAGS</makevar>に
        <literal>-DHAVE_SYS_PARAM_H</literal>
        を加えることを忘れないようにしてください.</para>

      <para>いったん <filename>sys/param.h</filename>
        がインクルードされると,</para>

      <programlisting>#if (defined(BSD) &amp;&amp; (BSD &gt;= 199103))</programlisting>

      <para>このようにしてそのコードが 4.3 Net2 コードベース,
        またはそれより新しいもの
        (例: FreeBSD 1.x, 4.3/Reno, NetBSD 0.9, 386BSD, BSD/386 1.1 とそれ以前)
        の上でコンパイルされているかを検出できます.</para>

      <programlisting>#if (defined(BSD) &amp;&amp; (BSD &gt;= 199306))</programlisting>

      <para>これは, 4.4コードベース, またはそれより新しいもの
        (例: FreeBSD 2.x, 4.4, NetBSD 1.0, BSD/386 2.0 とそれ以後)
        の上でコンパイルされているかどうかを検出するために使用します.</para>

      <para>4.4BSD-Lite2 コードベースでは
        <literal>BSD</literal> マクロの値は
        <literal>199506</literal> になっています.
        これは参考程度の意味合いしかありません.
        4.4-Lite ベースの FreeBSD と 4.4-Lite2
        での変更がマージされたバージョンとを区別するのに使用するべきものではありません.
        この目的のためにはかわりに
        <literal>__FreeBSD__</literal>
        マクロを使用してください.</para>

      <para>以下は控え目に使ってください.</para>

      <itemizedlist>
        <listitem>
          <para><literal>__FreeBSD__</literal>
            はFreeBSDのすべての版で定義されています.
            変更が FreeBSD だけに適用されるとき以外は使用しないでください.
            port でよくある
            <function>strerror()</function> ではなく
            <literal>sys_errlist[]</literal> を使うなどは
            FreeBSDでの変更ではなく BSD の流儀です.</para>
        </listitem>

        <listitem>
          <para>FreeBSD 2.xでは <literal>__FreeBSD__</literal> が
            <literal>2</literal> と定義されています.
            それ以前の版では <literal>1</literal> になっています.
            その後の版ではそのメジャー番号に合うように上がっていきます.</para>
        </listitem>

        <listitem>
          <para>もし
            FreeBSD 1.x システムと FreeBSD 2.x,
            あるいは FreeBSD 3.x システムを区別する必要があれば,
            上で述べた <literal>BSD</literal>
            マクロを使用するのが大抵の場合において正しい答です.
            もし FreeBSD 特有の変更であれば
            (<command>ld</command> を使うときの共有ライブラリ用のオプションなど),
            <!-- kuriyama - strange translation -->
            <literal>__FreeBSD__</literal>を使い
            <literal>#if __FreeBSD__ &gt; 1</literal>
            のようにFreeBSD 2.x および,
            それ以降のシステムを検出するのはかまいません.
            もし 2.0-RELEASE 以降の FreeBSD システムを細かく検出したければ,
            以下を使用することができます.</para>

          <programlisting>#if __FreeBSD__ &gt;= 2
#include &lt;osreldate.h&gt;
#    if __FreeBSD_version &gt;= 199504
         /* 2.0.5+ release specific code here */
#    endif
#endif</programlisting>

          <informaltable frame="none">
            <tgroup cols="2">
              <thead>
                <row>
                  <entry>Release</entry>
                  <entry><literal>__FreeBSD_version</literal></entry>
                </row>
              </thead>

              <tbody>
                <row>
                  <entry>2.0-RELEASE</entry>
                  <entry>119411</entry>
                </row>

                <row>
                  <entry>2.1-CURRENT</entry>
                  <entry>199501, 199503</entry>
                </row>

                <row>
                  <entry>2.0.5-RELEASE</entry>
                  <entry>199504</entry>
                </row>

                <row>
                  <entry>2.1 以前の 2.2-CURRENT</entry>
                  <entry>199508</entry>
                </row>

                <row>
                  <entry>2.1.0-RELEASE</entry>
                  <entry>199511</entry>
                </row>

                <row>
                  <entry>2.1.5 以前の 2.2-CURRENT</entry>
                  <entry>199512</entry>
                </row>

                <row>
                  <entry>2.1.5-RELEASE</entry>
                  <entry>199607</entry>
                </row>

                <row>
                  <entry>2.1.6 以前の 2.2-CURRENT</entry>
                  <entry>199608</entry>
                </row>

                <row>
                  <entry>2.1.6-RELEASE</entry>
                  <entry>199612</entry>
                </row>

                <row>
                  <entry>2.1.7-RELEASE</entry>
                  <entry>199612</entry>
                </row>

                <row>
                  <entry>2.2-RELEASE</entry>
                  <entry>220000</entry>
                </row>

                <row>
                  <entry>2.2.1-RELEASE</entry>
                  <entry>220000 (変更なし)</entry>
                </row>

                <row>
                  <entry>2.2.1-RELEASE 以降の 2.2-STABLE</entry>
                  <entry>220000 (変更なし)</entry>
                </row>

                <row>
                  <entry>texinfo-3.9 以降の 2.2-STABLE</entry>
                  <entry>221001</entry>
                </row>

                <row>
                  <entry>top 導入以降の 2.2-STABLE</entry>
                  <entry>221002</entry>
                </row>

                <row>
                  <entry>2.2.2-RELEASE</entry>
                  <entry>222000</entry>
                </row>

                <row>
                  <entry>2.2.2-RELEASE 以降の 2.2-STABLE</entry>
                  <entry>222001</entry>
                </row>

                <row>
                  <entry>2.2.5-RELEASE</entry>
                  <entry>225000</entry>
                </row>

                <row>
                  <entry>2.2.5-RELEASE 以降の 2.2-STABLE</entry>
                  <entry>225001</entry>
                </row>

                <row>
                  <entry>ldconfig -R マージ以降の 2.2-STABLE</entry>
                  <entry>225002</entry>
                </row>

                <row>
                  <entry>2.2.6-RELEASE</entry>
                  <entry>226000</entry>
                </row>

                <row>
                  <entry>2.2.7-RELEASE</entry>
                  <entry>227000</entry>
                </row>

                <row>
                  <entry>2.2.7-RELEASE 以降の 2.2-STABLE</entry>
                  <entry>227001</entry>
                </row>

                <row>
                  <entry>&man.semctl.2; 変更以降の 2.2-STABLE</entry>
                  <entry>227002</entry>
                </row>

                <row>
                  <entry>2.2.8-RELEASE</entry>
                  <entry>228000</entry>
                </row>

                <row>
                  <entry>2.2.8-RELEASE 以降の 2.2-STABLE</entry>
                  <entry>228001</entry>
                </row>

                <row>
                  <entry>&man.mount.2; 変更以前の 3.0-CURRENT</entry>
                  <entry>300000</entry>
                </row>

                <row>
                  <entry>&man.mount.2; 変更以降の 3.0-CURRENT</entry>
                  <entry>300001</entry>
                </row>

                <row>
                  <entry>&man.semctl.2; 変更以降の 3.0-CURRENT</entry>
                  <entry>300002</entry>
                </row>

                <row>
                  <entry>ioctl 引数変更以降の 3.0-CURRENT</entry>
                  <entry>300003</entry>
                </row>

                <row>
                  <entry>ELF 化以降の 3.0-CURRENT</entry>
                  <entry>300004</entry>
                </row>

                <row>
                  <entry>3.0-RELEASE</entry>
                  <entry>300005</entry>
                </row>

                <row>
                  <entry>3.0-RELEASE 以降の 3.0-CURRENT</entry>
                  <entry>300006</entry>
                </row>

                <row>
                  <entry>3/4 の分岐以降の 3.0-STABLE</entry>
                  <entry>300007</entry>
                </row>

                <row>
                  <entry>3.1-RELEASE</entry>
                  <entry>310000</entry>
                </row>

                <row>
                  <entry>3.1-RELEASE 以降の 3.1-STABLE</entry>
                  <entry>310001</entry>
                </row>

                <row>
                  <entry>C++ コンストラクタ/デストラクタ順序変更の後の
                    3.1-STABLE</entry>
                  <entry>310002</entry>
                </row>

                <row>
                  <entry>3.2-RELEASE</entry>
                  <entry>320000</entry>
                </row>

                <row>
                  <entry>3.2-STABLE</entry>
                  <entry>320001</entry>
                </row>

                <row>
                  <entry>バイナリ互換性のない IPFW とソケットの変更後の
                    3.2-STABLE</entry>
                  <entry>320002</entry>
                </row>

                <row>
                  <entry>3.3-RELEASE</entry>
                  <entry>330000</entry>
                </row>

                <row>
                  <entry>3.3-STABLE</entry>
                  <entry>330001</entry>
                </row>

                <row>
                  <entry>libc に &man.mkstemp.3; が追加された後の 3.3-STABLE</entry>
                  <entry>330002</entry>
                </row>

                <row>
                  <entry>3.4-RELEASE</entry>
                  <entry>340000</entry>
                </row>

                <row>
                  <entry>3.4-STABLE</entry>
                  <entry>340001</entry>
                </row>

                <row>
                  <entry>3.4 が分岐した後の 4.0-CURRENT</entry>
                  <entry>400000</entry>
                </row>

                <row>
                  <entry>dynamic linker の変更後の 4.0-CURRENT</entry>
                  <entry>400001</entry>
                </row>

                <row>
                  <entry>C++ コンストラクタ/デストラクタ順序変更の後の
                    4.0-CURRENT</entry>
                  <entry>400002</entry>
                </row>

                <row>
                  <entry>&man.dladdr.3; 機能追加後の 4.0-CURRENT</entry>
                  <entry>400003</entry>
                </row>

                <row>
                  <entry>__deregister_frame_info dynamic linker のバグ修正,
                    EGCS 1.1.2 導入後の 4.0-CURRENT</entry>
                  <entry>400004</entry>
                </row>

                <row>
                  <entry>&man.suser.9; の API 変更, newbus 化
                    以降の 4.0-CURRENT</entry>
                  <entry>400005</entry>
                </row>

                <row>
                  <entry>cdevsw 登録方法の変更後の 4.0-CURRENT</entry>
                  <entry>400006</entry>
                </row>

                <row>
                  <entry>ソケットレベルの証明書 (credential) のために
                    so_cred が追加された後の 4.0-CURRENT</entry>
                  <entry>400007</entry>
                </row>

                <row>
                  <entry>libc_r への poll syscall ラッパー追加後の
                    4.0-CURRENT</entry>
                  <entry>400008</entry>
                </row>

                <row>
                  <entry>kernel の <literal>dev_t</literal> 型から
                    <literal>struct spacinfo</literal> ポインタへの
                    変更後の 4.0-CURRENT</entry>
                  <entry>400009</entry>
                </row>

                <row>
                  <entry>&man.jail.2; のセキュリティホール
                    修正後の 4.0-CURRENT </entry>
                  <entry>400010</entry>
                </row>

                <row>
                  <entry><literal>sigset_t</literal> の
                    データ型変更後の 4.0-CURRENT</entry>
                  <entry>400011</entry>
                </row>

                <row>
                  <entry>システムコンパイラを gcc 2.95.2 にアップグレードした
                    後の 4.0-CURRENT</entry>
                  <entry>400012</entry>
                </row>

                <row>
                  <entry>動的組み込み可能な Linux モードの ioctl ハンドラが
                    追加された後の 4.0-CURRENT</entry>
                  <entry>400013</entry>
                </row>

                <row>
                  <entry>OpenSSL 導入後の 4.0-CURRENT</entry>
                  <entry>400014</entry>
                </row>

                <row>
                  <entry>GCC 2.95.2 の C++ ABI 変更で,
                    デフォルトを -fvtable-thunks から -fno-vtable-thunks に
                    変更した後の 4.0-CURRENT</entry>
                  <entry>400015</entry>
                </row>

                <row>
                  <entry>OpenSSH 導入後の 4.0-CURRENT</entry>
                  <entry>400016</entry>
                </row>

                <row>
                  <entry>4.0-RELEASE</entry>
                  <entry>400017</entry>
                </row>

                <row>
                  <entry>4.0-RELEASE 以降の 4.0-STABLE</entry>
                  <entry>400018</entry>
                </row>

                <row>
                  <entry>libxpg4 が libc にマージされた後の
                    4.0-STABLE</entry>
                  <entry>400020</entry>
                </row>

                <row>
                  <entry>Binutils を 2.10.0 にアップグレードし,
                    ELF バイナリのマーク付け (branding) 方法を変更し,
                    tcsh をベースシステムに導入した後の
                    4.0-STABLE</entry>
                  <entry>400021</entry>
                </row>

                <row>
                  <entry>4.1-RELEASE</entry>
                  <entry>410000</entry>
                </row>

                <row>
                  <entry>4.1-RELEASE 以降の 4.1-STABLE</entry>
                  <entry>410001</entry>
                </row>

                <row>
                  <entry>&man.setproctitle.3; が libutil から libc に
                    移動した後の 4.1-STABLE</entry>
                  <entry>410002</entry>
                </row>

                <row>
                  <entry>4.1.1-RELEASE</entry>
                  <entry>411000</entry>
                </row>

                <row>
                  <entry>4.1.1-RELEASE 以降の 4.1.1-STABLE</entry>
                  <entry>411001</entry>
                </row>

                <row>
                  <entry>4.2-RELEASE</entry>
                  <entry>420000</entry>
                </row>

                <row>
                  <entry>libgcc.a と libgcc_r.a の結合および, 関連する
                    GCC linkage 変更が行なわれた後の 4.2-STABLE</entry>
                  <entry>420001</entry>
                </row>

                <row>
                  <entry>4.3-RELEASE</entry>
                  <entry>430000</entry>
                </row>

                <row>
                  <entry>wint_t 導入後の 4.3-STABLE</entry>
                  <entry>430001</entry>
                </row>

                <row>
                  <entry>PCI パワーステート API マージ後の 4.3-STABLE</entry>
                  <entry>430002</entry>
                </row>

                <row>
                  <entry>5.0-CURRENT</entry>
                  <entry>500000</entry>
                </row>

                <row>
                  <entry>ELF ヘッダフィールドの追加と ELF バイナリのマーク付け
                    (branding) 方法の変更後の 5.0-CURRENT</entry>
                  <entry>500001</entry>
                </row>

                <row>
                  <entry>kld メタデータ変更後の 5.0-CURRENT</entry>
                  <entry>500002</entry>
                </row>

                <row>
                  <entry>buf/bio 変更後の 5.0-CURRENT</entry>
                  <entry>500003</entry>
                </row>

                <row>
                  <entry>binutils アップグレード後の 5.0-CURRENT</entry>
                  <entry>500004</entry>
                </row>

                <row>
                  <entry>libxpg4 コードの libc へのマージと,
                    TASKQ インターフェイスの導入後の 5.0-CURRENT</entry>
                  <entry>500005</entry>
                </row>

                <row>
                  <entry>AGP インターフェイス追加後の 5.0-CURRENT</entry>
                  <entry>500006</entry>
                </row>

                <row>
                  <entry>Perl を 5.6.0 にアップグレードした後の
                    5.0-CURRENT</entry>
                  <entry>500007</entry>
                </row>

                <row>
                  <entry>KAME コードを 2000/07 版のソースに更新した後の
                    5.0-CURRENT</entry>
                  <entry>500008</entry>
                </row>

                <row>
                  <entry>ether_ifattach() および
                    ether_ifdetach() 変更後の 5.0-CURRENT</entry>
                  <entry>500009</entry>
                </row>

                <row>
                  <entry>mtree のデフォルトをオリジナルの変種に戻し,
                    シンボリックリンクをたどる -L オプションを追加した後の
                    5.0-CURRENT</entry>
                  <entry>500010</entry>
                </row>

                <row>
                  <entry>kqueue API 変更後の 5.0-CURRENT</entry>
                  <entry>500011</entry>
                </row>

                <row>
                  <entry>&man.setproctitle.3; が libutil から libc
                    へ移動した後の 5.0-CURRENT</entry>
                  <entry>500012</entry>
                </row>

                <row>
                  <entry>最初の SMPng がコミットされた後の
                    5.0-CURRENT</entry>
                  <entry>500013</entry>
                </row>

                <row>
                  <entry>&lt;sys/select.h&gt; が &lt;sys/selinfo.h&gt; に
                    移動した後の 5.0-CURRENT</entry>
                  <entry>500014</entry>
                </row>

                <row>
                  <entry>libgcc.a と libgcc_r.a の結合および関連する
                    GCC linkage 変更が行なわれた後の 5.0-CURRENT</entry>
                  <entry>500015</entry>
                </row>

                <row>
                  <entry>libc と libc_r の混合リンクを許し,
                    -pthread オプションを deprecate する
                    変更後の 5.0-CURRENT</entry>
                  <entry>500016</entry>
                </row>

                <row>
                  <entry>mountd 等が使用する kernel-exported API の
                    安定化のため, ucred 構造体から xucred 構造体へ
                    移行した後の 5.0-CURRENT</entry>
                  <entry>500017</entry>
                </row>

                <row>
                  <entry>CPU 依存の最適化を制御するための make 変数
                    CPUTYPE が追加された後の 5.0-CURRENT</entry>
                  <entry>500018</entry>
                </row>

                <row>
                  <entry>&lt;machine/ioctl_fd.h&gt; が
                     &lt;sys/fdcio.h&gt; に移動した後の 5.0-CURRENT</entry>
                  <entry>500019</entry>
                </row>

                <row>
                  <entry>ロケール名変更の後の 5.0-CURRENT</entry>
                  <entry>500020</entry>
                </row>

                <row>
                  <entry>Bzip2 導入後の 5.0-CURRENT</entry>
                  <entry>500021</entry>
                </row>

                <row>
                  <entry>SSE サポート後の 5.0-CURRENT</entry>
                  <entry>500022</entry>
                </row>
              </tbody>
            </tgroup>
          </informaltable>
        </listitem>
      </itemizedlist>

      <note>
        <para>(2.2-STABLE は 2.2.5-RELESE 以後,
          <quote>2.2.5-STABLE</quote> と呼ばれることがあります.)
          見てのとおりこれは年・月というフォーマットになっていましたが,
          バージョン 2.2 からより直接的にメジャー/マイナー番号を使うように変更になりました.
          並行していくつかのブランチ
          (枝分かれしたバージョン)
          を開発する場合には,
          リリースされた日付でそれらのリリースを分類することが不可能だからです
          (あなたが今 port
          を作成するときに, 古い -CURRENT 達について心配する必要はありません.
          これは参考のために挙げられているに過ぎないからです).</para>
      </note>

      <para>これまで, 何百もの
        port が作られてきましたが,
        <literal>__FreeBSD__</literal>
        が正しく使われたのは一つか二つの場合だけでしょう.
        以前の port が誤った場所でそのマクロを使っているからといって,
        それをまねする理由はありません.</para>
    </sect1>

    <sect1>
      <title><filename>bsd.port.mk</filename> の後に書くこと</title>

      <para><literal>.include &lt;bsd.port.mk&gt;</literal>
        の行の後には何も書かないようにしてください.
        大抵の場合は
        <filename>Makefile</filename> の中程のどこかで
        <filename>bsd.port.pre.mk</filename> をインクルードして,
        最後に
        <filename>bsd.port.pre.mk</filename>
        をインクルードすることによって避けることができます.</para>

      <note>
        <para><filename>pre.mk</filename>/<filename>post.mk</filename>
          のペアか <filename>bsd.port.mk</filename>
          だけのどちらかだけをインクルードし, 二つを混ぜないでください.</para>
      </note>

      <para>前者はいくつかの変数の定義だけをして
        <filename>Makefile</filename>
        でのテストに使用し, 後者は残りを定義します.</para>

      <para>以下は <filename>bsd.port.pre.mk</filename>
        で定義される重要な変数です
        (これは, すべてではありません.
        完全なリストは <filename>bsd.port.mk</filename> を参照してください).
      </para>

      <informaltable frame="none">
        <tgroup cols="2">
          <thead>
            <row>
              <entry>変数名</entry>
              <entry>解説</entry>
            </row>
          </thead>

          <tbody>
            <row>
              <entry><makevar>ARCH</makevar></entry>
              <entry><command>uname -m</command> で返される
                アーキテクチャ. (例, <literal>i386</literal>).
              </entry>
            </row>

            <row>
              <entry><makevar>OPSYS</makevar></entry>
              <entry><command>uname -s</command> で返される
                オペレーティングシステム (例,
                <literal>FreeBSD</literal>).</entry>
            </row>

            <row>
              <entry><makevar>OSREL</makevar></entry>
              <entry>オペレーティングシステムの
                リリースバージョン
                (例., <literal>2.1.5</literal>,
                <literal>2.2.7</literal>).</entry>
            </row>

            <row>
              <entry><makevar>OSVERSION</makevar></entry>
              <entry>数字形式のオペレーティングシステム
                のバージョン,
                上記の <link linkend="porting-versions"><literal>
                    __FreeBSD_version</literal></link>
                と同じです.</entry>
            </row>

            <row>
              <entry><makevar>PORTOBJFORMAT</makevar></entry>
              <entry>システムのオブジェクト
                フォーマット (<literal>aout</literal> あるいは
                <literal>elf</literal>).</entry>
            </row>

            <row>
              <entry><makevar>LOCALBASE</makevar></entry>
              <entry><quote>local</quote> ツリーのベース.
                (例, <literal>/usr/local/</literal>).
              </entry>
            </row>

            <row>
              <entry><makevar>X11BASE</makevar></entry>
              <entry><quote>X11</quote> ツリーのベース.
                (例, <literal>/usr/X11R6/</literal>).
              </entry>
            </row>

            <row>
              <entry><makevar>PREFIX</makevar></entry>
              <entry>ports のインストール先
                (<link linkend="porting-prefix">
                  <makevar>PREFIX</makevar>について</link>を参照).
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>

      <note>
        <para><makevar>USE_IMAKE</makevar>,
          <makevar>USE_X_PREFIX</makevar> あるいは
          <makevar>MASTERDIR</makevar>
          などの変数を定義する必要がある場合には,
          <filename>bsd.port.pre.mk</filename>
          をインクルード前に定義してください.
          他のものは <filename>bsd.port.pre.mk</filename>
          の前でも後でもかまいません.</para>
      </note>

      <para>以下は <filename>bsd.port.pre.mk</filename>
        の後に書けるものの例です.</para>

      <programlisting># no need to compile lang/perl5 if perl5 is already in system
.if ${OSVERSION} > 300003
BROKEN= perl is in system
.endif

# only one shlib version number for ELF
.if ${PORTOBJFORMAT} == "elf"
TCL_LIB_FILE=  ${TCL_LIB}.${SHLIB_MAJOR}
.else
TCL_LIB_FILE=  ${TCL_LIB}.${SHLIB_MAJOR}.${SHLIB_MINOR}
.endif

# software already makes link for ELF, but not for a.out
post-install:
.if ${PORTOBJFORMAT} == "aout"
       ${LN} -sf liblinpack.so.1.0 ${PREFIX}/lib/liblinpack.so
.endif</programlisting>
    </sect1>

    <sect1>
      <title>付加的な文書のインストール</title>

      <para>普通のマニュアルや info
        ファイルの他にユーザにとって有用だと思えるような文書がある場合には,
        <filename><makevar> PREFIX</makevar>/share/doc</filename>
        の下にインストールしてください.
        これは前記と同様
        <maketarget>post-install</maketarget>
        ターゲットの中から行なうと良いでしょう.</para>

      <para>まず, あなたの port のために新しいディレクトリを作ります.
        どの port の文書か簡単にわかるような名前にする必要がありますので,
        普通は <makevar>PORTNAME</makevar> を使うと良いでしょう.
        もちろん, ユーザが異なるバージョンのものを同時に使うことが予想される
        port の場合には
        <makevar>PKGNAME</makevar> をそのまま使っても構いません.</para>

      <para>ユーザが <filename>/etc/make.conf</filename>
        でこの部分を禁止するために
        <makevar>NOPORTDOCS</makevar>
        という変数をセットしている場合には,
        これらの文書がインストールされないようにしてください.
        こんな具合です.</para>

      <programlisting>post-install:
.if !defined(NOPORTDOCS)
        ${MKDIR} ${PREFIX}/share/doc/xv
        ${INSTALL_MAN} ${WRKSRC}/docs/xvdocs.ps ${PREFIX}/share/doc/xv
.endif</programlisting>

	<para>文書ファイルおよびディレクトリはすべて
          <filename>pkg-plist</filename> の中に
	  <literal>%%PORTDOCS%%</literal> を頭につけて書く必要があります.
          たとえば, 次のようにしてください.</para>

	<programlisting>%%PORTDOCS%%share/doc/pure-ftpd/AUTHORS
%%PORTDOCS%%share/doc/pure-ftpd/CONTACT
%%PORTDOCS%%@dirrm share/doc/pure-ftpd</programlisting>

      <para>インストール時に
        <filename>pkg-message</filename>
        ファイルを利用してメッセージを表示することができます.
        詳細は
        <link linkend="porting-message">pkg-message を使う</link>のセクションを
        参照してください.</para>

      <!-- kuriyama - note below is not exist in Jap ver, but Eng ver has it. why? -->
      <note>
        <para><filename>pkg-message</filename>
          ファイルを
          <filename>pkg-plist</filename>
          に加える必要はありません.</para>
      </note>
    </sect1>

    <sect1>
      <title><makevar>DIST_SUBDIR</makevar></title>

      <para><filename>/usr/ports/distfiles</filename>
        ディレクトリ内をあまり散らかさないようにしてください.
        たくさんのファイルを取ってくる port や,
        数は少なくても他の port
        のファイルと混同される恐れがあるファイル
        (<filename>Makefile</filename> など)
        がある場合には,
        <makevar>DIST_SUBDIR</makevar> に port の名前
        (<literal>${PORTNAME}</literal> か
        <literal>${PKGNAMEPREFIX}${PORTNAME}</literal> を使うといいでしょう)
        を入れてください.
        すると <makevar>DISTDIR</makevar>
        がデフォルトの
        <filename>/usr/ports/distfiles</filename> から
        <filename>/usr/ports/distfiles/<makevar>DIST_SUBDIR</makevar></filename>
        に変更され,
        取ってきたファイルはすべてそのサブディレクトリの中に置かれるようになります.</para>

      <para>また,
        ファイルを取ってくるときにバックアップサイトとして使われる
        <filename>ftp.FreeBSD.org</filename>
        のディレクトリ名にもこの変数の値が使われます
        (<makevar>DISTDIR</makevar> を明示的に指定した場合,
        ローカルのファイルを置くところは変わりますが,
        このサイトのディレクトリ名は変わりません.
        必ず <makevar>DIST_SUBDIR</makevar> を使うようにしてください).</para>

      <note>
        <para>この変数は <filename>Makefile</filename>
          中で明示的に指定された
          <makevar>MASTER_SITES</makevar>
          には影響しないことに注意してください.</para>
      </note>
    </sect1>

    <sect1>
      <title>package 情報</title>

      <para><filename>pkg-comment</filename> や <filename>pkg-descr</filename>,
        <filename>pkg-plist</filename> といった
        package 情報を必ず入れるようにしてください.</para>

      <note>
        <para>これらのファイルはもはや package
          の作成だけに使われるものではなくなっています.
          たとえ <makevar>NO_PACKAGE</makevar>が定義されていたとしても
          <emphasis>必須</emphasis>であることに注意してください.</para>
      </note>
    </sect1>

    <sect1>
      <title>RCS 文字列</title>

      <para>RCS にとって特別な意味を持つ文字列をパッチ内に入れないようにしてください.
        ファイルを私たちのソースツリーに入れる時,
        これらの文字列は CVS によって書き換えられてしまい,
        後でまたパッチを使おうとした時にうまくいかないことがあります.
        RCS 文字列はドル記号 (<literal>&dollar;</literal>)
        で囲まれており,
        <literal>&dollar;FreeBSD</literal> や
        <literal>&dollar;RCS</literal>
        などで始まります.</para>
    </sect1>

    <sect1>
      <title>再帰的 diff</title>

      <para><command>diff</command>
        の再帰
        (<option>-r</option>)
        フラグを使って再帰的なパッチを作るのは大変結構なのですが,
        でき上がったパッチは必ず目でチェックして余計なゴミが入っていないことを確認してください.
        よくあるのはバックアップファイル同士の変更点,
        あるいは
        <command>Imake</command> や
        GNU <command>configure</command>
        を使うソフトウェアの
        <filename>Makefile</filename>
        の変更点が入っている場合などです.
        また <filename>configure.in</filename> を編集して
        <command>autoconf</command> を使って
        <command>configure</command> を作り直すときには,
        <command>configure</command> の diff は含めずに
        (それらは良く数千行におよぶことがあります),
        <literal>USE_AUTOCONF=yes</literal> を定義して
        <filename>configure.in</filename> の
        diff をとってください.</para>

      <para>ファイルをまるごと消す場合には,
        パッチを使わずに
        <maketarget>post-extract</maketarget> ターゲットで消す方が簡単です.
        できあがった差分に満足したら,
        それらをソースのファイルごとに別々のパッチファイルに分割してください.</para>
    </sect1>

    <sect1 id="porting-prefix">
      <title><makevar>PREFIX</makevar></title>

      <para>なるべく port は <makevar>PREFIX</makevar>
        に対する相対パスにインストールすることができるように心がけてください
        (この変数の値は
        <makevar>USE_X_PREFIX</makevar> か
        <makevar>USE_IMAKE</makevar> が指定してある時には
        <makevar>X11BASE</makevar>
        (デフォルトは <filename>/usr/X11R6</filename>),
        そうでない場合には<makevar>LOCALBASE</makevar>
        (デフォルトは <filename>/usr/local</filename>)
        にセットされます).</para>

      <para>サイトによってフリーソフトウェアがインストールされる場所が違いますので,
        ソース内で
        <filename>/usr/local</filename> や
        <filename>/usr/X11R6</filename>
        を明示的に書かないようにしてください.
        X のプログラムで
        <command>imake</command> を使うものについては,
        <!-- kuriyama - imake is command -->
        これは問題にはなりません.
        それ以外の場合にはソース中の Makefile やスクリプトで
        <filename>/usr/local</filename>
        (imake を使わない X のプログラムは <filename>/usr/X11R6</filename>)
        と書いてあるところを
        <makevar>PREFIX</makevar> に書き換えてください.
        この値は port のコンパイルおよび,
        インストール時に自動的に環境変数として下位 make に渡されます.</para>

      <para>そのアプリケーションが <makevar>PREFIX</makevar> を
        使用しないで, 何かを直接 <filename>/usr/local</filename> に
        インストールしないことを確認してください.
        以下のようにすると, 簡単なテストを行なうことができます:</para>

        <screen>&prompt.root; <userinput>make clean; make package PREFIX=/var/tmp/<replaceable>port-name</replaceable></userinput></screen>

      <para>この時, もし <makevar>PREFIX</makevar> の外に
        何かがインストールされていた場合, package 生成プロセスは
        ファイルが見つからないと文句を言うはずです.</para>

      <!-- XXX This paragraph is confusing and poorly indented. -->
      <para>ただし, これは そのソフトウェアが内部で決め打ちの参照を
        していないかどうか だとか, 他の port によってインストールされる
        ファイルを参照する際に <makevar>LOCALBASE</makevar> を
        正しく使用しているかどうかをテストしているわけではありません.
        その port を他の場所にインストールした状態で,
        <filename>/var/tmp/<replaceable>port-name</replaceable></filename> に
        対するインストールを試みることにより,
        そのテストをすることができるでしょう.</para>

      <para><makevar>USE_X_PREFIX</makevar> は本当に必要な時 (つまり
        X のライブラリをリンクしたり, <makevar>X11BASE</makevar> 以下にある
        ファイルを参照したりする必要がある時) 以外には
        設定しないでください.</para>

      <para>変数 <makevar>PREFIX</makevar> の値は
        port の Makefile やユーザの環境で変更することもできます.
        しかし, 個々の port が Makefile
        でこの変数の値を明示的に設定することはなるべくしないでください.</para>

      <para>また, 他の port によりインストールされるプログラムや
        ファイルを指定する場合には, 直接的なパス名を使用するのではなく
        上で述べた変数を使用してください.
        たとえば <command>less</command> のフルパスを
        <literal>PAGER</literal> というマクロに入れたい場合は,
        <literal>-DPAGER=\"/usr/local/bin/less\"</literal>
        というフラグをコンパイラに渡すかわりに
        <programlisting>-DPAGER=\"&dollar;{PREFIX}/bin/less\"</programlisting>
        (X Window System を使う port の場合には
        <programlisting>-DPAGER=\"&dollar;{LOCALBASE}/bin/less\"</programlisting>)
        を渡してください.
        こうしておけば, システム管理者が <quote>/usr/local</quote> を
        まるごと どこか他の場所に移していたとしても, その port が
        そのまま使える可能性が高くなります.</para>
    </sect1>

    <sect1>
      <title>ディレクトリ構成</title>

      <para>インストール時には
        <makevar>PREFIX</makevar>
        の正しいサブディレクトリにファイルを置くように心がけてください.
        ソフトウェアによっては新しいディレクトリを一つ作って,
        ファイルを全部それに入れてしまうものがありますが,
        それは良くありません.
        また, バイナリ, ヘッダファイルとマニュアル以外のすべてを
        <filename>lib</filename>
        というディレクトリに入れてしまう port もありますが,
        これも BSD 的なファイルシステム構成からいうと正しくありません.
        これは以下のように分散すべきです.
        <filename>etc</filename>
        にセットアップ/コンフィグレーションファイル,
        <filename>libexec</filename>
        に内部で使用されるプログラム
        (コマンドラインから呼ばれることのないコマンド),
        <filename>sbin</filename>
        に管理者用のコマンド,
        <filename>info</filename>
        に GNU Info 用の文書,
        そして
        <filename>share</filename> にアーキテクチャに依存しないファイルが入ります.
        詳細については &man.hier.7; のマニュアルページを参照してください.
        <filename>/usr</filename>
          の構成方針はほとんどそのまま
          <filename>/usr/local</filename> にもあてはまります.
          USENET <quote>ニュース</quote>を扱う ports は例外です.
          これらはファイルのインストール先として
          <filename><makevar>PREFIX</makevar>/news</filename>
          を使用します.</para>
    </sect1>

    <sect1 id="porting-cleaning">
      <title>空のディレクトリの削除</title>

      <para>ports は削除の際に,
        自分自身を消去したあとに
        (ディレクトリの)
        削除をするようにしてください.
        これは大抵の場合 <literal>@dirrm</literal> の行を
        ports が作成するすべてのディレクトリについて加えることによって実現できます.
        親ディレクトリは子ディレクトリを先に消さないと消せないことに注意してください.</para>

      <programlisting> :
lib/X11/oneko/pixmaps/cat.xpm
lib/X11/oneko/sounds/cat.au
 :
@dirrm lib/X11/oneko/pixmaps
@dirrm lib/X11/oneko/sounds
@dirrm lib/X11/oneko</programlisting>

      <para>といった感じです.</para>

      <para>しかし時として,
        他の port とディレクトリを共有しているために
        <literal>@dirrm</literal> がエラーを返すことがあります.
        <command>rmdir</command> を
        <literal>@unexec</literal>
        から呼びだすことによって,
        警告(warning)なしで空のディレクトリのみを削除することができます.
      </para>

      <programlisting>@unexec rmdir %D/share/doc/gimp 2>/dev/null || true</programlisting>

      <para>
        これを使えば, たとえ他の
        port がファイルをインストールしていて
        <filename><makevar>PREFIX</makevar>/share/doc/gimp</filename>
        が空でない場合でもエラーメッセージは表示されませんし,
        <command>pkg_delete</command>
        が異常終了することもありません.</para>
    </sect1>

    <sect1>
      <title>UID</title>

      <para>あなたの port が,
        インストールされるシステム上に特定のユーザを必要とする場合は
        <filename>pkg-install</filename> スクリプトから
        <command>pw</command>
        コマンドを実行して自動的にそのユーザを追加するようにしてください.
        <filename>net/cvsup-mirror</filename> の port が参考になるでしょう.</para>

      <para>あなたの port がバイナリの
        package としてインストールされる場合とコンパイルされる場合の両方で,
        同じユーザー/グループ ID
        を使わなければならないのなら, 50 から 99 の間で空いている UID を選んで登録してください.
        <filename>japanese/Wnn</filename> の port
        が参考になるでしょう.</para>

      <para>既にシステムや他の port で利用されている
        UIDを使わないように十分注意してください.
        現在の 50 から 99 までの間の UID は以下のとおりです.</para>

      <programlisting>majordom:*:54:54:Majordomo Pseudo User:/usr/local/majordomo:/nonexistent
cyrus:*:60:60:the cyrus mail server:/nonexistent:/nonexistent
gnats:*:61:1:GNATS database owner:/usr/local/share/gnats/gnats-db:/bin/sh
uucp:*:66:66:UUCP pseudo-user:/var/spool/uucppublic:/usr/libexec/uucp/uucico
xten:*:67:67:X-10 daemon:/usr/local/xten:/nonexistent
pop:*:68:6:Post Office Owner (popper):/nonexistent:/nonexistent
wnn:*:69:7:Wnn:/nonexistent:/nonexistent
ifmail:*:70:66:Ifmail user:/nonexistent:/nonexistent
pgsql:*:70:70:PostgreSQL pseudo-user:/usr/local/pgsql:/bin/sh
ircd:*:72:72:IRCd hybrid:/nonexistent:/nonexistent
alias:*:81:81:QMail user:/var/qmail/alias:/nonexistent
qmaill:*:83:81:QMail user:/var/qmail:/nonexistent
qmaild:*:82:81:QMail user:/var/qmail:/nonexistent
qmailq:*:85:82:QMail user:/var/qmail:/nonexistent
qmails:*:87:82:QMail user:/var/qmail:/nonexistent
qmailp:*:84:81:QMail user:/var/qmail:/nonexistent
qmailr:*:86:82:QMail user:/var/qmail:/nonexistent
msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh
mysql:*:88:88:MySQL Daemon:/var/db/mysql:/sbin/nologin
vpopmail:*:89:89::0:0:User &:/usr/local/vpopmail:/nonexistent</programlisting>

      <para>このリストを最新の状態に保つためにも,
        この範囲の UID や GID を予約するような port を作ったり,
        既存の port にそのような改変を行なってわたしたちに送るときには
        UID の予約に関する注意書きをつけてください.</para>
    </sect1>

    <sect1>
      <title>合理的な port</title>

      <para><filename>Makefile</filename>
        は単純かつ適切であるべきです. もし,
        <filename>Makefile</filename> を数行短かくできたり,
        もっと読みやすくできるのであればそうしてください.
        たとえば,
        シェルの <literal>if</literal> 構文を使うかわりに
        make の <literal>.if</literal> 構文を使う,
        <makevar>EXTRACT*</makevar> の再定義で代用できるのであれば
        <maketarget>do-extract</maketarget> を再定義しない,
        <literal>CONFIGURE_ARGS += --prefix=&dollar;{PREFIX}</literal>
        とするかわりに
        <makevar>GNU_CONFIGURE</makevar> とする, などです.</para>
    </sect1>

    <sect1>
      <title><makevar>CFLAGS</makevar> の尊重</title>

      <para><makevar>CFLAGS</makevar> 変数は尊重すべきです.
        port がこれを無視する場合は,
        <literal>NO_PACKAGE=ignores cflags</literal> を
        <filename>Makefile</filename> に加えてください.</para>

      <para><makevar>CFLAGS</makevar> 変数をきちんと考慮した
        <filename>Makefile</filename> の例を以下に示します.
        <makevar>+=</makevar> の部分に注目してください.</para>

      <programlisting>CFLAGS += -Wall -Werror</programlisting>

      <para>次は <makevar>CFLAGS</makevar>
        変数を考慮しない <filename>Makefile</filename> の例です.</para>

      <programlisting>CFLAGS = -Wall -Werror</programlisting>

      <para><makevar>CFLAGS</makevar> 変数は,
        FreeBSD システムの
        <filename>/etc/make.conf</filename>
        で定義されています.
        最初の例では既存の定義を保存しつつ <makevar>CFLAGS</makevar>
        変数にオプションフラグを追加しているのに対し,
        二番目の例では既存の定義をすべて無効にしてしまっています.</para>
    </sect1>

    <sect1>
      <title>コンフィグレーション (設定) ファイル</title>

      <para>もしあなたの port が設定ファイルを
        <filename><makevar>PREFIX</makevar>/etc</filename>
        に置く必要がある場合には, それを単純にインストールしたり,
        <filename>pkg-plist</filename>
        に加えては<emphasis>いけません</emphasis>.
        こうしてしまうと
        <command>pkg_delete</command>
        によってユーザが苦労して作ったファイルが消えてしまったり,
        新しくインストールする時に上書きされてしまったりします.</para>

      <para>かわりに見本となるファイルを
        サフィックス
        (<filename><replaceable>filename</replaceable>.sample</filename> が良いでしょう)
        を付けてインストールして<link linkend="porting-message">メッセージ</link>を表示し,
        ソフトウェアを動かす前にユーザがそのファイルをコピーして編集をしなければならないことを知らせましょう.
      </para>
    </sect1>

    <sect1>
      <title>portlint</title>

      <para>送付や commit をする前に
        <link linkend="porting-portlint"><command>portlint</command></link>
        を使ってチェックしましょう.</para>
    </sect1>

    <sect1>
      <title>フィードバック</title>

      <para>port を作るためにソフトウェアに変更を加えたら,
        なるべく原作者にその旨を伝えてパッチ等を送ってください.
        これらが次のリリースに取り入れられればアップグレードが楽になります.</para>
    </sect1>

    <sect1>
      <title><filename>README.html</filename></title>

      <para>
        <filename>README.html</filename> というファイルを含めてはいけません.
        このファイルは, cvs コレクションの一部ではなく,
        <command>make readme</command> コマンドで生成されるファイルです.</para>
    </sect1>

    <sect1>
      <title>その他諸々</title>

      <para><filename>pkg-comment</filename>,
        <filename>pkg-descr</filename>,
        <filename>pkg-plist</filename> などのファイルはそれぞれ二重にチェックしてください.
        再検討してもっと良い記述があればそれに置きかえてください.</para>

      <para>GNU General Public License
        (GNU一般公有使用許諾)
        のコピーは
        (すでにあるので)
        コピーしないでください.
        お願いします.</para>

      <para>法律に関することには十分注意をはらってください.
        わたしたちに法律に反するような形でソフトウェアの配布をさせないでください!</para>
    </sect1>

    <sect1>
      <title>困ったら....</title>

      <para>わたしたちに質問を送る前に,
        既存の port の例と
        <filename>bsd.port.mk</filename> をちゃんと読んでください!
        <!-- smiley --><emphasis>;)</emphasis></para>

      <para>それでもわからないことがあったら一人で悩まないでどんどん質問してください!
        <!-- smiley --><emphasis>:-)</emphasis></para>
    </sect1>
  </chapter>

  <chapter id="porting-samplem">
    <title><filename>Makefile</filename> のサンプル</title>

    <para>これは port の
      <filename>Makefile</filename> を作る際のお手本です.
      かぎかっこ ([]) 内のコメントは忘れずに取ってください.</para>

    <para>変数の順番, 段落の間の空行など,
      <filename>Makefile</filename>
      を作るときはなるべくこの形式に従ってください.
      この形式は重要な情報が簡単に見つけられるように設計されています.
      <link linkend="porting-portlint">portlint</link> を使って
      <filename>Makefile</filename> をチェックすることが推奨されています.</para>

    <programlisting>[ヘッダ ... どのような port の Makefile かすぐにわかるようになっています]
# New ports collection makefile for:    xdvi
["version required" 行は, PORTVERSION 変数では port のバージョンを
十分に表現できない場合にのみ必要です. ]
# Date created: 26 May 1995
[このソフトウェアを最初に FreeBSD に port した人の名前, つまり,
 この Makefile の最初の版を書いた人です. この port をアップグレー
 ドするとき, この行も変えないでください.]
# Whom:         Satoshi Asami &lt;asami@FreeBSD.org&gt;
#
# &dollar;FreeBSD&dollar;
[ ^^^^^^^^^ この部分は, CVS ツリーに入れる時に自動的に RCS の ID 文字列に
 置き換えられます.]
#

[port 自体, およびオリジナルのソースを取ってくるところを記述する部分.
 最初は必ず PORTNAME と PORTVERSION, そして必要なら PKGNAME,
 CATEGORIES, 続いて MASTER_SITES が置かれ, さらに MASTER_SITE_SUBDIR が
 置かれることもあります.  必要なら PKGNAMEPREFIX と PKGNAMESUFFIX が
 それに続き, そして DISTNAME, EXTRACT_SUFX, DISTFILES が,
 また, その後に必要に応じて EXTRACT_ONLY が置かれます.]
PORTNAME=       xdvi
PORTVERSION=    18.2
CATEGORIES=     print
[MASTER_SITE_* マクロを使用しない場合は,
最後のスラッシュを忘れないように ("/")!]
MASTER_SITES= ${MASTER_SITE_XCONTRIB}
MASTER_SITE_SUBDIR= applications
DISTNAME=       xdvi-pl18
[ソースファイルが標準の ".tar.gz" 形式でない時にこれを使いましょう]
EXTRACT_SUFX=   .tar.Z

[配布パッチセクション -- ない場合もあります]
PATCH_SITES=    ftp://ftp.sra.co.jp/pub/X11/japanese/
PATCHFILES=     xdvi-18.patch1.gz xdvi-18.patch2.gz

[保守責任者 -- これは *必ず* 必要です. 担当者 (あなた) 自身, あるいは
 担当者に素早く連絡をとれる人のアドレスを書いてください. どうしてもこ
 こに自分のアドレスを書くのがいやな人は "ports@FreeBSD.org" と書いて
 もいいです]
MAINTAINER=     asami@FreeBSD.org

[依存するport -- ない場合もあります]
RUN_DEPENDS=    gs:${PORTSDIR}/print/ghostscript
LIB_DEPENDS=    Xpm.5:${PORTSDIR}/graphics/xpm

[ここには標準の bsd.port.mk の変数で, 上のどれにもあてはまらないものを
 書きます]
[コンフィグレーション, コンパイル, インストールなどの時に質問をする
 なら...]
IS_INTERACTIVE=yes
[${DISTNAME} 以外のディレクトリにソースが展開されるなら...]
WRKSRC= ${WRKDIR}/xdvi-new
[配布されているパッチが ${WRKSRC} に対する相対パスで作られてい
 い場合にこの変数の指定が必要かも...]
PATCH_DIST_STRIP=       -p1
[GNU autoconf によって生成された "configure" スクリプトを走らせたいなら...]
GNU_CONFIGURE=  yes
[/usr/bin/makeでなく, GNU make を使わないといけないなら...]
USE_GMAKE=      yes
[これが X のアプリケーションで, "xmkmf -a" を走らせたいなら...]
USE_IMAKE=      yes
[などなど]

[下の方のルールで使う非標準の変数]
MY_FAVORITE_RESPONSE=   "yeah, right"

[そして, 特別なターゲット, 使用順に]
pre-fetch:
        i go fetch something, yeah

post-patch:
        i need to do something after patch, great

pre-install:
        and then some more stuff before installing, wow

[最後には必ず]
.include &lt;bsd.port.mk&gt;</programlisting>
  </chapter>

  <chapter id="porting-autoplist">
    <title>パッキングリストの自動生成</title>

    <para>まず, あなたの port に
      <filename>pkg-plist</filename>
      がないことを除いて完全なことを確認して,
      空の <filename>pkg-plist</filename> を作ってください.</para>

    <screen>&prompt.root; <userinput>touch pkg-plist</userinput></screen>

    <para>次に, あなたの port
      をインストールすることができるディレクトリ階層を新たに作成してください.
      また, 依存するものをインストールしてください.</para>

    <screen>&prompt.root; <userinput>mtree -U -f /etc/mtree/BSD.local.dist -d -e -p /var/tmp/<replaceable>port-name</replaceable></userinput>
&prompt.root; <userinput>make depends PREFIX=/var/tmp/<replaceable>port-name</replaceable></userinput></screen>

    <para>このディレクトリ構造を新しいファイルに保存してください.</para>

    <screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find * -type d) &gt; OLD-DIRS</userinput></screen>

    <para>もしあなたの port が <makevar>PREFIX</makevar> にちゃんと従うなら,
      ここで port をインストールしてパッキングリストを作ることができます.</para>

    <screen>&prompt.root; <userinput>make install PREFIX=/var/tmp</userinput>
&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find * \! -type d) &gt; pkg-plist</userinput></screen>

    <para>新しく生成されたディレクトリはすべてパッキングリストに追加する必要があります.</para>

    <screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name && find * -type d) | comm -13 OLD-DIRS - | sed -e 's#^#@dirrm#' &gt;&gt; pkg-plist</replaceable></userinput></screen>

    <para>最後にパッキングリストを手で整える必要があります;
      <emphasis>すべて</emphasis>が自動化されているわけではありません.
      マニュアルはパッキングリストに記述するのではなく,
      port の <filename>Makefile</filename> 中の
      <makevar>MAN<replaceable>n</replaceable></makevar> に
      記述しなければなりません.
      ユーザ設定ファイルは削除するか
      <filename><replaceable>filename</replaceable>.sample</filename>
      としてインストールされなければなりません.
      また <filename>info/dir</filename>
      ファイルはリストに含めず,
      <link linkend="porting-info">info ファイル</link>に記述されているように,
      適切な <filename>install-info</filename> 行に追加しなければなりません.
      port によってインストールされるライブラリは,
      <link linkend="porting-shlibs">共有ライブラリ</link>
      のセクションで示したように記載されるべきです.</para>
  </chapter>

  <chapter id="porting-pkgname">
    <title>package の名前</title>

    <para>package の名前は以下のルールにしたがってつけてください.
      これは package のディレクトリを見やすくするためで,
      無秩序な名前がたくさん並んでいるとユーザが使いづらくなるのではという心配からです
      (FTP サイトなどにはたくさん package がありますからね).</para>

    <para>package の名前は以下のようにしてください.
      <filename><replaceable>言語-</replaceable>名前<replaceable>-オプション</replaceable><replaceable>バージョン.番号</replaceable></filename></para>

    <para>package 名は
      <literal>${PKGNAMEPREFIX}${PORTNAME}${PKGNAMESUFFIX}-${PORTVERSION}</literal>
      というように定義されています.
      変数がこの書式と適合していることを確認してください.</para>

    <orderedlist>
      <listitem>
        <para>FreeBSD
          はユーザの慣れ親しんだ言語のサポートに力を入れています.
          特定の言語のための port の package 名には
          <replaceable>言語-</replaceable> に ISO-639
          で定義されている言語名の略称を入れてください.
          たとえば日本語なら <literal>ja</literal>,
          ロシア語なら <literal>ru</literal>,
          ベトナム語なら <literal>vi</literal>,
          中国語なら <literal>zh</literal>,
          韓国語ならば <literal>ko</literal>,
          ドイツ語なら <literal>de</literal>
          といった具合です.</para>

        <para>port がある言語地域に特化したものである場合には,
          さらに二文字の国名コードを付加してください.
          たとえば合衆国英語圏は <literal>en_US</literal> となり,
          スイスのフランス語圏は <literal>fr_CH</literal> となります.</para>

        <para><replaceable>言語-</replaceable> 部分は,
          <makevar>PKGNAMEPREFIX</makevar> 変数に
          定義されなければなりません.</para>
      </listitem>

      <listitem>
        <para><filename>名前</filename>の部分の最初の文字は
          小文字でなければなりません.
          (名前の残りの部分は大文字を含んでいても構わないため,
          大文字を含んだソフトウェア名を変換する際の規則は,
          あなた自身の裁量に任されています.)

          Perl 5 のモジュールでは先頭に
          <literal>p5-</literal> を付け,
          二重コロン (<literal>::</literal>)
          のセパレータをハイフン
          (<literal>-</literal>)
          に置きかえる習慣になっています.
          たとえば
          <literal>Data::Dumper</literal> は
          <literal>p5-Data-Dumper</literal> になります.
          また, そのソフトウェアの名前として通常使われるものに番号,
          ハイフン, あるいは下線が入っている場合には,
          それらを使うことも構いません
          (<literal>kinput2</literal>など).</para>
      </listitem>

      <listitem>
        <para>コンパイル時に環境変数や
          <command>make</command> の引数などで<link linkend="porting-masterdir">ハードコードされたデフォルト</link>を変えてコンパイルできる場合,
          <replaceable>-compiled.specifics</replaceable>
          にそのコンパイル時のデフォルトを入れてください
          (ハイフンはあってもなくてもかまいません).
          用紙のサイズ, あるいはフォントの解像度などがこれにあたります.</para>

        <para><replaceable>compiled.specifics</replaceable> 部分は,
          <makevar>PKGNAMESUFFIX</makevar> 変数に定義されなければなりません.</para>
      </listitem>

      <listitem>
        <para>バージョン番号は数字とアルファベットからなり,
          ピリオド (.) で区切ります.
          アルファベットは二文字以上続けてはいけません.
          ただ一つの例外は「パッチレベル」を意味する
          <literal>pl</literal> で,
          それ以外にバージョン番号がまったくついていない場合にのみ使うことができます.
          もしソフトウェアのバージョンに
          "alpha", "beta", "rc" や "pre" といった文字列が含まれる場合には,
          ピリオドの後に最初の一文字をとってください.
          これらの後に, さらにバージョン文字列が続く場合には,
          一文字のアルファベットの後にピリオドをつけずに番号を続けます.</para>

        <para>この考え方は,
          バージョン文字列を見て簡単に ports を並べられるようにするためのものです.
          特に, バージョン番号の各部分が必ずピリオドで区切られていること,
          また日付の部分がバージョン文字列の一部となっている場合には

          <literal><replaceable>yyyy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>

          という書式を使っていることを確認してください.

          <literal><replaceable>dd</replaceable>.<replaceable>mm</replaceable>.<replaceable>yyyy</replaceable></literal>

          や, 2000 年問題に対応していない

          <literal><replaceable>yy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>

          という書式を使ってはいけません.</para>
      </listitem>
    </orderedlist>

    <para>では, <makevar>DISTNAME</makevar>を正しい
      <makevar>PKGNAME</makevar>
      に直す例を見てみましょう:</para>

    <para>以下は, ソフトウェアの作者が決めた名前から
      適切な package 名に変換する方法を示した (実際の) 例です.</para>

    <informaltable frame="none">
      <tgroup cols="6">
        <thead>
          <row>
            <entry>配布名</entry>
            <entry><makevar>PKGNAMEPREFIX</makevar></entry>
            <entry><makevar>PORTNAME</makevar></entry>
            <entry><makevar>PKGNAMESUFFIX</makevar></entry>
            <entry><makevar>PORTVERSION</makevar></entry>
            <entry>理由</entry>
          </row>
        </thead>

        <tbody>
          <row>
            <entry>mule-2.2.2</entry>
            <entry>(空)</entry>
            <entry>mule</entry>
            <entry>(空)</entry>
            <entry>2.2.2</entry>
            <entry>変更の必要はありません</entry>
          </row>

          <row>
            <entry>XFree86-3.3.6</entry>
            <entry>(空)</entry>
            <entry>XFree86</entry>
            <entry>(空)</entry>
            <entry>3.3.6</entry>
            <entry>変更の必要はありません</entry>
          </row>

          <row>
            <entry>EmiClock-1.0.2</entry>
            <entry>(空)</entry>
            <entry>emiclock</entry>
            <entry>(空)</entry>
            <entry>1.0.2</entry>
            <entry>プログラム一つだけの時は小文字のみ</entry>
          </row>

          <row>
            <entry>rdist-1.3alpha</entry>
            <entry>(空)</entry>
            <entry>rdist</entry>
            <entry>(空)</entry>
            <entry>1.3.a</entry>
            <entry><literal>alpha</literal> のような文字列は使えない</entry>
          </row>

          <row>
            <entry>es-0.9-beta1</entry>
            <entry>(空)</entry>
            <entry>es</entry>
            <entry>(空)</entry>
            <entry>0.9.b1</entry>
            <entry><literal>alpha</literal> のような文字列は使えない</entry>
          </row>

          <row>
            <entry>mailman-2.0rc3</entry>
            <entry>(空)</entry>
            <entry>mailman</entry>
            <entry>(空)</entry>
            <entry>2.0.r3</entry>
            <entry><literal>rc</literal> のような文字列は使えない</entry>
          </row>

          <row>
            <entry>v3.3beta021.src</entry>
            <entry>(空)</entry>
            <entry>tiff</entry>
            <entry>(空)</entry>
            <entry>3.3</entry>
            <entry>なんなんでしょう ;)</entry>
          </row>

          <row>
            <entry>tvtwm</entry>
            <entry>(空)</entry>
            <entry>tvtwm</entry>
            <entry>(空)</entry>
            <entry>pl11</entry>
            <entry>バージョン番号は必ず必要</entry>
          </row>

          <row>
            <entry>piewm</entry>
            <entry>(空)</entry>
            <entry>piewm</entry>
            <entry>(空)</entry>
            <entry>1.0</entry>
            <entry>同上</entry>
          </row>

          <row>
            <entry>xvgr-2.10pl1</entry>
            <entry>(空)</entry>
            <entry>xvgr</entry>
            <entry>(空)</entry>
            <entry>2.10.1</entry>
            <entry><literal>pl</literal> が使えるのは,
              他にメジャー/マイナーバージョン番号がない場合のみ</entry>
          </row>

          <row>
            <entry>gawk-2.15.6</entry>
            <entry>ja-</entry>
            <entry>gawk</entry>
            <entry>(空)</entry>
            <entry>2.15.6</entry>
            <entry>日本語バージョン</entry>
          </row>

          <row>
            <entry>psutils-1.13</entry>
            <entry>(空)</entry>
            <entry>psutils</entry>
            <entry>-letter</entry>
            <entry>1.13</entry>
            <entry>コンパイル時に用紙のサイズを指定</entry>
          </row>

          <row>
            <entry>pkfonts</entry>
            <entry>(空)</entry>
            <entry>pkfonts</entry>
            <entry>300</entry>
            <entry>1.0</entry>
            <entry>300dpiフォント用の package</entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>

    <para>オリジナルのソースにまったくバージョン情報が見当たらず,
      また原作者が新しいバージョンをリリースする可能性が低いときには,
      バージョン番号として
      <literal>1.0</literal> を使えばいいでしょう
      (上記の piewm の例がこれにあたります).
      そうでない場合には原作者に聞くか, 日付
      (<literal><replaceable>yyyy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>)
      を使うなどしてください.</para>
  </chapter>

  <chapter id="porting-categories">
    <title>カテゴリ</title>

    <para>すでにご存知のように,
      ports はいくつかのカテゴリに分類されています.
      これを有効に利用するためには,
      port を作成する人々とユーザが,
      それぞれのカテゴリが何であるか,
      どのようにしてカテゴリに分類するかを理解する必要があります.</para>

    <sect1>
      <title>現在のカテゴリのリスト</title>

      <para>まず, これが現在の port のカテゴリのリストです.
        アスタリスク(<literal>*</literal>)
        が付いているものは仮想 (<emphasis>virtual</emphasis>)
        カテゴリです &mdash;
        これらには対応するサブディレクトリが port ツリーにはありません.</para>
      <!-- kuriyama - don't use " - - " as literal -->

      <note>
        <para>仮想カテゴリでないものは,
          そのサブディレクトリ内の
          <filename>pkg/COMMENT</filename>
          に一行の記述があります
          (例: <filename>archivers/pkg/COMMENT</filename>).</para>
      </note>

      <informaltable frame="none">
        <tgroup cols="2">
          <thead>
            <row>
              <entry>カテゴリ</entry>
              <entry>説明</entry>
            </row>
          </thead>

          <tbody>
            <row>
              <entry><filename>afterstep*</filename></entry>
              <entry>AfterStep ウィンドウマネージャをサポートする ports</entry>
            </row>

            <row>
              <entry><filename>archivers</filename></entry>
              <entry>アーカイブ用ツール</entry>
            </row>

            <row>
              <entry><filename>astro</filename></entry>
              <entry>天文学関連の ports</entry>
            </row>

            <row>
              <entry><filename>audio</filename></entry>
              <entry>サウンドをサポートする ports</entry>
            </row>

            <row>
              <entry><filename>benchmarks</filename></entry>
              <entry>ベンチマークユーティリティ</entry>
            </row>

            <row>
              <entry><filename>biology</filename></entry>
              <entry>生物学関連のソフトウェア</entry>
            </row>

            <row>
              <entry><filename>cad</filename></entry>
              <entry>CAD ツール</entry>
            </row>

            <row>
              <entry><filename>chinese</filename></entry>
              <entry>中国語サポート</entry>
            </row>

            <row>
              <entry><filename>comms</filename></entry>
              <entry>通信ソフトウェア. ほとんどはシリアルポート用です.</entry>
            </row>

            <row>
              <entry><filename>converters</filename></entry>
              <entry>文字コード変換</entry>
            </row>

            <row>
              <entry><filename>databases</filename></entry>
              <entry>データベース</entry>
            </row>

            <row>
              <entry><filename>deskutils</filename></entry>
              <entry>コンピュータが発明される以前に机上で使われていた道具
                (訳注: いわゆるデスクトップユーティリティのこと)</entry>
            </row>

            <row>
              <entry><filename>devel</filename></entry>
              <entry>開発ユーティリティ.
                どうしてもここに置かなければならない理由があるのでない限り,
                ライブラリをここに含めないでください.</entry>
            </row>

            <row>
              <entry><filename>editors</filename></entry>
              <entry>一般的なエディタ.
                特殊なエディタはそれぞれふさわしいセクションに入れます
                (たとえば数式エディタは <filename>math</filename> です).</entry>
            </row>

            <row>
              <entry><filename>elisp</filename></entry>
              <entry>Emacs-lisp の ports</entry>
            </row>

            <row>
              <entry><filename>emulators</filename></entry>
              <entry>他のオペレーティングシステムのエミュレータ.
                端末エミュレータはここに含まれません &mdash;
                X ベースのものは <filename>x11</filename> に,
                テキストベースのものは機能によって
                <filename>comms</filename> か
                <filename>misc</filename> に分類されます.</entry>
            </row>

            <row>
              <entry><filename>french</filename></entry>
              <entry>フランス語サポート</entry>
            </row>

            <row>
              <entry><filename>ftp</filename></entry>
              <entry>FTP クライアントとサーバユーティリティ.
                port が FTP と HTTP の両方をサポートしていれば,
                <filename>ftp</filename>
                に入れ, 第二カテゴリを
                <filename>www</filename> とします.</entry>
            </row>

            <row>
              <entry><filename>games</filename></entry>
              <entry>ゲーム</entry>
            </row>

            <row>
              <entry><filename>german</filename></entry>
              <entry>ドイツ語サポート</entry>
            </row>

            <row>
              <entry><filename>gnome*</filename></entry>
              <entry>GNU Object Model Environment (GNOME)
                プロジェクトの ports</entry>
            </row>

            <row>
              <entry><filename>graphics</filename></entry>
              <entry>グラフィックユーティリティ</entry>
            </row>

            <row>
              <entry><filename>hebrew</filename></entry>
              <entry>ヘブライ語サポート</entry>
            </row>

            <row>
              <entry><filename>irc</filename></entry>
              <entry>インターネットリレーチャット (IRC) 用ユーティリティ</entry>
            </row>

            <row>
              <entry><filename>ipv6*</filename></entry>
              <entry>IPv6 関連のソフトウェア</entry>
            </row>

            <row>
              <entry><filename>japanese</filename></entry>
              <entry>日本語サポート</entry>
            </row>

            <row>
              <entry><filename>java</filename></entry>
              <entry>Java 言語サポート</entry>
            </row>

            <row>
              <entry><filename>kde*</filename></entry>
              <entry>K Desktop Environment (kde) の ports</entry>
            </row>

            <row>
              <entry><filename>korean</filename></entry>
              <entry>韓国語サポート</entry>
            </row>

            <row>
              <entry><filename>lang</filename></entry>
              <entry>プログラミング言語</entry>
            </row>

            <row>
              <entry><filename>linux*</filename></entry>
              <entry>Linux アプリケーションとサポートユーティリティ</entry>
            </row>

            <row>
              <entry><filename>mail</filename></entry>
              <entry>メールソフトウェア</entry>
            </row>

            <row>
              <entry><filename>math</filename></entry>
              <entry>数値計算ソフトウェアやその他の数学ソフトウェア</entry>
            </row>

            <row>
              <entry><filename>mbone</filename></entry>
              <entry>MBone アプリケーション</entry>
            </row>

            <row>
              <entry><filename>misc</filename></entry>
              <entry>種々のユーティリティ
                &mdash;
                基本的に他のカテゴリに属さないものです.
                これは他の仮想でないカテゴリを伴わない, 唯一のカテゴリです.
                <literal>misc</literal> と他のカテゴリが
                <makevar>CATEGORIES</makevar> 行に書かれている場合,
                <literal>misc</literal>
                を削除して他のサブディレクトリにおいて良いという意味になります.</entry>
            </row>

            <row>
              <entry><filename>net</filename></entry>
              <entry>種々のネットワークソフトウェア</entry>
            </row>

            <row>
              <entry><filename>news</filename></entry>
              <entry>USENET ニュースソフトウェア</entry>
            </row>

            <row>
              <entry><filename>offix*</filename></entry>
              <entry>OffiX suite の ports</entry>
            </row>

            <row>
              <entry><filename>palm</filename></entry>
              <entry>3Com Palm(tm) シリーズをサポートするソフトウェア</entry>
            </row>

            <row>
              <entry><filename>perl5*</filename></entry>
              <entry>実行に perl バージョン 5 を必要とする ports</entry>
            </row>

            <row>
              <entry><filename>picobsd</filename></entry>
              <entry>PicoBSD をサポートするための ports</entry>
            </row>

            <row>
              <entry><filename>plan9*</filename></entry>
              <entry>Plan9 に由来するさまざまなソフトウェア</entry>
            </row>

            <row>
              <entry><filename>print</filename></entry>
              <entry>印刷ソフトウェア.
                DTP 用ツール (プレビュアなど) もここに分類されます.</entry>
            </row>

            <row>
              <entry><filename>python*</filename></entry>
              <entry>python 言語で書かれたソフトウェア</entry>
            </row>

            <row>
              <entry><filename>ruby*</filename></entry>
              <entry>ruby 言語で書かれたソフトウェア</entry>
            </row>

            <row>
              <entry><filename>russian</filename></entry>
              <entry>ロシア語サポート</entry>
            </row>

            <row>
              <entry><filename>science</filename></entry>
              <entry><filename>astro</filename> や
                <filename>biology</filename>,
                <filename>math</filename> 等, 他のカテゴリには
                あてはまらない科学関連の ports</entry>
            </row>

            <row>
              <entry><filename>security</filename></entry>
              <entry>セキュリティ関連のユーティリティ</entry>
            </row>

            <row>
              <entry><filename>shells</filename></entry>
              <entry>コマンドラインシェル</entry>
            </row>

            <row>
              <entry><filename>sysutils</filename></entry>
              <entry>システムユーティリティ</entry>
            </row>

            <row>
              <entry><filename>tcl75*</filename></entry>
              <entry>実行に Tcl バージョン 7.5 を必要とする ports</entry>
            </row>

            <row>
              <entry><filename>tcl76*</filename></entry>
              <entry>実行に Tcl バージョン 7.6 を必要とする ports</entry>
            </row>

            <row>
              <entry><filename>tcl80*</filename></entry>
              <entry>実行に Tcl バージョン 8.0 を必要とする ports</entry>
            </row>

            <row>
              <entry><filename>tcl81*</filename></entry>
              <entry>実行に Tcl バージョン 8.1 を必要とする ports</entry>
            </row>

            <row>
              <entry><filename>textproc</filename></entry>
              <entry>テキスト処理ユーティリティ.
                DTP ツールはここではなく, print/ に分類されます.</entry>
            </row>

            <row>
              <entry><filename>tk41*</filename></entry>
              <entry>実行に Tk バージョン 4.1 を必要とする ports</entry>
            </row>

            <row>
              <entry><filename>tk42*</filename></entry>
              <entry>実行に Tk バージョン 4.2 を必要とする ports</entry>
            </row>

            <row>
              <entry><filename>tk80*</filename></entry>
              <entry>実行に Tk バージョン 8.0 を必要とする ports</entry>
            </row>

            <row>
              <entry><filename>tk81*</filename></entry>
              <entry>実行に Tk バージョン 8.1 を必要とする ports</entry>
            </row>

            <row>
              <entry><filename>tkstep80*</filename></entry>
              <entry>実行に TkSTEP バージョン 8.0 を必要とする ports</entry>
            </row>

            <row>
              <entry><filename>ukrainian</filename></entry>
              <entry>ウクライナ語サポート</entry>
            </row>

            <row>
              <entry><filename>vietnamese</filename></entry>
              <entry>ベトナム語サポート</entry>
            </row>

            <row>
              <entry><filename>windowmaker*</filename></entry>
              <entry>WindowMaker ウィンドウマネージャをサポートする ports</entry>
            </row>

            <row>
              <entry><filename>www</filename></entry>
              <entry>World Wide Web 関連のソフトウェア.
                HTML 言語サポートもここに分類されます.</entry>
            </row>

            <row>
              <entry>x11</entry>
              <entry>X ウィンドウシステムとその関連ソフトウェア.
                このカテゴリは,
                直接ウィンドウシステムをサポートするソフトウェアのみを対象とするものです.
                通常の X アプリケーションをここに分類しないでください.
                あなたの port が X アプリケーションで,
                <makevar>USE_XLIB</makevar> が定義
                (<makevar>USE_IMAKE</makevar> を定義すると自動的に定義されます)
                されている場合は, 適切なカテゴリに分類してください.
                また, それらのほとんどは他の <filename>x11-*</filename>
                カテゴリ (下記参照) に分類されます.</entry>
            </row>

            <row>
              <entry><filename>x11-clocks</filename></entry>
              <entry>X11 用時計</entry>
            </row>

            <row>
              <entry><filename>x11-fm</filename></entry>
              <entry>X11 用ファイルマネージャ</entry>
            </row>

            <row>
              <entry><filename>x11-fonts</filename></entry>
              <entry>X11 フォントとフォントユーティリティ</entry>
            </row>

            <row>
              <entry><filename>x11-servers</filename></entry>
              <entry>X11 サーバ</entry>
            </row>

            <row>
              <entry><filename>x11-toolkits</filename></entry>
              <entry>X11 ツールキット</entry>
            </row>

            <row>
              <entry><filename>x11-wm</filename></entry>
              <entry>X11 ウィンドウマネージャ</entry>
            </row>

            <row>
              <entry><filename>zope*</filename></entry>
              <entry>Zope サポート</entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </sect1>

    <sect1>
      <title>適切なカテゴリの選択</title>

      <para>多くのカテゴリに重なるので,
        どれを<quote>第一</quote>カテゴリにするかを決めなければならないことがたびたびあるでしょう.
        これをうまく決めるルールがいくつかあります.
        以下はその優先順のリストで, 優先度の高いものから低いものの順に書いてあります.</para>

      <itemizedlist>
        <listitem>
          <para>言語特有のカテゴリがまず最初です.
            たとえば日本語の
            X11 のフォントをインストールする port の場合,
            <makevar>CATEGORIES</makevar> 行は
            <literal>japanese x11-fonts</literal>
            となるでしょう.</para>
        </listitem>

        <listitem>
          <para>より特徴的なカテゴリが,
            一般的なカテゴリより優先されます.
            たとえば, HTML エディタの場合は <literal>www editors</literal> となります.
            これを逆順にはしないでください.
            また,
            port が <literal>irc</literal>,
            <literal>mail</literal>,
            <literal>mbone</literal>,
            <literal>news</literal>,
            <literal>security</literal>,
            <literal>www</literal>
            のいずれかに属する場合には
            <literal>net</literal>
            は必要ありません.</para>
        </listitem>

        <listitem>
          <para><literal>x11</literal>
            を第二カテゴリにするのは第一カテゴリが自然言語の場合のみにしてください.
            特に X のアプリケーションには
            <literal>x11</literal>
            を指定<emphasis>しない</emphasis>でください.</para>
        </listitem>

        <listitem>
          <para>もし, あなたの port が他のどのカテゴリにも属しない場合には
            <literal>misc</literal> にしてください.</para>
        </listitem>
      </itemizedlist>

      <para>もし, あなたがカテゴリについて自信が持てない場合には,
        そのことを <command>send-pr</command> する時に書き加えてください.
        そうすれば import する前にそれについて議論できます
        (もしあなたがコミッターであれば,
        そのことを &a.ports; に送って先に議論するようにしてください
        &mdash; 新しい port が間違ったカテゴリに import
        されて, すぐ移動されることが多いので).</para>
    </sect1>
  </chapter>

  <chapter>
    <title>この文書と ports システムの変更</title>

    <para>もしあなたが, たくさんの ports の保守をしているのであれば,
      &a.ports; メーリングリストの内容を読むことを考えてください.
      ports のしくみについての重要な変更点はここに アナウンスされます.
      最新の変更点については, いつでも,
      <ulink url="http://www.FreeBSD.org/cgi/cvsweb.cgi/ports/Mk/bsd.port.mk">bsd.port.mk
        の CVS ログ</ulink>で詳細な情報を得ることができます.</para>
  </chapter>

  <chapter>
    <title>やっとおしまい!</title>

    <para>いやはや, 長い文章ですみません.
      ここまで読んでくださった方には感謝, 感謝でございます.
      さあ, port の作り方がわかったところで世界中のソフトウェアを
      port 化しましょう.
      FreeBSD プロジェクトに貢献するには,
      それが最も簡単な方法です!
      <!-- smiley --><emphasis>:-)</emphasis></para>
  </chapter>
</book>

<!--
     Local Variables:
     mode: sgml
     sgml-indent-data: t
     sgml-omittag: nil
     sgml-always-quote-attributes: t
     End:
-->
