This commit does the following:

+ some rewordings, simplifications and typo fixes in "Users and Basic
  Account Management" section (discussed with wblock in ML [1]);
+ adds xml:ids to three examples and makes use of them;
+ nothing around "becoming superuser" -- that subchapter was rearranged
  in r42873;
+ deletes suddenly revived handbook/users directory (the first attempt
  was in r42953).

1. http://lists.freebsd.org/pipermail/freebsd-doc/2013-November/022881.html
This commit is contained in:
Taras Korenko 2013-12-06 13:43:49 +00:00
parent dda15b0ad9
commit 16b54dbd20
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=43282
3 changed files with 22 additions and 1064 deletions
en_US.ISO8859-1/books/handbook

View file

@ -428,8 +428,8 @@ console none unknown off secure</programlisting>
<listitem> <listitem>
<para>The user name is typed at the <para>The user name is typed at the
<prompt>login:</prompt> prompt. User names must be <prompt>login:</prompt> prompt. Each user must have
unique on the system as no two users can have the same a unique
user name. There are a number of rules for creating user name. There are a number of rules for creating
valid user names which are documented in valid user names which are documented in
&man.passwd.5;. It is recommended to use user names &man.passwd.5;. It is recommended to use user names
@ -443,9 +443,7 @@ console none unknown off secure</programlisting>
<term>Password</term> <term>Password</term>
<listitem> <listitem>
<para>Each user account should have an associated <para>Each account has an associated password.</para>
password. While the password can be blank, this is
highly discouraged.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -496,9 +494,8 @@ console none unknown off secure</programlisting>
<term>Password change time</term> <term>Password change time</term>
<listitem> <listitem>
<para>By default, &os; does not force users to change <para>By default, passwords do not expire. However,
their passwords periodically. Password expiration can password expiration can be enabled on a per-user basis,
be enforced on a per-user basis using &man.pw.8;,
forcing some or all users to change their passwords forcing some or all users to change their passwords
after a certain amount of time has elapsed.</para> after a certain amount of time has elapsed.</para>
</listitem> </listitem>
@ -586,7 +583,7 @@ console none unknown off secure</programlisting>
the superuser, since an extra space or missing character can the superuser, since an extra space or missing character can
mean irreparable data loss.</para> mean irreparable data loss.</para>
<para>There are several ways to become gain superuser <para>There are several ways to gain superuser
privilege. While one can log in as privilege. While one can log in as
<systemitem class="username">root</systemitem>, this is <systemitem class="username">root</systemitem>, this is
highly discouraged.</para> highly discouraged.</para>
@ -717,11 +714,12 @@ Password:
<filename>/usr/share/skel</filename>, and can optionally <filename>/usr/share/skel</filename>, and can optionally
mail the new user a welcome message. This utility must be mail the new user a welcome message. This utility must be
run as the run as the
<systemitem class="username">superuser</systemitem></para> <systemitem class="username">superuser</systemitem>.</para>
<para>The &man.adduser.8; utility is interactive and walks <para>The &man.adduser.8; utility is interactive and walks
through the steps for creating a new user account. As seen through the steps for creating a new user account. As seen
in Example 4.2, either input the required information or in <xref linkend="users-modifying-adduser"/>,
either input the required information or
press <keycap>Return</keycap> to accept the default value press <keycap>Return</keycap> to accept the default value
shown in square brackets. In this example, the user has shown in square brackets. In this example, the user has
been invited into the been invited into the
@ -730,7 +728,7 @@ Password:
access. When finished, the utility will prompt to either access. When finished, the utility will prompt to either
create another user or to exit.</para> create another user or to exit.</para>
<example> <example xml:id="users-modifying-adduser">
<title>Adding a User on &os;</title> <title>Adding a User on &os;</title>
<screen>&prompt.root; <userinput>adduser</userinput> <screen>&prompt.root; <userinput>adduser</userinput>
@ -868,7 +866,7 @@ Removing user (jru): mailspool home passwd.
<para>When passed no options, aside from an optional username, <para>When passed no options, aside from an optional username,
&man.chpass.1; displays an editor containing user &man.chpass.1; displays an editor containing user
information. When the user exists from the editor, the user information. When the user exits from the editor, the user
database is updated with the new information.</para> database is updated with the new information.</para>
<note> <note>
@ -877,15 +875,16 @@ Removing user (jru): mailspool home passwd.
superuser.</para> superuser.</para>
</note> </note>
<para>In Example 4.4, the superuser has typed <para>In <xref linkend="users-modifying-chpass-su"/>,
the superuser has typed
<command>chpass jru</command> and is now viewing the fields <command>chpass jru</command> and is now viewing the fields
that can be changed for this user. If that can be changed for this user. If
<systemitem class="username">jru</systemitem> runs this <systemitem class="username">jru</systemitem> runs this
command instead, only the last six fields will be displayed command instead, only the last six fields will be displayed
and available for editing. This is shown in Example and available for editing. This is shown in
4.5.</para> <xref linkend="users-modifying-chpass-ru"/>.</para>
<example> <example xml:id="users-modifying-chpass-su">
<title>Using <command>chpass</command> as <title>Using <command>chpass</command> as
Superuser</title> Superuser</title>
@ -906,7 +905,7 @@ Home Phone:
Other information:</screen> Other information:</screen>
</example> </example>
<example> <example xml:id="users-modifying-chpass-ru">
<title>Using <command>chpass</command> as Regular <title>Using <command>chpass</command> as Regular
User</title> User</title>
@ -1165,8 +1164,8 @@ passwd: done</screen>
&man.sysctl.8;. Setting this limit too small may hinder &man.sysctl.8;. Setting this limit too small may hinder
a user's productivity as it is often useful to be logged a user's productivity as it is often useful to be logged
in multiple times or to execute pipelines. Some tasks, in multiple times or to execute pipelines. Some tasks,
such as compiling a large program, spawn multiple such as compiling a large program, start lots of
processes and other intermediate preprocessors.</para> processes.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1241,8 +1240,8 @@ passwd: done</screen>
<primary>limiting users</primary> <primary>limiting users</primary>
<secondary>sbsize</secondary> <secondary>sbsize</secondary>
</indexterm>, </indexterm>,
a user may consume in order to limit network a user may consume. This can be generally used to limit
communications.</para> network communications.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1395,7 +1394,7 @@ teamtwo:*:1100:jru,db</screen>
<para>In this example, the argument to <option>-m</option> is a <para>In this example, the argument to <option>-m</option> is a
comma-delimited list of users who are to be added to the comma-delimited list of users who are to be added to the
group. Unlike the previous example, these users are appended group. Unlike the previous example, these users are appended
to the group list and do not replace the list of existing to the group and do not replace existing
users in the group.</para> users in the group.</para>
<example> <example>

View file

@ -1,15 +0,0 @@
#
# Build the Handbook with just the content from this chapter.
#
# $FreeBSD$
#
CHAPTERS= users/chapter.xml
VPATH= ..
MASTERDOC= ${.CURDIR}/../${DOC}.${DOCBOOKSUFFIX}
DOC_PREFIX?= ${.CURDIR}/../../../..
.include "../Makefile"

File diff suppressed because it is too large Load diff