Date: Thu, 12 Dec 2013 18:02:26 +0200 From: Taras Korenko <ds@ukrhub.net> To: Warren Block <wblock@wonkity.com> Cc: freebsd-doc@freebsd.org Subject: Re: en/handbook/basics: proposed corrections #2 Message-ID: <20131212160226.GE85778@gamma.ukrhub.net> In-Reply-To: <alpine.BSF.2.00.1312120754390.12037@wonkity.com> References: <20131212091212.GC85778@gamma.ukrhub.net> <alpine.BSF.2.00.1312120754390.12037@wonkity.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--qlTNgmc+xy1dBmNv
Content-Type: text/plain; charset=koi8-u
Content-Disposition: inline
On Thu, Dec 12, 2013 at 08:31:58AM -0700, Warren Block wrote:
> On Thu, 12 Dec 2013, Taras Korenko wrote:
> > ...
> > Could anyone review that?
> > ...
> ...
> @@ -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>
>
> WB: "See" is simpler than "refer to". An xml:id can be added to that
> table and linked here. That is also useful when referring to the page
> in HTML, because it becomes an anchor. ...
A xml:id was avoided intentionally: this table is pretty close to the
text, from which the reference is made.
An updated version follows.
--
WBR, Taras Korenko
--qlTNgmc+xy1dBmNv
Content-Type: text/x-diff; charset=koi8-u
Content-Disposition: attachment; filename="03_1.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,9 @@
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>
</listitem>
</varlistentry>
@@ -486,7 +486,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 +522,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 +637,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. See
the manual page for each utility for more details and usage
examples.</para>
@@ -714,7 +714,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
@@ -724,8 +724,8 @@
shown in square brackets. In this example, the user has
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
+ allowing them to become the superuser with &man.su.1;.
+ When finished, the utility will prompt to either
create another user or to exit.</para>
<example xml:id="users-modifying-adduser">
--qlTNgmc+xy1dBmNv--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20131212160226.GE85778>