Date: Thu, 12 Dec 2013 11:12:12 +0200 From: Taras Korenko <ds@ukrhub.net> To: freebsd-doc@freebsd.org Subject: en/handbook/basics: proposed corrections #2 Message-ID: <20131212091212.GC85778@gamma.ukrhub.net>
next in thread | raw e-mail | index | archive | help
--0F1p//8PRICkK4MW
Content-Type: text/plain; charset=koi8-u
Content-Disposition: inline
Good day, doc@ folks.
The following notes were made while working on translation of "Users
and Basic Account Management" of our handbook. I'd like to put them
into the source file (basics/chapter.xml).
Could anyone review that?
P.S.: my (xml-style) comments are denoted with 'XXX skipme:'.
--
WBR, Taras Korenko
--0F1p//8PRICkK4MW
Content-Type: text/x-diff; charset=koi8-u
Content-Disposition: attachment; filename="03.en.hb.basics.diff"
Index: en_US.ISO8859-1/books/handbook/basics/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/handbook/basics/chapter.xml (revision 43325)
+++ en_US.ISO8859-1/books/handbook/basics/chapter.xml (working copy)
@@ -455,9 +455,11 @@
used to uniquely identify the user to the &os; system.
Commands that allow a user name to be specified will
first convert it to the <acronym>UID</acronym>. It is
- recommended to use a UID of 65535 or lower as higher
- UIDs may cause compatibility issues with software that
- does not support integers larger than 32-bits.</para>
+ recommended to use a UID less than 65535, since higher
+ values may cause compatibility issues with some
+ software.</para>
+<!-- XXX skipme: "integers larger than 32-bits"? I guess that ought to be
+ "16-bits" -->
</listitem>
</varlistentry>
@@ -486,7 +488,7 @@
mechanism that provide additional flexibility when
tailoring the system to different users. Login
classes are discussed further in
- <xref linkend="users-limiting"/></para>
+ <xref linkend="users-limiting"/>.</para>
</listitem>
</varlistentry>
@@ -522,7 +524,7 @@
<para>The user name uniquely identifies the account to
&os;, but does not necessarily reflect the user's real
name. Similar to a comment, this information can
- contain a space, uppercase characters, and be more
+ contain spaces, uppercase characters, and be more
than 8 characters long.</para>
</listitem>
</varlistentry>
@@ -637,7 +639,7 @@
<para>&os; provides a variety of different commands to manage
user accounts. The most common commands are summarized in
- Table 4.1, followed by some examples of their usage. Refer to
+ the subsequent table, followed by some examples of their usage. Refer to
the manual page for each utility for more details and usage
examples.</para>
@@ -714,7 +716,7 @@
<filename>/usr/share/skel</filename>, and can optionally
mail the new user a welcome message. This utility must be
run as the
- <systemitem class="username">superuser</systemitem>.</para>
+ superuser.</para>
<para>The &man.adduser.8; utility is interactive and walks
through the steps for creating a new user account. As seen
@@ -725,8 +727,10 @@
been invited into the
<systemitem class="groupname">wheel</systemitem> group,
which is required to provide the account with superuser
- access. When finished, the utility will prompt to either
+ access using &man.su.1;. When finished, the utility will prompt to either
create another user or to exit.</para>
+<!-- XXX skipme: on the contrary, "sudo" requires no special group
+ membership -->
<example xml:id="users-modifying-adduser">
<title>Adding a User on &os;</title>
--0F1p//8PRICkK4MW--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20131212091212.GC85778>