[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Documentation/pkgsrc/examples/chapter.xml: 1.2 -> 1.5

Subject: Documentation/pkgsrc/examples/chapter.xml: 1.2 -> 1.5
From: kano@na.rim.or.jp (OKANO Takayoshi)
To: www-changes-ja@jp.NetBSD.org
Date: Thu, 16 Feb 2006 23:13:48 +0900 (JST)
Message-Id: <200602161413.XAA65631@shell.rim.or.jp>
Delivered-To: mailing list www-changes-ja@jp.netbsd.org
Mailing-List: contact www-changes-ja-help@jp.netbsd.org; run by ezmlm-idx
以下のページの更新をしました。ツッコミをお願いします。

Documentation/pkgsrc/examples/chapter.xml: 1.2 -> 1.5

金曜日までに異議がなければ、 commit します。

以下、訳と原文の差分です。

ほとんどはマークアップと例示の修正ですが、
以下の点が変わっています。

-   The NetBSD package system comes with a tool called "pkglint" (located in the
    directory "pkgsrc/pkgtools/pkglint") which helps to check ～
  が
    The NetBSD package system comes with <pkg>pkgtools/pkglint</pkg>
    which helps to check ～
  になった。訳は
    NetBSDパッケージシステムは、「pkglint」(pkgsrc/pkgtools/pkglintディレクトリー
    にあります)とよばれるツールを含んでいます。このツールは～
  を
    NetBSDパッケージシステムは、<pkg>pkgtools/pkglint</pkg>を含んでいます。
    このツールは～
  にした。

- see "man pkglint" が see pkglint(1) になった。

- コメントアウトされていた他の節への参照が xref を使い復活した


--- Documentation/pkgsrc/examples/chapter.xml.orig	Thu Feb 16 23:09:10 2006
+++ Documentation/pkgsrc/examples/chapter.xml	Thu Feb 16 23:09:10 2006
@@ -1,12 +1,13 @@
-<!-- $NetBSD: chapter.xml,v 1.2 2003/05/24 04:24:40 grant Exp $ -->
+<!-- $NetBSD: chapter.xml,v 1.5 2003/06/23 09:13:31 grant Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: chapter.xml,v 1.2 2003/05/24 04:24:40 grant Exp   -->
+<!-- NetBSD: chapter.xml,v 1.5 2003/06/23 09:13:31 grant Exp   -->
 
-<chapter id="examples"> <?dbhtml filename="examples.html"?>
+<appendix id="examples"> <?dbhtml filename="examples.html"?>
 <title>パッケージの簡単な例: bison</title>
 <para>
 私は、パッケージコレクションにないソフトウェアをさがし、GNU bisonを選びまし
-た。バークレーのyaccがすでにソースツリーに存在するので、bisonを使いたい人は
+た。バークレーの<command>yacc</command>がすでにソースツリーに存在するので、
+<command>bison</command>を使いたい人は
 いないでしょう。しかし、練習という意味では役にたちます。
 </para>
 
@@ -15,7 +16,7 @@
 
 <sect2>
 <title>Makefile</title>
-<programlisting># &lt;$&gt;NetBSD&lt;$&gt;
+<programlisting># &#36;NetBSD&#36;
 #
 
 DISTNAME=	bison-1.25
@@ -29,7 +30,6 @@
 GNU_CONFIGURE=	yes
 INFO_FILES=	bison.info
  
-.include "../../mk/texinfo.mk"
 .include "../../mk/bsd.pkg.mk"</programlisting>
 </sect2>
 
@@ -42,17 +42,15 @@
 
 <sect2>
 <title>PLIST</title>
-<screen>@comment &lt;$&gt;NetBSD&lt;$&gt;
+<screen>@comment &#36;NetBSD&#36;
 bin/bison
 man/man1/bison.1.gz
-@unexec install-info --delete %D/info/bison.info %D/info/dir
 info/bison.info
 info/bison.info-1
 info/bison.info-2
 info/bison.info-3
 info/bison.info-4
 info/bison.info-5
-@exec install-info %D/info/bison.info %D/info/dir
 share/bison.simple
 share/bison.hairy</screen>
 </sect2>
@@ -60,14 +58,14 @@
 <sect2>
 <title><command>pkglint</command> でパッケージをチェックする</title>
 <para>
-NetBSDパッケージシステムは、「pkglint」(pkgsrc/pkgtools/pkglintディレクトリー
-にあります)とよばれるツールを含んでいます。このツールはこれらのファイルの内
+NetBSDパッケージシステムは、<pkg>pkgtools/pkglint</pkg>
+を含んでいます。このツールはこれらのファイルの内
 容をチェックするのを助けてくれます。一度インストールしてしまえば、このツー
 ルは非常に簡単に使うことができます。検査したいパッケージのディレクトリーに
 移動し、<command>pkglint</command>を実行するだけです。
 </para>
 
-<screen>% pkglint
+<screen><prompt>%</prompt> <userinput>pkglint</userinput>
 OK: checking ./DESCR.
 OK: checking Makefile.
 OK: checking distinfo.
@@ -75,8 +73,8 @@
 looks fine.</screen>
 
 <para>
-指定されたコマンド行の引数(「man pkglint」を見てください)によっては、より冗
-長なチェックがおこなわれます。例えば「pkglint -v」は、大変詳細かつ冗長なチェッ
+指定されたコマンド行の引数(pkglint(1)を見てください)によっては、より冗
+長なチェックがおこなわれます。例えば<command>pkglint -v</command>は、大変詳細かつ冗長なチェッ
 クをおこないます。
 </para>
 </sect2>
@@ -89,17 +87,18 @@
 ます。
 </para>
 
-<screen># cd /usr/pkgsrc/lang
-# mkdir bison
-# cd bison
-# mkdir patches</screen>
+<screen><prompt>#</prompt> <userinput>cd /usr/pkgsrc/lang</userinput>
+<prompt>#</prompt> <userinput>mkdir bison</userinput>
+<prompt>#</prompt> <userinput>cd bison</userinput>
+<prompt>#</prompt> <userinput>mkdir patches</userinput></screen>
 
 <para>
-<!-- XXX セクション11.1のように --><filename>Makefile</filename>、<filename>DESCR</filename>および<filename>PLIST</filename>を作り、distfile を取得しま
+<filename>Makefile</filename>、<filename>DESCR</filename>および<filename>PLIST</filename>を作り
+(<xref linkend="components"/>参照)、distfile を取得しま
 す。
 </para>
 
-<screen># make fetch
+<screen><prompt>#</prompt> <userinput>make fetch</userinput>
 >> bison-1.25.tar.gz doesn't seem to exist on this system.
 >> Attempting to fetch from ftp://prep.ai.mit.edu/pub/gnu//.
 Requesting ftp://prep.ai.mit.edu/pub/gnu//bison-1.25.tar.gz (via ftp://orpheus.amdahl.com:80/)
@@ -117,13 +116,13 @@
 distfileのチェックサムを<filename>distinfo</filename>へ作成します。
 </para>
 
-<screen># make makesum</screen>
+<screen><prompt>#</prompt> <userinput>make makesum</userinput></screen>
 
 <para>
 コンパイルします。
 </para>
 
-<screen><![CDATA[# make
+<screen><prompt>#</prompt> <userinput>make</userinput>
 >> Checksum OK for bison-1.25.tar.gz.
 ===>  Extracting for bison-1.25
 ===>  Patching for bison-1.25
@@ -173,14 +172,13 @@
 cc  -g -o bison LR0.o allocate.o closure.o conflicts.o derives.o files.o         getargs.o gram.o lalr.o lex.o                                   main.o nullable.o output.o print.o reader.o reduce.o symtab.o   warshall.o version.o getopt.o getopt1.o
 ./files.c:240: warning: mktemp() possibly used unsafely, consider using mkstemp()
 rm -f bison.s1
-sed -e "/^#line/ s|bison|/usr/pkg/share/bison|" < ./bison.simple > bison.s1
-]]></screen>
+sed -e "/^#line/ s|bison|/usr/pkg/share/bison|" &lt; ./bison.simple &gt; bison.s1</screen>
 
 <para>
 すべてOKのようなので、ファイルをインストールします。
 </para>
 
-<screen><![CDATA[# make install
+<screen><prompt>#</prompt> <userinput>make install</userinput>
 >> Checksum OK for bison-1.25.tar.gz.
 ===>  Installing for bison-1.25
 sh ./mkinstalldirs /usr/pkg/bin /usr/pkg/share  /usr/pkg/info /usr/pkg/man/man1
@@ -192,7 +190,7 @@
 /usr/bin/install -c -o bin -g bin -m 644 ./bison.hairy /usr/pkg/share/bison.hairy
 cd .; for f in bison.info*;  do /usr/bin/install -c -o bin -g bin -m 644 $f /usr/pkg/info/$f; done
 /usr/bin/install -c -o bin -g bin -m 644 ./bison.1 /usr/pkg/man/man1/bison.1
-===>  Registering installation for bison-1.25]]></screen>
+===>  Registering installation for bison-1.25</screen>
 
 <para>
 これでbisonを使用することができます。そして、<command>pkg_delete bison</command>を実
@@ -200,19 +198,19 @@
 しければ、以下のようにしてください。
 </para>
 
-<screen><![CDATA[# make package
+<screen><prompt>#</prompt> <userinput>make package</userinput>
 >> Checksum OK for bison-1.25.tar.gz.
 ===>  Building package for bison-1.25
 Creating package bison-1.25.tgz
 Registering depends:.
-Creating gzip'd tar ball in '/u/pkgsrc/lang/bison/bison-1.25.tgz']]></screen>
+Creating gzip'd tar ball in '/u/pkgsrc/lang/bison/bison-1.25.tgz'</screen>
 
 <para>
 もし、ソースやオブジェクトファイルが必要ないのであれば、掃除してください。
 </para>
 
-<screen><![CDATA[# make clean
-===>  Cleaning for bison-1.25]]></screen>
+<screen><prompt>#</prompt> <userinput>make clean</userinput>
+===>  Cleaning for bison-1.25</screen>
 </sect1>
 
-</chapter>
+</appendix>
Index: Documentation/pkgsrc/examples/chapter.xml
===================================================================
RCS file: /cvsroot/htdocs/Documentation/pkgsrc/examples/Attic/chapter.xml,v
retrieving revision 1.2
retrieving revision 1.5
diff -u -r1.2 -r1.5
--- Documentation/pkgsrc/examples/chapter.xml	24 May 2003 04:24:40 -0000	1.2
+++ Documentation/pkgsrc/examples/chapter.xml	23 Jun 2003 09:13:31 -0000	1.5
@@ -1,12 +1,13 @@
-<!-- $NetBSD: chapter.xml,v 1.2 2003/05/24 04:24:40 grant Exp $ -->
+<!-- $NetBSD: chapter.xml,v 1.5 2003/06/23 09:13:31 grant Exp $ -->
 
-<chapter id="examples"> <?dbhtml filename="examples.html"?>
+<appendix id="examples"> <?dbhtml filename="examples.html"?>
 <title>A simple example of a package: bison</title>
 <para>
 I checked to find a piece of software that wasn't in the packages
 collection, and picked GNU bison. Quite why someone would want to have
-bison when Berkeley yacc is already present in the tree is beyond me, but
-it's useful for the purposes of this exercise.
+<command>bison</command> when Berkeley <command>yacc</command> is already
+present in the tree is beyond me, but it's useful for the purposes of
+this exercise.
 </para>
 
 <sect1>
@@ -14,7 +15,7 @@
 
 <sect2>
 <title>Makefile</title>
-<programlisting># &lt;$&gt;NetBSD&lt;$&gt;
+<programlisting># &#36;NetBSD&#36;
 #
 
 DISTNAME=	bison-1.25
@@ -28,7 +29,6 @@
 GNU_CONFIGURE=	yes
 INFO_FILES=	bison.info
  
-.include "../../mk/texinfo.mk"
 .include "../../mk/bsd.pkg.mk"</programlisting>
 </sect2>
 
@@ -41,17 +41,15 @@
 
 <sect2>
 <title>PLIST</title>
-<screen>@comment &lt;$&gt;NetBSD&lt;$&gt;
+<screen>@comment &#36;NetBSD&#36;
 bin/bison
 man/man1/bison.1.gz
-@unexec install-info --delete %D/info/bison.info %D/info/dir
 info/bison.info
 info/bison.info-1
 info/bison.info-2
 info/bison.info-3
 info/bison.info-4
 info/bison.info-5
-@exec install-info %D/info/bison.info %D/info/dir
 share/bison.simple
 share/bison.hairy</screen>
 </sect2>
@@ -59,14 +57,14 @@
 <sect2>
 <title>Checking a package with <command>pkglint</command></title>
 <para>
-The NetBSD package system comes with a tool called "pkglint" (located in the
-directory "pkgsrc/pkgtools/pkglint") which helps to check the contents of these
+The NetBSD package system comes with <pkg>pkgtools/pkglint</pkg>
+which helps to check the contents of these
 files. After installation it is quite easy to use, just change to the
 directory of the package you wish to examine and execute
 <command>pkglint</command>:
 </para>
 
-<screen>% pkglint
+<screen><prompt>%</prompt> <userinput>pkglint</userinput>
 OK: checking ./DESCR.
 OK: checking Makefile.
 OK: checking distinfo.
@@ -74,9 +72,9 @@
 looks fine.</screen>
 
 <para>
-Depending on the supplied command line arguments (see "man pkglint") more
-verbose checks will be performed. Use e.g. "pkglint -v" for a very verbose
-check.
+Depending on the supplied command line arguments (see pkglint(1)) more
+verbose checks will be performed. Use e.g. <command>pkglint
+-v</command> for a very verbose check.
 </para>
 </sect2>
 </sect1>
@@ -87,18 +85,18 @@
 Create the directory where the package lives, plus any auxiliary directories:
 </para>
 
-<screen># cd /usr/pkgsrc/lang
-# mkdir bison
-# cd bison
-# mkdir patches</screen>
+<screen><prompt>#</prompt> <userinput>cd /usr/pkgsrc/lang</userinput>
+<prompt>#</prompt> <userinput>mkdir bison</userinput>
+<prompt>#</prompt> <userinput>cd bison</userinput>
+<prompt>#</prompt> <userinput>mkdir patches</userinput></screen>
 
 <para>
 Create <filename>Makefile</filename>, <filename>DESCR</filename> and
-<filename>PLIST</filename> <!-- XXX as in section 11.1, -->
+<filename>PLIST</filename> (see <xref linkend="components"/>)
 then continue with fetching the distfile:
 </para>
 
-<screen># make fetch
+<screen><prompt>#</prompt> <userinput>make fetch</userinput>
 >> bison-1.25.tar.gz doesn't seem to exist on this system.
 >> Attempting to fetch from ftp://prep.ai.mit.edu/pub/gnu//.
 Requesting ftp://prep.ai.mit.edu/pub/gnu//bison-1.25.tar.gz (via ftp://orpheus.amdahl.com:80/)
@@ -116,13 +114,13 @@
 Generate the checksum of the distfile into <filename>distinfo</filename>:
 </para>
 
-<screen># make makesum</screen>
+<screen><prompt>#</prompt> <userinput>make makesum</userinput></screen>
 
 <para>
 Now compile:
 </para>
 
-<screen><![CDATA[# make
+<screen><prompt>#</prompt> <userinput>make</userinput>
 >> Checksum OK for bison-1.25.tar.gz.
 ===>  Extracting for bison-1.25
 ===>  Patching for bison-1.25
@@ -172,14 +170,13 @@
 cc  -g -o bison LR0.o allocate.o closure.o conflicts.o derives.o files.o         getargs.o gram.o lalr.o lex.o                                   main.o nullable.o output.o print.o reader.o reduce.o symtab.o   warshall.o version.o getopt.o getopt1.o
 ./files.c:240: warning: mktemp() possibly used unsafely, consider using mkstemp()
 rm -f bison.s1
-sed -e "/^#line/ s|bison|/usr/pkg/share/bison|" < ./bison.simple > bison.s1
-]]></screen>
+sed -e "/^#line/ s|bison|/usr/pkg/share/bison|" &lt; ./bison.simple &gt; bison.s1</screen>
 
 <para>
 Everything seems OK, so install the files:
 </para>
 
-<screen><![CDATA[# make install
+<screen><prompt>#</prompt> <userinput>make install</userinput>
 >> Checksum OK for bison-1.25.tar.gz.
 ===>  Installing for bison-1.25
 sh ./mkinstalldirs /usr/pkg/bin /usr/pkg/share  /usr/pkg/info /usr/pkg/man/man1
@@ -191,7 +188,7 @@
 /usr/bin/install -c -o bin -g bin -m 644 ./bison.hairy /usr/pkg/share/bison.hairy
 cd .; for f in bison.info*;  do /usr/bin/install -c -o bin -g bin -m 644 $f /usr/pkg/info/$f; done
 /usr/bin/install -c -o bin -g bin -m 644 ./bison.1 /usr/pkg/man/man1/bison.1
-===>  Registering installation for bison-1.25]]></screen>
+===>  Registering installation for bison-1.25</screen>
 
 <para>
 You can now use bison, and also - if you decide so - remove it with
@@ -199,19 +196,19 @@
 binary package, do this now:
 </para>
 
-<screen><![CDATA[# make package
+<screen><prompt>#</prompt> <userinput>make package</userinput>
 >> Checksum OK for bison-1.25.tar.gz.
 ===>  Building package for bison-1.25
 Creating package bison-1.25.tgz
 Registering depends:.
-Creating gzip'd tar ball in '/u/pkgsrc/lang/bison/bison-1.25.tgz']]></screen>
+Creating gzip'd tar ball in '/u/pkgsrc/lang/bison/bison-1.25.tgz'</screen>
 
 <para>
 Now that you don't need the source and object files any more, clean up:
 </para>
 
-<screen><![CDATA[# make clean
-===>  Cleaning for bison-1.25]]></screen>
+<screen><prompt>#</prompt> <userinput>make clean</userinput>
+===>  Cleaning for bison-1.25</screen>
 </sect1>
 
-</chapter>
+</appendix>
Prev by Date: Ports/i386/news.html: 1.109 -> 1.110
Next by Date: Ports/sgimips/news.html: 1.28 -> 1.29
Prev by thread: Ports/i386/news.html: 1.109 -> 1.110
Next by thread: Ports/sgimips/news.html: 1.28 -> 1.29
Index(es):
- Date
- Thread