[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Documentation/pkgsrc/debug/chapter.xml: 1.1 -> 1.3



以下のページの更新をしました。ツッコミをお願いします。

Documentation/pkgsrc/debug/chapter.xml: 1.1 -> 1.3

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

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

--- Documentation/pkgsrc/debug/chapter.xml.orig	Thu Feb 16 01:21:25 2006
+++ Documentation/pkgsrc/debug/chapter.xml	Thu Feb 16 01:21:25 2006
@@ -1,6 +1,6 @@
-<!-- $NetBSD: chapter.xml,v 1.1 2003/04/07 15:39:41 grant Exp $ -->
+<!-- $NetBSD: chapter.xml,v 1.3 2003/06/23 07:03:04 grant Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: chapter.xml,v 1.1 2003/04/07 15:39:41 grant Exp   -->
+<!-- NetBSD: chapter.xml,v 1.3 2003/06/23 07:03:04 grant Exp   -->
 
 <chapter id="debug"> <?dbhtml filename="debug.html"?>
 <title>デバッグ</title>
@@ -22,30 +22,30 @@
 <pkg>pkgtools/url2pkg</pkg> をインストールして、以下を実行します
 </para>
 
-<programlisting># url2pkg http://www.example.com/path/to/distfile.tar.gz</programlisting>
+<screen><prompt>#</prompt> <userinput>url2pkg http://www.example.com/path/to/distfile.tar.gz</userinput></screen>
 </listitem>
 
 <listitem>
 <para>
-Makefileに、必要な編集を加えます。
+<filename>Makefile</filename>に、必要な編集を加えます。
 </para>
 </listitem>
 
 <listitem>
-<para>DESCRの内容を書きます
+<para><filename>DESCR</filename>の内容を書きます
 </para>
 </listitem>
 
 <listitem>
 <para>
-<command>make configure</command>
+<command>make configure</command> を実行します。
 </para>
 </listitem>
 
 <listitem>
 <para>
-configureの段階でわかった依存関係をすべて、パッケージのMakefileに書き加
-えます。
+configureの段階でわかった依存関係をすべて、
+パッケージの<filename>Makefile</filename>に書き加えます。
 </para>
 </listitem>
 
@@ -54,13 +54,13 @@
 以下を繰り返しおこなって、パッケージを作り上げます
 </para>
 
-<programlisting># make
-# pkgvi ${WRKSRC}/some/file/that/does/not/compile
-# mkpatches
-# patchdiff
-# mv ${WRKDIR}/.newpatches/* patches
-# make mps
-# make clean</programlisting>
+<screen><prompt>#</prompt> <userinput>make</userinput>
+<prompt>#</prompt> <userinput>pkgvi ${WRKSRC}/some/file/that/does/not/compile</userinput>
+<prompt>#</prompt> <userinput>mkpatches</userinput>
+<prompt>#</prompt> <userinput>patchdiff</userinput>
+<prompt>#</prompt> <userinput>mv ${WRKDIR}/.newpatches/* patches</userinput>
+<prompt>#</prompt> <userinput>make mps</userinput>
+<prompt>#</prompt> <userinput>make clean</userinput></screen>
 
 <para>
 root以外のユーザーで作業をおこなうと、改変すべきでないファイルは改変され
@@ -69,41 +69,42 @@
 </listitem>
 <listitem>
 <para>
-必要ならMakefileを修正してください。セクション4.1を参考にしてください。 XXX
+必要なら<filename>Makefile</filename>を修正してください。<xref
+linkend="components.Makefile"/>を参考にしてください。
 </para>
 </listitem>
 
 <listitem>
 <para>
-PLISTを作成します:
+<filename>PLIST</filename>を作成します:
 </para>
 
-<programlisting># make install
-# make print-PLIST > PLIST
-# make deinstall
-# make install
-# make deinstall</programlisting>
+<screen><prompt>#</prompt> <userinput>make install</userinput>
+<prompt>#</prompt> <userinput>make print-PLIST &gt; PLIST</userinput>
+<prompt>#</prompt> <userinput>make deinstall</userinput>
+<prompt>#</prompt> <userinput>make install</userinput>
+<prompt>#</prompt> <userinput>make deinstall</userinput></screen>
 
 <para>
 これは通常、rootで実行する必要があります。
 残ったままのファイルがないか調べます:
 </para>
 
-<programlisting># make print-PLIST</programlisting>
+<screen><prompt>#</prompt> <userinput>make print-PLIST</userinput></screen>
 
 <para>
-もし、なにかファイルが見つかれば、それらはPLISTに不足しているので、追加
+もし、なにかファイルが見つかれば、それらは<filename>PLIST</filename>に不足しているので、追加
 してください。
 </para>
 </listitem>
 
 <listitem>
 <para>
-これでPLISTの修正ができました。パッケージを再度インストールして、バイナ
+これで<filename>PLIST</filename>の修正ができました。パッケージを再度インストールして、バイナ
 リーパッケージを作ります:
 </para>
 
-<programlisting># make reinstall &amp;&amp; make package</programlisting>
+<screen><prompt>#</prompt> <userinput>make reinstall &amp;&amp; make package</userinput></screen>
 </listitem>
 
 <listitem>
@@ -111,7 +112,7 @@
 インストールしたパッケージを削除します:
 </para>
  
-<programlisting># pkg_delete blub</programlisting>
+<screen><prompt>#</prompt> <userinput>pkg_delete blub</userinput></screen>
 </listitem>
 
 <listitem>
@@ -119,7 +120,7 @@
 上記のfindコマンドを繰り返します。今度は何も見つからないはずです:
 </para>
 
-<programlisting># make print-PLIST</programlisting>
+<screen><prompt>#</prompt> <userinput>make print-PLIST</userinput></screen>
 
 </listitem>
 <listitem>
@@ -127,7 +128,7 @@
 バイナリーパッケージを再インストールします:
 </para>
  
-<programlisting># pkg_add .../blub.tgz</programlisting>
+<screen><prompt>#</prompt> <userinput>pkgadd .../blub.tgz</userinput></screen>
 </listitem>
 
 <listitem>
@@ -142,13 +143,13 @@
 てください。
 </para>
 
-<programlisting># pkglint</programlisting>
+<screen><prompt>#</prompt> <userinput>pkglint</userinput></screen>
 </listitem>
 
 <listitem>
 <para>
-提出してください(もし cvs アクセス可能であればコミットしてください)。
-セクション 11 が参考になります。XXX
+提出してください(もし cvs アクセス可能であればコミットしてください)。<xref
+linkend="submit"/>が参考になります。
 </para>
 </listitem>
 </itemizedlist>
Index: Documentation/pkgsrc/debug/chapter.xml
===================================================================
RCS file: /cvsroot/htdocs/Documentation/pkgsrc/debug/Attic/chapter.xml,v
retrieving revision 1.1
retrieving revision 1.3
diff -u -r1.1 -r1.3
--- Documentation/pkgsrc/debug/chapter.xml	7 Apr 2003 15:39:41 -0000	1.1
+++ Documentation/pkgsrc/debug/chapter.xml	23 Jun 2003 07:03:04 -0000	1.3
@@ -1,4 +1,4 @@
-<!-- $NetBSD: chapter.xml,v 1.1 2003/04/07 15:39:41 grant Exp $ -->
+<!-- $NetBSD: chapter.xml,v 1.3 2003/06/23 07:03:04 grant Exp $ -->
 
 <chapter id="debug"> <?dbhtml filename="debug.html"?>
 <title>Debugging</title>
@@ -21,30 +21,30 @@
 Install <pkg>pkgtools/url2pkg</pkg> and run
 </para>
 
-<programlisting># url2pkg http://www.example.com/path/to/distfile.tar.gz</programlisting>
+<screen><prompt>#</prompt> <userinput>url2pkg http://www.example.com/path/to/distfile.tar.gz</userinput></screen>
 </listitem>
 
 <listitem>
 <para>
-Edit the Makefile as requested.
+Edit the <filename>Makefile</filename> as requested.
 </para>
 </listitem>
 
 <listitem>
-<para>Fill in DESCR
+<para>Fill in <filename>DESCR</filename>
 </para>
 </listitem>
 
 <listitem>
 <para>
-<command>make configure</command>
+Run <command>make configure</command>
 </para>
 </listitem>
 
 <listitem>
 <para>
 Add any dependencies glimpsed from the configure step to the
-package's Makefile.
+package's <filename>Makefile</filename>.
 </para>
 </listitem>
 
@@ -53,54 +53,56 @@
 Make the package compile, doing multiple rounds of
 </para>
 
-<programlisting># make
-# pkgvi ${WRKSRC}/some/file/that/does/not/compile
-# mkpatches
-# patchdiff
-# mv ${WRKDIR}/.newpatches/* patches
-# make mps
-# make clean</programlisting>
+<screen><prompt>#</prompt> <userinput>make</userinput>
+<prompt>#</prompt> <userinput>pkgvi ${WRKSRC}/some/file/that/does/not/compile</userinput>
+<prompt>#</prompt> <userinput>mkpatches</userinput>
+<prompt>#</prompt> <userinput>patchdiff</userinput>
+<prompt>#</prompt> <userinput>mv ${WRKDIR}/.newpatches/* patches</userinput>
+<prompt>#</prompt> <userinput>make mps</userinput>
+<prompt>#</prompt> <userinput>make clean</userinput></screen>
 
 <para>
-Doing as non-root user will assure that no files are modified that
-shouldn't, esp. not during the build phase.
+Doing as non-root user will ensure that no files are modified that
+shouldn't be, especially during the build phase.
 </para>
 </listitem>
 <listitem>
 <para>
-Look at Makefile, fix if necessary; see section 4.1. XXX
+Look at <filename>Makefile</filename>, fix if necessary; see <xref
+linkend="components.Makefile"/>.
 </para>
 </listitem>
 
 <listitem>
 <para>
-Generate a PLIST:
+Generate a <filename>PLIST</filename>:
 </para>
 
-<programlisting># make install
-# make print-PLIST > PLIST
-# make deinstall
-# make install
-# make deinstall</programlisting>
+<screen><prompt>#</prompt> <userinput>make install</userinput>
+<prompt>#</prompt> <userinput>make print-PLIST &gt; PLIST</userinput>
+<prompt>#</prompt> <userinput>make deinstall</userinput>
+<prompt>#</prompt> <userinput>make install</userinput>
+<prompt>#</prompt> <userinput>make deinstall</userinput></screen>
 
 <para>
 You usually need to be root to do this. Look if there are any files left:
 </para>
 
-<programlisting># make print-PLIST</programlisting>
+<screen><prompt>#</prompt> <userinput>make print-PLIST</userinput></screen>
 
 <para>
-If this brings up any files that are missing in PLIST, add them.
+If this reveals any files that are missing in
+<filename>PLIST</filename>, add them.
 </para>
 </listitem>
 
 <listitem>
 <para>
-Now that the PLIST is ok, install the package again and
-make a binary package:
+Now that the <filename>PLIST</filename> is OK, install the package again
+and make a binary package:
 </para>
 
-<programlisting># make reinstall &amp;&amp; make package</programlisting>
+<screen><prompt>#</prompt> <userinput>make reinstall &amp;&amp; make package</userinput></screen>
 </listitem>
 
 <listitem>
@@ -108,7 +110,7 @@
 Delete the installed package:
 </para>
  
-<programlisting># pkg_delete blub</programlisting>
+<screen><prompt>#</prompt> <userinput>pkg_delete blub</userinput></screen>
 </listitem>
 
 <listitem>
@@ -116,7 +118,7 @@
 Repeat the above find command, which shouldn't find anything now:
 </para>
 
-<programlisting># make print-PLIST</programlisting>
+<screen><prompt>#</prompt> <userinput>make print-PLIST</userinput></screen>
 
 </listitem>
 <listitem>
@@ -124,7 +126,7 @@
 Reinstall the binary package:
 </para>
  
-<programlisting># pkg_add .../blub.tgz</programlisting>
+<screen><prompt>#</prompt> <userinput>pkgadd .../blub.tgz</userinput></screen>
 </listitem>
 
 <listitem>
@@ -139,12 +141,13 @@
 problems it reports.
 </para>
 
-<programlisting># pkglint</programlisting>
+<screen><prompt>#</prompt> <userinput>pkglint</userinput></screen>
 </listitem>
 
 <listitem>
 <para>
-Submit (or commit, if you have cvs access); see section 11.XXX
+Submit (or commit, if you have cvs access); see <xref
+linkend="submit"/>.
 </para>
 </listitem>
 </itemizedlist>