Clean up debian/rules by using dh (with compat level 8).

[developers-reference.git] / tools.dbk

diff --git a/tools.dbk b/tools.dbk
index 7f356d361536a677d9c5362713494052567f5b0f..70514dc867d433567dc8e82ed55d6dcf98c225bf 100644 (file)
--- a/tools.dbk
+++ b/tools.dbk
@@ -26,7 +26,7 @@ exclusion of a competing tool.
 Most of the descriptions of these packages come from the actual package
 descriptions themselves.  Further information can be found in the package
 documentation itself.  You can also see more info with the command
 Most of the descriptions of these packages come from the actual package
 descriptions themselves.  Further information can be found in the package
 documentation itself.  You can also see more info with the command

-<command>apt-cache show &lt;package-name&gt;</command>.
+<command>apt-cache show <replaceable>package-name</replaceable></command>.

 </para>
 <section id="tools-core">
 <title>Core tools</title>
 </para>
 <section id="tools-core">
 <title>Core tools</title>


@@ -58,7 +58,7 @@ role="package">debconf-doc</systemitem> package.
 </para>
 <para>
 Many feel that this system should be used for all packages which require
 </para>
 <para>
 Many feel that this system should be used for all packages which require

-interactive configuration; see <xref linkend="bpp-config-mgmt"/> .  <systemitem
+interactive configuration; see <xref linkend="bpp-config-mgmt"/>.  <systemitem

 role="package">debconf</systemitem> is not currently required by Debian Policy,
 but that may change in the future.
 </para>
 role="package">debconf</systemitem> is not currently required by Debian Policy,
 but that may change in the future.
 </para>


@@ -113,10 +113,10 @@ latest <command>lintian</command> output for the whole development distribution
 </section>
 
 <section id="debdiff">
 </section>
 
 <section id="debdiff">

-<title><systemitem role="package">debdiff</systemitem></title>
+<title><command>debdiff</command></title>

 <para>
 <command>debdiff</command> (from the <systemitem
 <para>
 <command>debdiff</command> (from the <systemitem

-role="package">devscripts</systemitem> package, <xref linkend="devscripts"/> )
+role="package">devscripts</systemitem> package, <xref linkend="devscripts"/>)

 compares file lists and control files of two packages.  It is a simple
 regression test, as it will help you notice if the number of binary packages
 has changed since the last upload, or if something has changed in the control
 compares file lists and control files of two packages.  It is a simple
 regression test, as it will help you notice if the number of binary packages
 has changed since the last upload, or if something has changed in the control


@@ -182,7 +182,7 @@ The <systemitem role="package">dh-make</systemitem> package contains
 <command>dh_make</command>, a program that creates a skeleton of files
 necessary to build a Debian package out of a source tree.  As the name
 suggests, <command>dh_make</command> is a rewrite of <systemitem
 <command>dh_make</command>, a program that creates a skeleton of files
 necessary to build a Debian package out of a source tree.  As the name
 suggests, <command>dh_make</command> is a rewrite of <systemitem

-role="package">debmake</systemitem> and its template files use dh_* programs
+role="package">debmake</systemitem> and its template files use <command>dh_*</command> programs

 from <systemitem role="package">debhelper</systemitem>.
 </para>
 <para>
 from <systemitem role="package">debhelper</systemitem>.
 </para>
 <para>


@@ -193,24 +193,6 @@ the package entirely functional and Policy-compliant.
 </para>
 </section>
 
 </para>
 </section>
 

-<section id="yada">
-<title><systemitem role="package">yada</systemitem></title>
-<para>
-<systemitem role="package">yada</systemitem> is another packaging helper tool.
-It uses a <filename>debian/packages</filename> file to auto-generate
-<filename>debian/rules</filename> and other necessary files in the
-<filename>debian/</filename> subdirectory.  The
-<filename>debian/packages</filename> file contains instruction to build
-packages and there is no need to create any <filename>Makefile</filename>
-files.  There is possibility to use macro engine similar to the one used in
-SPECS files from RPM source packages.
-</para>
-<para>
-For more informations see <literal><ulink
-url="http://yada.alioth.debian.org/">YADA site</ulink></literal>.
-</para>
-</section>
-

 <section id="equivs">
 <title><systemitem role="package">equivs</systemitem></title>
 <para>
 <section id="equivs">
 <title><systemitem role="package">equivs</systemitem></title>
 <para>


@@ -321,10 +303,10 @@ signature and checksums before uploading, and the possibility of running
 </section>
 
 <section id="dcut">
 </section>
 
 <section id="dcut">

-<title><systemitem role="package">dcut</systemitem></title>
+<title><command>dcut</command></title>

 <para>
 <para>

-The <systemitem role="package">dcut</systemitem> script (part of the package
-<xref linkend="dput"/> ) helps in removing files from the ftp upload directory.
+The <command>dcut</command> script (part of the package <systemitem role="package">dput</systemitem>,
+<xref linkend="dput"/>) helps in removing files from the ftp upload directory.

 </para>
 </section>
 
 </para>
 </section>
 


@@ -415,10 +397,10 @@ latest entry in a <filename>debian/changelog</filename> file.
 </section>
 
 <section id="dpkg-depcheck">
 </section>
 
 <section id="dpkg-depcheck">

-<title><systemitem role="package">dpkg-depcheck</systemitem></title>
+<title><command>dpkg-depcheck</command></title>

 <para>
 <command>dpkg-depcheck</command> (from the <systemitem
 <para>
 <command>dpkg-depcheck</command> (from the <systemitem

-role="package">devscripts</systemitem> package, <xref linkend="devscripts"/> )
+role="package">devscripts</systemitem> package, <xref linkend="devscripts"/>)

 runs a command under <command>strace</command> to determine all the packages
 that were used by the said command.
 </para>
 runs a command under <command>strace</command> to determine all the packages
 that were used by the said command.
 </para>


@@ -433,7 +415,9 @@ dpkg-depcheck -b debian/rules build
 </screen>
 <para>
 <command>dpkg-depcheck</command> can also be used to check for run-time
 </screen>
 <para>
 <command>dpkg-depcheck</command> can also be used to check for run-time

-dependencies, especially if your package uses exec(2) to run other programs.
+dependencies, especially if your package uses <citerefentry>
+<refentrytitle>exec</refentrytitle> <manvolnum>2</manvolnum> </citerefentry>
+to run other programs.

 </para>
 <para>
 For more information please see <citerefentry>
 </para>
 <para>
 For more information please see <citerefentry>