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

proposed changes to debian-faq



Hi!

I updated the Italian translation of the Debian FAQ. In doing so I
notice a couple of minor things that I think can be changed (nothing
substantial!).

Since Holger is doing such an extensive great job in
reorganizing/updating the FAQ I thought this might be a good moment to
re-read the FAQs as a "low-level" reviewer. The changes I propose are
mostly minor typos and such.

The only change related to actual contents is about the use of
httpredir.

I attach a suggested patch for 4 of the sgml files in the source tree.

Holger can decide what to change or not change of course.

I plan to read the rest of the files in the repo too, unless someone
objects to my suggestions.

Thanks,

beatrice
Index: nexttime.sgml
===================================================================
--- nexttime.sgml	(revisione 11195)
+++ nexttime.sgml	(copia locale)
@@ -31,7 +31,7 @@
 
 <p>All of these are done in an ongoing basis. For the first item, a set of security hardening
 build flags that try to prevent known attacks such as stack smashing,
-predictable locations of values in memory, etc. The target is to cover at least
+predictable locations of values in memory, etc. is used. The target is to cover at least
 all packages that are part of the basic installation as well as packages that
 had to be updated through a Security Advisory since 2006. As of this writing,
 around 400 packages have been modified since this effort was first started. All the issues
@@ -94,7 +94,7 @@
 <sect id="morearches">More architectures
 
 <p>Complete Debian system on other architectures. Notice that even though some
-architectures are dropped for a given the release there still might be a way to
+architectures are dropped for a given release, there still might be a way to
 install and upgrade using the latest <tt>sid</tt>.
 
 <sect id="morekernels">More kernels
Index: pkgtools.sgml
===================================================================
--- pkgtools.sgml	(revisione 11195)
+++ pkgtools.sgml	(copia locale)
@@ -22,7 +22,7 @@
 for more information about the Debian package management utilities.
 This document is available in various languages and formats, see <url
 id="http://www.debian.org/doc/user-manuals#quick-reference"; name="the Debian
-Reference entry on the DDP Users' Manuals overview">.
+Reference entry in the DDP Users' Manuals overview">.
 
 <!-- TODO: Describe tools to automatically build from sources Debian
 packages including 'apt-build' or 'pbuilder' (in pkg_basics.sgml) -->
@@ -66,14 +66,14 @@
 
 <p>APT is the <em>Advanced Package Tool</em>, an advanced interface to the
 Debian packaging system which provides the <prgn/apt-get/ program.
-It provides commandline tools for searching, managing and querying
-information about packages as well as low-level access to all features
-of the libapt-pkg library, see the User's Guide in
+It provides commandline tools for searching and managing packages, and
+for querying information about them, as well as low-level access to all features
+of the libapt-pkg library.  For more information, see the User's Guide in
 <tt>/usr/share/doc/apt-doc/guide.html/index.html</tt> (you will have to install
-the <tt>apt-doc</tt> package).
+the <package>apt-doc</package> package).
 
 <p>Starting with Debian Jessie, some frequently used
-<prgn/apt-get/ and <prgn/apt-cache/ commands got an equivalent via
+<prgn/apt-get/ and <prgn/apt-cache/ commands have an equivalent via
 the new <prgn/apt/ binary. This means some popular commands like
 <prgn/apt-get update/, <prgn/apt-get install/, <prgn/apt-get remove/,
 <prgn/apt-cache search/, or <prgn/apt-cache show/ now can also be called
@@ -115,7 +115,7 @@
 <p>Some common ways to use <prgn/apt-get/ are:
 
 <list>
-       <item>To update the list of package known by your system, you can run:
+       <item>To update the list of packages known by your system, you can run:
                <example>apt update</example>
        (you should execute this regularly to update your package lists)
 
@@ -148,11 +148,11 @@
 </list>
 
 <p>Note that you must be logged in as root to perform any commands that
-modify any packages.
+modify packages.
 
-<p>Note that <prgn/apt-get/ now installs recommended packages as default and is
-the preferred program for package management from console to perform system
-installation and major system upgrades for its robustness.
+<p>Note that <prgn/apt-get/ now also installs recommended packages as
+default, and thanks to its robustness it's the preferred program for package management from console to perform system
+installation and major system upgrades.
 
 <p>The apt tool suite also includes the <prgn/apt-cache/ tool to query
 the package lists. You can use it to find packages providing specific
@@ -170,7 +170,7 @@
        <item>To print the packages a given package depends on:
                <example>apt-cache depends <var>package</var></example>
 
-       <item>To print detailed information of the versions available
+       <item>To print detailed information on the versions available
                for a package and the packages that reverse-depends on
                it:
                <example>apt-cache showpkg <var>package</var></example>
@@ -181,7 +181,7 @@
 <p>For more information, install the <package/apt/ package and read
 <manref name="apt" section="8">,
 <manref name="apt-get" section="8">, <manref name="sources.list" section="5">
-and install the  <package/apt-doc/ package and read
+and install the <package/apt-doc/ package and read
 <file>/usr/share/doc/apt-doc/guide.html/index.html</file>.
 
 <sect1 id="aptitude">aptitude
@@ -218,7 +218,7 @@
        <item><prgn/aptitude/ in full screen mode has <prgn/su/
        functionality embedded and can be run by a normal user. It will
        call <prgn/su/ (and ask for the root password, if any) when you
-       really need administrative privileges
+       really need administrative privileges.
 
 </list>
 
@@ -229,9 +229,9 @@
 <tt>aptitude install <var>foo</var></tt>.
 
 <p>Note that <prgn/aptitude/ is the preferred program for daily package 
-management from console.
+management from the console.
 
-<p>For more informations, read the manual page <manref
+<p>For more information, read the manual page <manref
 name="aptitude" section="8"> and install the <package/aptitude-doc/
 package.
 
@@ -238,8 +238,8 @@
 <sect1 id="synaptic">synaptic
 
 <p><prgn/synaptic/ is a graphical package manager.  It enables you to install,
-upgrade and remove software packages in a user friendly way.   Next to all
-features offered by aptitude, it also has a feature for editing the list of
+upgrade and remove software packages in a user friendly way.   Next to
+all the features offered by aptitude, it also has a feature for editing the list of
 used repositories, and supports browsing all available documentation related to
 a package. See the <url id="http://www.nongnu.org/synaptic/"; name="Synaptic
 Website"> for more information.
@@ -273,7 +273,7 @@
 
 <sect2 id="dpkg-deb">dpkg-deb
 
-<p>This program manipulates Debian archive(<tt>.deb</tt>) files.
+<p>This program manipulates Debian archive (<tt>.deb</tt>) files.
 Some common uses are:
 <list>
   <item>Find out all the options:  <tt>dpkg-deb --help</tt>.
@@ -321,8 +321,8 @@
 status symbol (explained in the header), the package name, the version
 which is <em>installed</em>, and a brief description.
 
-<p>To learn the status of packages whose names match the string any
-pattern beginning with "foo" by executing the command:
+<p>To learn the status of packages whose names match any
+pattern beginning with "foo", run the command:
   <example>dpkg --list 'foo*'</example>
 
 <p>To get a more verbose report for a particular package, execute the
@@ -329,7 +329,7 @@
 command:
   <example>dpkg --status packagename</example>
  
-<sect id="listfiles">How to display the files of a package installed?
+<sect id="listfiles">How to display the files of an installed package?
 
 <p>To list all the files provided by the installed package <tt>foo</tt>
 execute the command
@@ -372,13 +372,13 @@
     <p>If you install the <package>apt-file</package>, similar to the above, it
     searches files which contain the substring or regular expression
     <tt>foo</tt> in their full path names. The
-    advantage over the sample above is that there is no need to retrieve the
+    advantage over the exemple above is that there is no need to retrieve the
     <tt>Contents-ARCH.gz</tt> files as it will do this automatically for
     all the sources defined in <file>/etc/apt/sources.list</file> when
     you run (as root) <tt>apt-file update</tt>.
 </list>
 
-<sect id="datapackages">Why doesn't get `foo-data' removed when I 
+<sect id="datapackages">Why is `foo-data' not removed when I 
    uninstall `foo'?  How do I make sure old unused library-packages get
    purged?
 
@@ -387,7 +387,7 @@
 multimedia applications and
 dictionaries in Debian and has been introduced since some users might
 want to access the raw data without installing the program or because
-the program can be run without the data itself, making it optional.
+the program can be run without the data itself, making them optional.
 
 <p>Similar situations occur when dealing with libraries: generally these get
 installed since packages containing applications depend on them.  When the
@@ -403,5 +403,5 @@
 dependencies. If you use <prgn>aptitude</prgn> (see <ref
 id="aptitude">) as your package management tool it will, however,
 track automatically installed packages and remove them when no
-packages remain that need them in your system.
+packages needing them remain in your system.
 
Index: software.sgml
===================================================================
--- software.sgml	(revisione 11195)
+++ software.sgml	(copia locale)
@@ -19,11 +19,12 @@
   <item>a full suite of networking applications, including servers for
     Internet protocols such as HTTP (WWW), FTP, NNTP (news), SMTP and POP
     (mail) and  DNS (name servers); relational databases like PostgreSQL, MySQL;
-    also provided are web browsers including the various Mozilla products
-    <footnote>These have been, however, rebranded and are provided
-    with different names due to trademark issues</footnote>,
+    also provided are web browsers including the various Mozilla products,
+<!-- footnote no longer needed? -->
+    <!--    <footnote>These have been, however, rebranded and are provided
+    with different names due to trademark issues</footnote>, -->
   <item>a complete set of office applications, including the
-    OpenOffice.org productivity suite, Gnumeric and other spreadsheets,
+    LibreOffice.org productivity suite, Gnumeric and other spreadsheets,
     WYSIWYG editors, calendars.
 </list>
 
@@ -31,7 +32,7 @@
 to sound support, FAX programs, database and spreadsheet programs, image
 processing programs, communications, net, and mail utilities, Web servers,
 and even ham-radio programs are included in the distribution.
-Another &contrib-nonfree-pkgs; software suites are available as Debian
+Other &contrib-nonfree-pkgs; software suites are available as Debian
 packages, but are not formally part of Debian due to license restrictions.
 
 <sect id="softwareauthors">Who wrote all that software?
@@ -75,7 +76,7 @@
 <p>Finding which software is precisely required can be tricky, however, unless
 you are planning on rebuilding Debian packages. This last task is rather easy
 to do, as official packages have to include a list of the additional software
-(besides the packages in  <package>build-essential</package>) needed to build
+(besides the packages in <package>build-essential</package>) needed to build
 the package, this is known as <tt>Build-Dependencies</tt>. To install all the
 packages needed to build a given source package and then build said source
 package you can just run:
@@ -91,11 +92,10 @@
 
 <sect id="missing">What is missing from &debian;?
 
-<p>A list of packages which are still needed to be packaged for Debian
-exists, the <url id="http://www.debian.org/devel/wnpp/"; name="Work-Needing
+<p>There is a list of packages which still need to be packaged for Debian, the <url id="http://www.debian.org/devel/wnpp/"; name="Work-Needing
 and Prospective Packages list">.
 
-<p>For more details about adding the missing things, see <ref id="contrib">.
+<p>For more details about adding missing things, see <ref id="contrib">.
 
 <sect id="no-devs">Why do I get "ld: cannot find -lfoo" messages when
   compiling programs? Why aren't there any libfoo.so files in Debian library
@@ -113,7 +113,7 @@
 Environments. You can write, debug and run Java programs using Debian.
 
 <p>Running a Java applet requires a web browser with the capability to
-recognize and execute them. Several web browsers available in Debian, such
+recognize and execute it. Several web browsers available in Debian, such
 as Mozilla or Konqueror, support Java plug-ins that enable running Java
 applets within them.
 
@@ -122,7 +122,7 @@
 information.
 
 <sect id="isitdebian">How can I check that I am using a Debian system, and
-  what version is it?
+  what version it is?
 
 <p>In order to make sure that your system has been installed from the
 real Debian base disks,
@@ -158,7 +158,7 @@
 <p>Note that the existence of the program <tt>dpkg</tt> shows that you should be able
 to install Debian packages on your system. However, since the program has been
 ported to many other operating systems and architectures, this is no longer
-a reliable method of determining is a system &debian;.
+a reliable method of determining if a system is &debian;.
 
 <sect id="nonenglish">How does Debian support non-English languages?
 
@@ -168,9 +168,9 @@
     view, and modify the tables.
     <p>The installation prompts the user to specify the keyboard he will use.
   <item>Nearly all of the software in Debian supports UTF-8 as
-    character set. Legacy character sets as ISO-8859-1
-    or ISO-8859-2 should be considered obsolete.
-  <item>Currently, support for German-, Spanish-, Finnish-, French-,
+    character set. Legacy character sets, such as ISO-8859-1
+    or ISO-8859-2, should be considered obsolete.
+  <item>Currently, support for German-, Spanish-, French-,
     Hungarian-, Italian-, Japanese-, Korean-, Dutch-, Polish-, 
     Portuguese-, Russian-, Turkish-, and Chinese-language
     manual pages is provided through the <tt>manpages-LANG</tt> packages
@@ -212,8 +212,8 @@
 
 <sect id="googleearth">Where is Google Earth?
 
-<p>Google Earth is available for GNU/Linux from Google's web site, but is not
-only not Free Software, but is completely undistributable by a third party.
+<p>Google Earth is available for GNU/Linux from Google's web site, but not
+only it is not Free Software, but is completely undistributable by a third party.
 However, <package/googleearth-package/ (in the contrib-section) might be
 helpful in using this software.
 
Index: uptodate.sgml
===================================================================
--- uptodate.sgml	(revisione 11195)
+++ uptodate.sgml	(copia locale)
@@ -1,8 +1,8 @@
-<!-- retain these comments for translator revision tracking -->
+vn<!-- retain these comments for translator revision tracking -->
 <!-- Original version: $Revision: 1.24 $ -->
 <chapt id="uptodate">Keeping your Debian system up-to-date
 
-<p>A Debian goal is to provide a consistent upgrade path and a secure
+<p>One of Debian goals is to provide a consistent upgrade path and a secure
 upgrade process. We always do our best to make upgrading to new releases
 a smooth procedure. In case there's some important note to
 add to the upgrade process, the packages will alert the user, and often
@@ -12,7 +12,7 @@
 details of specific upgrades. It is 
 available on the Debian website at <url
 id="http://www.debian.org/releases/stable/releasenotes";> and is also
-shipped on the Debian CDs, DVDs and Blu-Ray discs 
+shipped on the Debian CDs, DVDs and Blu-Ray discs.
 
 
 <sect id="howtocurrent">How can I keep my Debian system current?
@@ -47,10 +47,19 @@
 name of a faster Debian mirror near you. See the mirror list at
 <url id="http://www.debian.org/mirror/list";> for more information.
 
+<!-- info on httpredir mostly from http://httpredir.debian.org/ -->
+<p>Or you can use the redirector httpredir.debian.org which aims to
+  solve the problem of choosing a Debian mirror.  It uses the geographic
+  location of the user and other information to choose the best mirror
+  that can serve the files.  To take advantage of it use a source like
+  this one:
+
+<example>http://httpredir.debian.org/debian stable main contrib non-free</example>
+  
 <p>More details on this can be found in the <manref name="sources.list"
 section="5"> manual page.
 
-<p>To update your system in command line, run
+<p>To update your system from the command line, run
       <example>aptitude update</example>
 followed by
       <example>aptitude full-upgrade</example>
@@ -115,7 +124,7 @@
 of remote directory trees.  The files fetched need not be Debian files.
 (Since <prgn/mirror/ is a Perl script, it can also run on non-Unix systems.)
 Though the <prgn/mirror/ program provides mechanisms for excluding files
-names of which match user-specified strings, this program is most useful
+with names matching user-specified strings, this program is most useful
 when the objective is to download whole directory trees, rather than
 selected packages.
 
@@ -136,8 +145,8 @@
 your system, e.g. by running <tt>aptitude clean</tt>.
 
 <sect id="keepingalog">How can I keep a log of the packages I added to the
-  system?  I'd like to know when which package upgrades and removals have
-  occured!
+  system?  I'd like to know when upgrades and removals have
+  occured and on which packages!
 
 <p>Passing the <tt>--log</tt>-option to <prgn/dpkg/ makes <prgn/dpkg/
 log status change updates and actions.  It logs both the
@@ -153,7 +162,7 @@
 2005-12-30 18:10:35 status installed hello 2.1.1-4
 </example>
 
-<p>)  If you'd like to log all your <prgn/dpkg/ invokations (even those done
+<p>)  If you'd like to log all your <prgn/dpkg/ invocations (even those done
 using frontends like <prgn/aptitude/), you could add
 
 <example>
@@ -162,7 +171,7 @@
 
 <p>to your <file>/etc/dpkg/dpkg.cfg</file>.  Be sure the created logfile gets
 rotated periodically.  If you're using <prgn/logrotate/, this can be achieved
-by creating a file <file>/etc/logrotate.d/dpkg</file> with contents
+by creating a file <file>/etc/logrotate.d/dpkg</file> with the following lines
 
 <example>
 /var/log/dpkg {

Attachment: signature.asc
Description: PGP signature


Reply to: