Re: debian-faq: Patch2 to improve wording or meaning, remove superfluous words, consistentency ...
Hi Holger,
On Tue, Mar 29, 2016 at 07:20:07PM +0200, Holger Wansing wrote:
>
[...]
> I would appreciate review and comments.
Apart from Beatrice and Justin's thoughtfull comments: here are my € 0,02.
> Index: faqinfo.sgml
> ===================================================================
> --- faqinfo.sgml (Revision 10939)
> +++ faqinfo.sgml (Arbeitskopie)
> @@ -12,14 +12,14 @@
>
> <p>Parts of the information came from:
> <list>
> - <item>The Debian-1.1 release announcement, by <url name="Bruce Perens" id="http://www.perens.com/";>.
> - <item>The Linux FAQ, by <url name="Ian Jackson" id="http://www.chiark.greenend.org.uk/~ijackson/";>.
[...]
> <item>many developers, volunteers, and beta testers, and
> - <item>the flaky memories of its authors. :-)
> - <item>Kamaraju Kusumanchi's <url name="Choosing a Debian distribution FAQ" id="http://people.cornell.edu/pages/kk288/debian_choosing_distribution.html";>, who graciously made it GPL so I could include it as a new chapter (see <ref id="choosing">)
> + <item>the flaky memories of its authors :-)
> + <item>and Kamaraju Kusumanchi's <url name="Choosing a Debian distribution FAQ" id="http://people.cornell.edu/pages/kk288/debian_choosing_distribution.html";>, who graciously made it GPL so I could include it as a new chapter (see <ref id="choosing">).
> </list>
s/so I could include/so it could be included/
>
> <p>The authors would like to thank all those who helped make this
> Index: ftparchives.sgml
> ===================================================================
> --- ftparchives.sgml (Revision 10939)
> +++ ftparchives.sgml (Arbeitskopie)
> @@ -61,14 +61,14 @@
> <item><em>sarge</em> was the sergeant of the Green Plastic Army Men,
[...]
> <!-- SID should be the last line always -->
> @@ -423,7 +423,7 @@
> using the standard Debian package management tools, you can set up your own
> apt-able package archive. This is also useful if you'd like to share your
> Debian packages while these are not distributed by the Debian project.
> -Instructions on how to do this are given in the <url name="Debian Repository
> +Instructions on how to do this are given in the (obsolete) <url name="Debian Repository
> HOWTO"
> id="http://www.debian.org/doc/manuals/repository-howto/repository-howto";>.
Better not mention obsolete stuff at all.
[...]
> Index: pkgtools.sgml
> ===================================================================
> --- pkgtools.sgml (Revision 10939)
> +++ pkgtools.sgml (Arbeitskopie)
> @@ -64,7 +64,7 @@
>
> <sect1 id="apt-get">APT
>
> -<p>APT is the <em>Advanced Package Tool</em> is the advanced interface to the
> +<p>APT is the <em>Advanced Package Tool</em>, an advanced interface to the
> Debian packaging system and provides the <prgn/apt-get/ program.
> It features complete installation ordering, multiple source capability and
> several other unique features, see the User's Guide in
> @@ -91,10 +91,6 @@
> <example>apt-get update</example>
> (you should execute this regularly to update your package lists)
>
> +### In the following, change the examples into a senseful ordering,
> +### as it is also executed by user.
> - <item>To upgrade all the packages on your system (without installing
> - extra packages or removing packages), run:
[...]
# is not a comment mark in smgl, use
<!-- In the following, change the examples into a senseful ordering,
as it is also executed by user. -->
> @@ -103,8 +99,12 @@
>
> <item>To remove the foo package and its configuration files from your
> system, run:
> - <example>apt-get --purge remove foo</example>
> + <example>apt-get purge foo</example>
I'd use "apt", not "apt-get", as the standard tool for package management.
Thanks for your work!
Bye,
Joost
Reply to: