Package: debian-reference
Version: 2.49
Severity: wishlist

This has been reported to me.  Thanks.

Let's keep this in BTS so I won't loose this. (It was in my gmail spam box.).

Since neither of us are English native speaker, I do not know which is
better.  In general, I trust Germans and French over Japanese for the
correctness of English grammar.  Those points on "use of plural" "use of
a/an/the" ... are all valid points, e.g., "good idea" -> "a good idea".
(These are all trivial unfuzzy candidate changes.)

Small differences are:

-"(right) clicking the center of the screen and hope for a menu to pop-up."
+"(right) clicking the center of the background and hope for a menu to pop-up."

I see the point.  "background of desktop screen" or something is more explicit.
Let's think ...

As for "owner", let's check manpage of chown:

 en_US.utf8: chown - change file owner and group
 de_DE.utf8: chown - Besitzer und Gruppe von Dateien ändern

Based on these, I think it is more common to use owner in the UNIX
context.

-"--- it does not store data, it just links two processes like the shell "
+"--- it does not store data, it just links two processes like the shell with "
 "\"<literal>|</literal>\".  However, since this pipe has a name, the two "

Not exactly ... Here, I meant:
  --- it links two processes just like the facility offered by the shell
      "\"<literal>|</literal>\" syntax.
Let's think.  

 "The Linux kernel may complain \"Too many open files\".  You can fix this by "
 "increasing \"<literal>file-max</literal>\" value to a larger value from the "
 "root shell, e.g., \"<literal>echo \"65536\" &gt; /proc/sys/fs/file-max</"
+### HW: my default stable system contains "206224" here as default value
+### HW: (I did not ever change this by hand). Maybe this paragraph can be
+### HW: skipped completely?
 "literal>\" (This was needed on older kernels)."
 msgstr ""

Maybe "The Linux kernel" -> "The older Linux kernel".  (Maybe this is too old
info now.  I should think about dropping it.

+### HW: there isn't a real 'linux-doc' package in Stable anymore, right?
+### HW: reword this to linux-doc-2.6.* package:
+### HW: (the same as in the paragraph about documentation regarding procfs and 
sysfs)
+### HW:
+### HW: Ouch, wheezy is released with kernel 3.2. So the above is still wrong.

Well I still see linux-doc meta-package which install pertinent version.
That will be <literal>linux-doc-*</literal> package.

Instead of "2.6.*", make it "*" too. 

Here is the original diff:
====================
--- debian-reference.pot        2012-12-01 11:44:05.100295727 +0100
+++ debian-reference_proposed-changes.pot       2012-12-10 22:36:21.560767785 
+0100
@@ -3626,7 +3626,7 @@
 msgid ""
 "Under some other Desktop systems (like <literal>fluxbox</literal>), there "
 "may be no obvious starting point for the menu.  If this happens, just try "
-"(right) clicking the center of the screen and hope for a menu to pop-up."
+"(right) clicking the center of the background and hope for a menu to pop-up."
+### HW: that only works when rightclicking on the desktop (background), not on 
an 
+### HW: opened application window.
 msgstr ""
 
 #. type: Content of: <book><chapter><section><section><title>
@@ -4440,19 +4440,19 @@
 #. type: Content of: 
<book><chapter><section><section><itemizedlist><listitem><para>
 msgid ""
 "The <emphasis role=\"strong\">read</emphasis> (<emphasis role=\"strong\">r</"
-"emphasis>) permission allows owner to examine contents of the file."
+"emphasis>) permission allows holder to examine contents of the file."
 msgstr ""
 
 #. type: Content of: 
<book><chapter><section><section><itemizedlist><listitem><para>
 msgid ""
 "The <emphasis role=\"strong\">write</emphasis> (<emphasis role=\"strong\">w</"
-"emphasis>) permission allows owner to modify the file."
+"emphasis>) permission allows holder to modify the file."
 msgstr ""
 
 #. type: Content of: 
