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