<book><chapter><section><section><itemizedlist><listitem><para>
 msgid ""
 "The <emphasis role=\"strong\">execute</emphasis> (<emphasis role=\"strong"
-"\">x</emphasis>) permission allows owner to run the file as a command."
+"\">x</emphasis>) permission allows holder to run the file as a command."
 msgstr ""
 
 #. type: Content of: <book><chapter><section><section><para>
@@ -4463,19 +4463,19 @@
 #. type: Content of: 
<book><chapter><section><section><itemizedlist><listitem><para>
 msgid ""
 "The <emphasis role=\"strong\">read</emphasis> (<emphasis role=\"strong\">r</"
-"emphasis>) permission allows owner to list contents of the directory."
+"emphasis>) permission allows holder to list contents of the directory."
 msgstr ""
 
 #. type: Content of: 
<book><chapter><section><section><itemizedlist><listitem><para>
 msgid ""
 "The <emphasis role=\"strong\">write</emphasis> (<emphasis role=\"strong\">w</"
-"emphasis>) permission allows owner to add or remove files in the directory."
+"emphasis>) permission allows holder to add or remove files in the directory."
 msgstr ""
 
 #. type: Content of: 
<book><chapter><section><section><itemizedlist><listitem><para>
 msgid ""
 "The <emphasis role=\"strong\">execute</emphasis> (<emphasis role=\"strong"
-"\">x</emphasis>) permission allows owner to access files in the directory."
+"\">x</emphasis>) permission allows holder to access files in the directory."
 msgstr ""
 
 #. type: Content of: <book><chapter><section><section><para>
@@ -4886,11 +4886,11 @@
 "The Debian system uses a user private group (UPG) scheme as its default. A "
 "UPG is created whenever a new user is added to the system. A UPG has the "
 "same name as the user for which it was created and that user is the only "
-"member of the UPG. UPG scheme makes it is safe to set umask to "
+"member of the UPG. UPG scheme makes it safe to set umask to "
 "<literal>0002</literal> since every user has their own private group.  (In "
 "some Unix variants, it is quite common to setup all normal users belonging "
 "to a single <emphasis role=\"strong\"><literal>users</literal></emphasis> "
-"group and is good idea to set umask to <literal>0022</literal> for security "
+"group and is a good idea to set umask to <literal>0022</literal> for security 
"
 "in such cases.)"
 msgstr ""
 
@@ -5273,7 +5273,7 @@
 
 #. type: Content of: <book><chapter><section><section><caution><para>
 msgid ""
-"It is generally good idea not to create complicated symbolic links or "
+"It is generally a good idea not to create complicated symbolic links or "
 "hardlinks at all unless you have a very good reason.  It may cause "
 "nightmares where the logical combination of the symbolic links results in "
 "loops in the filesystem."
@@ -5321,7 +5321,7 @@
 "doesn't terminate until the information being written is read from the "
 "pipe.  If you read from a named pipe, the reading process waits until there "
 "is nothing to read before terminating.  The size of the pipe is always zero "
-"--- it does not store data, it just links two processes like the shell "
+"--- it does not store data, it just links two processes like the shell with "
 "\"<literal>|</literal>\".  However, since this pipe has a name, the two "
 "processes don't have to be on the same command line or even be run by the "
 "same user. Pipes were a very influential innovation of Unix."
@@ -5452,22 +5452,22 @@
 #. type: Content of: 
<book><chapter><section><section><itemizedlist><listitem><para>
 msgid ""
 "\"<literal>/dev/sda</literal>\" has the major device number 8 and the minor "
-"device number 0.  This is read/write accessible by the user who belongs to "
+"device number 0.  This is read/write accessible by users belonging to "
 "<literal>disk</literal> group."
 msgstr ""
 
 #. type: Content of: 
<book><chapter><section><section><itemizedlist><listitem><para>
 msgid ""
 "\"<literal>/dev/sr0</literal>\" has the major device number 11 and the minor "
-"device number 0.  This is read/write accessible by the user who belongs to "
+"device number 0.  This is read/write accessible by users belonging to "
 "<literal>cdrom</literal> group."
 msgstr ""
 
 #. type: Content of: 
<book><chapter><section><section><itemizedlist><listitem><para>
 msgid ""
 "\"<literal>/dev/ttyS0</literal>\" has the major device number 4 and the "
-"minor device number 64.  This is read/write accessible by the user who "
-"belongs to <literal>dialout</literal> group."
+"minor device number 64.  This is read/write accessible by users "
+"belonging to <literal>dialout</literal> group."
 msgstr ""
 
 #. type: Content of: 
<book><chapter><section><section><itemizedlist><listitem><para>
@@ -5596,8 +5596,8 @@
 
 #. type: Content of: <book><chapter><section><section><para>
 msgid ""
-"The directories under \"<literal>/proc/sys/</literal>\" contain interface to "
-"change certain kernel parameters at run time.  (You may do the same through "
+"The directories under \"<literal>/proc/sys/</literal>\" contain an interface 
to "
+"change certain kernel parameters at run time.  (You may do the same through 
the "
 "specialized <citerefentry><refentrytitle>sysctl</refentrytitle><manvolnum>8</"
 "manvolnum></citerefentry> command or its preload/configuration file "
 "\"<literal>/etc/sysctrl.conf</literal>\".)"
@@ -5608,6 +5608,9 @@
 "The Linux kernel may complain \"Too many open files\".  You can fix this by "
 "increasing \"<literal>file-max</literal>\" value to a larger value from the "
 "root shell, e.g., \"<literal>echo \"65536\" &gt; /proc/sys/fs/file-max</"
+### HW: my default stable system contains "206224" here as default value
+### HW: (I did not ever change this by hand). Maybe this paragraph can be
+### HW: skipped completely?
 "literal>\" (This was needed on older kernels)."
 msgstr ""
 
@@ -5624,7 +5627,7 @@
 msgid ""
 "The directory under \"<literal>/sys</literal>\" contains exported kernel "
 "data structures, their attributes, and their linkages between them. It also "
-"contains interface to change certain kernel parameters at run time."
+"contains an interface to change certain kernel parameters at run time."
 msgstr ""
 
 #. type: Content of: <book><chapter><section><section><para>
@@ -5672,9 +5675,14 @@
 
 #. type: Content of: <book><chapter><section><section><para>
 msgid ""
+### HW: there isn't a real 'linux-doc' package in Stable anymore, right?
+### HW: reword this to linux-doc-2.6.* package:
+### HW: (the same as in the paragraph about documentation regarding procfs and 
sysfs)
+### HW:
+### HW: Ouch, wheezy is released with kernel 3.2. So the above is still wrong.
 "See \"<literal>tmpfs.txt(.gz)</literal>\" in the Linux kernel documentation "
-"(\"<literal>/usr/share/doc/linux-doc-*/Documentation/filesystems/*</literal>"
-"\") provided by the <literal>linux-doc-*</literal> package."
+"(\"<literal>/usr/share/doc/linux-doc-2.6.*/Documentation/filesystems/*</literal>"
+"\") provided by the <literal>linux-doc-2.6.*</literal> package."
 msgstr ""
 
 #. type: Content of: <book><chapter><section><title>
@@ -7683,7 +7691,7 @@
 #. type: Content of: <book><chapter><section><section><tip><para>
 msgid ""
 "When filing a bug report, running and checking the command under "
-"\"<literal>LANG=en_US.UTF-8</literal>\" is good idea if you use non-English "
+"\"<literal>LANG=en_US.UTF-8</literal>\" is a good idea if you use non-English 
"
 "environment."
 msgstr ""
 
@@ -14797,7 +14805,7 @@
 
 #. type: Content of: <book><chapter><section><section><tip><para>
 msgid ""
-"It is good idea to remove (not purge!) as much packages to minimize "
+"It is a good idea to remove (not purge!) as much packages to minimize "
 "dependency problems.  You may need to manually remove and install some "
 "packages to get system downgraded.  Linux kernel, bootloader, udev, PAM, "
 "APT, and networking related packages and their configuration files require "
@@ -23060,7 +23068,7 @@
 "manvolnum></citerefentry> now.  If you want to reject mail before "
 "downloading to save bandwidth, <literal>mailfilter</literal> or "
 "<literal>mpop</literal> may be useful.  Whichever mail retriever utilities "
-"are used, it is good idea to configure system to deliver retrieved mails to "
+"are used, it is a good idea to configure system to deliver retrieved mails to 
"
 "MDA, such as <literal>maildrop</literal>, via pipe."
 msgstr ""
 
@@ -23227,7 +23235,7 @@
 "manvolnum></citerefentry> has been de facto standard for MDA with filter on "
 "GNU/Linux, author likes <citerefentry><refentrytitle>maildrop</"
 "refentrytitle><manvolnum>1</manvolnum></citerefentry> now.  Whichever "
-"filtering utilities are used, it is good idea to configure system to deliver "
+"filtering utilities are used, it is a good idea to configure system to 
deliver "
 "filtered mails to a <ulink url=\"&qmailstylemaildir;\">qmail-style Maildir</"
 "ulink>."
 msgstr ""
@@ -26634,7 +26642,7 @@
 
 #. type: Content of: <book><chapter><section><section><tip><para>
 msgid ""
-"It is good idea to install system wide default locale as \"<literal>en_US."
+"It is a good idea to install system wide default locale as \"<literal>en_US."
 "UTF-8</literal>\" for maximum compatibility."
 msgstr ""
 
@@ -28451,7 +28459,7 @@
 #. type: Content of: <book><chapter><section><section><caution><para>
 msgid ""
 "Use of <ulink url=\"&aufs;\">aufs</ulink> for long term data storage is not "
-"good idea since it is under development and its design change may introduce "
+"a good idea since it is under development and its design change may introduce 
"
 "issues."
 msgstr ""
 
@@ -36424,7 +36432,7 @@
 
 #. type: Content of: <book><chapter><section><section><para>
 msgid ""
-"Even if your upstream uses different VCS, it may be good idea to use "
+"Even if your upstream uses different VCS, it may be a good idea to use "
 "<citerefentry><refentrytitle>git</refentrytitle><manvolnum>1</manvolnum></"
 "citerefentry> for local activity since you can manage your local copy of "
 "source tree without the network connection to the upstream.  Here are some "
@@ -39308,7 +39316,7 @@
 #. type: Content of: <book><chapter><tip><para>
 msgid ""
 "<ulink url=\"&codeexamplesofcrgjjbottlesofbeer;\">Code examples of creating "
-"\"Song 99 Bottles of Beer\"</ulink> should give you good idea of practically "
+"\"Song 99 Bottles of Beer\"</ulink> should give you a good idea of 
practically "
 "all the programming languages."
 msgstr ""
 
@@ -40107,7 +40115,7 @@
 #. type: Content of: <book><chapter><section><section><para>
 msgid ""
 "In order to make your shell program as portable as possible across Debian "
-"system, it is good idea to limit utility programs to ones provided by "
+"system, it is a good idea to limit utility programs to ones provided by "
 "<emphasis role=\"strong\">essential</emphasis> packages."
 msgstr ""
 




-- System Information:
Debian Release: 7.0
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (10, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 3.7-trunk-amd64 (SMP w/8 CPU cores)
Locale: LANG=en_US.utf8, LC_CTYPE=en_US.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages debian-reference depends on:
ii  debian-reference-en  2.49

Versions of packages debian-reference recommends:
ii  debian-reference-fr  2.49
ii  debian-reference-it  2.49
ii  debian-reference-ja  2.49
ii  debian-reference-pt  2.49

debian-reference suggests no packages.

-- no debconf information


--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Reply via email to