[patch] en/handbook/ports: a tiny cleanup
Hi, folks. A couple of noticed typos in $subj are in an attacment. Thanks. -- Best regards, Taras Korenko --- head/en_US.ISO8859-1/books/handbook/ports/chapter.xml 2013-03-21 20:07:53.0 +0200 +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.up.xml 2013-03-21 20:10:05.0 +0200 @@ -204,7 +204,7 @@ related to the application or install ports-mgmt/portaudit. Once installed, type portaudit -F -a to check - all installed applications for known vulnerabilities + all installed applications for known vulnerabilities. The remainder of this chapter explains how to use packages @@ -279,7 +279,7 @@ search name=program-name where program-name is the name of - the software. For example,to search for + the software. For example, to search for lsof: &prompt.root; cd /usr/ports @@ -1784,9 +1784,7 @@ ports-mgmt/pkg_cutleaves automates the task of removing installed ports that are no longer - needed. - - port. + needed. ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: [patch] en/handbook/ports: a tiny cleanup
> ... > A couple of noticed typos in $subj are in an attacment. > ... I'm sorry, folks, I should have to state this more clearly last night: please, commit it, since I'm not allowed to make mess anywhere outside doc/ru/* :-/ -- Best regards, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
[rfc,patch] en/handbook/kernelconfig: add a link to man page
Good morning, folks. I suppose it's worth adding unfairly forgotten &man.config.5; to the handbook/kernelconfig chapter. The proposed statement follows (applicable to r41334): --- handbook/kernelconfig/chapter.xml2013-04-01 18:09:07.0 +0300 +++ handbook/kernelconfig/chapter.up.xml 2013-04-01 18:02:24.0 +0300 @@ -490,13 +490,16 @@ Using this method, the local configuration file expresses local differences from a GENERIC kernel. As upgrades are performed, new features added to GENERIC will be also be added to the local kernel unless they are specifically prevented using nooptions or nodevice. - The remainder of this chapter addresses the contents of a + A comprehensive list of configuration directives may be found in + the &man.config.5;. + +The remainder of this chapter addresses the contents of a typical configuration file and the role various options and devices play. To build a file which contains all available options, run the following command as root: p.s.: no kidding despite Apr. 1st. -- Best regards, Taras Korenko pgpykXrML0Zff.pgp Description: PGP signature
Re: translating a BSD documentation page
On Thu, Apr 11, 2013 at 05:12:42AM -0700, Fabio Bovelacci wrote: > Dear FreeBSD doc mailing list, > > I'd like to translate one of your documents in italian. > (http://www.freebsd.org/doc/en/articles/bsdl-gpl/article.html) > Where do I send it after the translation? Should I send it back to you to be > submitted to the FreeBSD page? > > Thanks in advance for your reply. Try to join The FreeBSD Italian Documentation Project: http://www.freebsd.org/docproj/translations.html#italian . -- Best regards, Taras Korenko, NOC, UkrCom ISP, +380 44 2055570 ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
[patch] en/handbook/ports: another small cleanup
Hi, folks. Could anyone of doc@ review/comment/approve the following small changes to en/books/handbook/ports ? 1) An obvious chunk: Index: en_US.ISO8859-1/books/handbook/ports/chapter.xml === --- en_US.ISO8859-1/books/handbook/ports/chapter.xml(revision 41406) +++ en_US.ISO8859-1/books/handbook/ports/chapter.xml(working copy) @@ -116,7 +116,7 @@ commands. Both packages and ports understand - dependencies. If &man.pkg.add.1; or the + dependencies. If &man.pkg.add.1; or the Ports Collection is used to install an application and a dependent library is not already installed, the library will automatically be installed first. @@ -1337,7 +1337,7 @@ Once the compile is complete, you are returned to the prompt. The next step is to install the port using - make install: + make install: &prompt.root; make install ===> Installing for lsof-4.57 @@ -1670,22 +1670,22 @@ Root ports: no dependencies and is not depended on - by other ports + by other ports; Trunk ports: no dependencies, but other ports depend - upon it + upon it; Branch ports: have dependencies and are depended - upon by other ports + upon by other ports; Leaf ports: have dependencies but are not depended - upon by other ports + upon by other ports. 2) A controversial one: Index: en_US.ISO8859-1/books/handbook/ports/chapter.xml === --- en_US.ISO8859-1/books/handbook/ports/chapter.xml(revision 41406) +++ en_US.ISO8859-1/books/handbook/ports/chapter.xml(working copy) @@ -1778,7 +1778,8 @@ The portsclean utility is part of the - portupgrade suite. + ports-mgmt/portupgrade + suite. http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: translating a BSD documentation page
On Thu, Apr 11, 2013 at 11:15:49AM -0400, Eitan Adler wrote: > On 11 April 2013 11:00, Taras Korenko wrote: > > On Thu, Apr 11, 2013 at 05:12:42AM -0700, Fabio Bovelacci wrote: > >> Dear FreeBSD doc mailing list, > >> > >> I'd like to translate one of your documents in italian. > >> (http://www.freebsd.org/doc/en/articles/bsdl-gpl/article.html) > >> Where do I send it after the translation? Should I send it back to you to > >> be submitted to the FreeBSD page? > >> > >> Thanks in advance for your reply. > > > > Try to join The FreeBSD Italian Documentation Project: > > http://www.freebsd.org/docproj/translations.html#italian . > > +1. > > If you don't get a reply there let us know, and provide the > translation to the mailing list. > The following conclusion is based solely on VCS commit activity in it_IT.ISO8859-15/ branch of our doc/ repository. It was not intended to blame anyone. r38820 was taken as a reference point (that revision is equivalent to the last CVS commit to the doc repo [1]). There were no commits for >= 5 years [2] marked as 'Obtained from The FreeBSD Italian Documentation Project'. That may indicate inactivity of translation team. If so, then I. I apologize for providing incorrect advice; II. Fabio, my opinion: you might try to join FDP team directly and/or to start Italian Documentation Project by your own. -- 1. http://www.freebsd.org/doc/en_US.ISO8859-1/articles/committers-guide/subversion-primer.html 2. http://pastebin.ca/2369093 -- Best regards, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: Committing Handbook updates
On Wed, May 22, 2013 at 10:35:50AM -0600, Warren Block wrote: > ... > As I understand it, we are still in doc slush. When is that planned to > end? > ... The finished events: [1], [2]. AFAIK, there are no other doc slushes. 1. http://docs.freebsd.org/cgi/getmsg.cgi?fetch=112829+0+/usr/local/www/db/text/2013/freebsd-doc/20130407.freebsd-doc 2. http://docs.freebsd.org/cgi/getmsg.cgi?fetch=94449+0+/usr/local/www/db/text/2013/freebsd-doc/20130519.freebsd-doc -- Best regards, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: wrong: Last modified on April 2000 by . in porters handbook
On Wed, Jun 19, 2013 at 12:59:43PM +0100, Anton Shterenlikht wrote: > http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/index.html > > says: > > Last modified on April 2000 by . > ... because is 'hardcoded'. A workaround is: % svn diff en_US.ISO8859-1/books/porters-handbook/book.xml Index: en_US.ISO8859-1/books/porters-handbook/book.xml === --- en_US.ISO8859-1/books/porters-handbook/book.xml (revision 41948) +++ en_US.ISO8859-1/books/porters-handbook/book.xml (working copy) @@ -18,7 +18,7 @@ The FreeBSD Documentation Project -April 2000 +$FreeBSD$ 2000 -- Best regards, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: KyivBSD'13 conference
On Thu, Aug 01, 2013 at 02:07:42PM +0300, Alexander Yerenkow wrote: > Hello there! > Can someone add info about upcoming conference to site and schedule? > ... Done. -- WBR, Taras Korenko pgpgoKHoLoEGk.pgp Description: PGP signature
Re: two chapter 22 in FreeBSD Handbook Revision 42118
On Thu, Sep 19, 2013 at 09:12:24AM -0800, Cyril wrote: > Hello! > > Regarding the table of contents of the FreeBSD handbook, i see that the > chapter 22 is about Virtualization. > But with this link > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/vinum-vinum.html > vinum chapter is also the chapter 22. > And the vinum chapter is not on the table of contents. > > I'm wrong? Nope. That's a stale webpage (vinum-vinum.html). A short explanation may be found in the following post: http://lists.freebsd.org/pipermail/freebsd-doc/2013-September/022562.html -- WBR, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
[patch] Re: docs/177056: typo in link in handbook section 31.4.16
The following reply was made to PR docs/177056; it has been noted by GNATS. From: Taras Korenko To: bug-follo...@freebsd.org Cc: Subject: [patch] Re: docs/177056: typo in link in handbook section 31.4.16 Date: Mon, 28 Oct 2013 00:22:49 +0200 --gBBFr7Ir9EOA20Yy Content-Type: text/plain; charset=koi8-u Content-Disposition: inline There're extraneous characters in freebsd-xhtml-common.xsl XSL template. -- WBR, Taras Korenko --gBBFr7Ir9EOA20Yy Content-Type: text/x-diff; charset=koi8-u Content-Disposition: attachment; filename="f-x-c.xsl.diff" --- share/xsl/freebsd-xhtml-common.xsl.orig2013-10-27 23:56:39.0 +0200 +++ share/xsl/freebsd-xhtml-common.xsl 2013-10-27 23:57:01.0 +0200 @@ -195,7 +195,7 @@ http://www.FreeBSD.org/cgi/man.cgi?query= -&sektion= +&sektion= --gBBFr7Ir9EOA20Yy-- ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: Developers' Handbook on the web server
On Tue, Oct 29, 2013 at 02:57:55PM -0600, Warren Block wrote: > ... > Also: > "Last modified on August 2000 by ." > ... may be simply fixed with: Index: en_US.ISO8859-1/books/developers-handbook/book.xml === --- en_US.ISO8859-1/books/developers-handbook/book.xml (revision 43072) +++ en_US.ISO8859-1/books/developers-handbook/book.xml (working copy) @@ -16,7 +16,7 @@ The FreeBSD Documentation Project -August 2000 +$FreeBSD$ 2000 -- WBR, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
en/handbook/users: proposed corrections
Good day, doc@ folks. I'd like to introduce some corrections to handbook/users chapter. However, there might be moot points, so any comments will be appreciated. Thanks. -- WBR, Taras Korenko Index: en_US.ISO8859-1/books/handbook/users/chapter.xml === --- en_US.ISO8859-1/books/handbook/users/chapter.xml (revision 43253) +++ en_US.ISO8859-1/books/handbook/users/chapter.xml (working copy) @@ -78,8 +78,8 @@ The user name is typed at the login: - prompt. User names must be unique on the system as no two - users can have the same user name. There are a number of + prompt. User names must be unique on the system. + There are a number of rules for creating valid user names, documented in &man.passwd.5;. Typically user names consist of eight or fewer all lower case characters in order to maintain @@ -91,9 +91,8 @@ Password - Each account has an associated password. While the - password can be blank, this is highly discouraged and - every account should have a password. + Each account has an associated password. The password can be + blank, however this is highly discouraged. @@ -149,7 +148,7 @@ By default &os; does not force users to change their - passwords periodically. Password expiration can be + passwords. Password expiration can be enforced on a per-user basis, forcing some or all users to change their passwords after a certain amount of time has elapsed. @@ -377,7 +376,7 @@ /usr/share/skel skeleton directory - &man.adduser.8; is a simple program for adding new users + &man.adduser.8; is a simple program for adding new users. When a new user is added, this program automatically updates /etc/passwd and /etc/group. It also creates a home @@ -527,7 +526,7 @@ When passed no options, aside from an optional username, &man.chpass.1; displays an editor containing user information. - When the user exists from the editor, the user database is + When the user exits from the editor, the user database is updated with the new information. @@ -773,8 +772,7 @@ this limit too small may hinder a user's productivity as it is often useful to be logged in multiple times or to execute pipelines. Some tasks, such as compiling a large - program, spawn multiple processes and other intermediate - preprocessors. + program, spawn lots of processes. @@ -818,7 +816,7 @@ The limit on the amount of network memory, and - thus mbufssbsizelimiting userssbsize, a user may consume in order to limit network + thus mbufssbsizelimiting userssbsize, a user may consume. This can be generally used to limit network communications. @@ -960,7 +958,7 @@ In this example, the argument to -m is a comma-delimited list of users who are to be added to the group. Unlike the previous example, these users are appended to the - group list and do not replace the list of existing users in the + group and do not replace the list of existing users in the group. pgpBU22JwQHha.pgp Description: PGP signature
Re: en/handbook/users: proposed corrections
There's a second lap, which includes received suggestions. -- WBR, Taras Korenko Index: en_US.ISO8859-1/books/handbook/users/chapter.xml === --- en_US.ISO8859-1/books/handbook/users/chapter.xml (revision 43259) +++ en_US.ISO8859-1/books/handbook/users/chapter.xml (working copy) @@ -78,8 +78,8 @@ The user name is typed at the login: - prompt. User names must be unique on the system as no two - users can have the same user name. There are a number of + prompt. Each user must have a unique user name. + There are a number of rules for creating valid user names, documented in &man.passwd.5;. Typically user names consist of eight or fewer all lower case characters in order to maintain @@ -91,9 +91,7 @@ Password - Each account has an associated password. While the - password can be blank, this is highly discouraged and - every account should have a password. + Each account has an associated password. @@ -148,9 +146,9 @@ Password change time - By default &os; does not force users to change their - passwords periodically. Password expiration can be - enforced on a per-user basis, forcing some or all users to + By default, passwords do not expire. + However, password expiration can be + enabled on a per-user basis, forcing some or all users to change their passwords after a certain amount of time has elapsed. @@ -377,7 +375,7 @@ /usr/share/skel skeleton directory - &man.adduser.8; is a simple program for adding new users + &man.adduser.8; is a simple program for adding new users. When a new user is added, this program automatically updates /etc/passwd and /etc/group. It also creates a home @@ -527,7 +525,7 @@ When passed no options, aside from an optional username, &man.chpass.1; displays an editor containing user information. - When the user exists from the editor, the user database is + When the user exits from the editor, the user database is updated with the new information. @@ -773,8 +771,7 @@ this limit too small may hinder a user's productivity as it is often useful to be logged in multiple times or to execute pipelines. Some tasks, such as compiling a large - program, spawn multiple processes and other intermediate - preprocessors. + program, start lots of processes. @@ -818,7 +815,7 @@ The limit on the amount of network memory, and - thus mbufssbsizelimiting userssbsize, a user may consume in order to limit network + thus mbufssbsizelimiting userssbsize, a user may consume. This can be generally used to limit network communications. @@ -960,7 +957,7 @@ In this example, the argument to -m is a comma-delimited list of users who are to be added to the group. Unlike the previous example, these users are appended to the - group list and do not replace the list of existing users in the + group and do not replace the list of existing users in the group. ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: en/handbook/users: proposed corrections
... and the last (previously unnoticed) chunk follows: -- WBR, Taras Korenko Index: en_US.ISO8859-1/books/handbook/users/chapter.xml === --- en_US.ISO8859-1/books/handbook/users/chapter.xml (revision 43259) +++ en_US.ISO8859-1/books/handbook/users/chapter.xml (working copy) @@ -984,7 +984,7 @@ There are several ways to do things as the superuser. The worst way is to log in as root directly. - Usually very little activity requires root + Usually very little activity requires superuser privileges, so logging off and logging in as root, performing tasks, then logging off and on again as a normal user is a waste of time. @@ -991,8 +991,8 @@ A better way is to use &man.su.1; without providing a login but using - to inherit the root environment. - Not providing a login will imply super user. For this to work - the login that must be in the wheel group. + Not providing a login will imply superuser. For this to work + the current user must belong to the wheel group. An example of a typical software installation would involve the administrator unpacking the software as a normal user and then elevating their privileges for the build and installation of @@ -1016,10 +1016,10 @@ Using &man.su.1; works well for single systems or small networks with just one system administrator. For more complex - environments (or even for these simple environments) - sudo should be used. It is provided as a port, - security/sudo. It allows for - things like activity logging, granting users the ability to only + environments + sudo might be used. It is available as a + security/sudo package or port. + sudo provides activity logging, granting users the ability to only run certain commands as the superuser, and several other options. ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: en/handbook/users: proposed corrections
Updated version of the second patch follows. P.S.: the funniest thing is that contents of users chapter was integrated into basics chapter in r42953, users chapter was removed (again r42953), and reappeared after db5 merge, updated with new subchapter () still being excluded from the build. So, next, I am to adapt current two patches to the new location: basics chapter :-/ -- WBR, Taras Korenko Index: en_US.ISO8859-1/books/handbook/users/chapter.xml === --- en_US.ISO8859-1/books/handbook/users/chapter.xml (revision 43259) +++ en_US.ISO8859-1/books/handbook/users/chapter.xml (working copy) @@ -984,7 +984,7 @@ There are several ways to do things as the superuser. The worst way is to log in as root directly. - Usually very little activity requires root + Very little activity requires superuser privileges, so logging off and logging in as root, performing tasks, then logging off and on again as a normal user is a waste of time. @@ -991,8 +991,8 @@ A better way is to use &man.su.1; without providing a login but using - to inherit the root environment. - Not providing a login will imply super user. For this to work - the login that must be in the wheel group. + Not providing a user name will imply superuser. For this to work + the current user must belong to the wheel group. An example of a typical software installation would involve the administrator unpacking the software as a normal user and then elevating their privileges for the build and installation of @@ -1014,12 +1014,12 @@ root is less painful than logging off and back on twice. -Using &man.su.1; works well for single systems or small +&man.su.1; works well for single systems or small networks with just one system administrator. For more complex - environments (or even for these simple environments) - sudo should be used. It is provided as a port, - security/sudo. It allows for - things like activity logging, granting users the ability to only + environments, + sudo is useful. It is available as a + security/sudo package or port. + sudo provides activity logging, granting users the ability to only run certain commands as the superuser, and several other options. ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: en/handbook/basics: proposed corrections
On Thu, Nov 28, 2013 at 04:59:30PM -0700, Warren Block wrote:
> ...
> > ...
> > So, next, I am to adapt current two patches to the new location:
> > basics chapter :-/
>
> I thought some of that looked familiar. My apologies, I just did a big
> whitespace cleanup to the basics chapter.
/* Well, a $subject was changed a bit... */
I'd like to introduce some corrections to "Users and Basic Account
Management" subchapter of "UNIX Basics" chapter of our Handbook.
Patches, that follow, summarize all the previous discussion and add
lost chunk of text ("Becoming Superuser") to handbook/basics chapter.
--
WBR, Taras Korenko
Index: en_US.ISO8859-1/books/handbook/basics/chapter.xml
===
--- en_US.ISO8859-1/books/handbook/basics/chapter.xml (revision 43259)
+++ en_US.ISO8859-1/books/handbook/basics/chapter.xml (working copy)
@@ -428,8 +428,7 @@
The user name is typed at the
- login: prompt. User names must be
- unique on the system as no two users can have the same
+ login: prompt. Each user must have a unique
user name. There are a number of rules for creating
valid user names which are documented in
&man.passwd.5;. It is recommended to use user names
@@ -443,9 +442,7 @@
Password
- Each user account should have an associated
- password. While the password can be blank, this is
- highly discouraged.
+ Each account has an associated password.
@@ -496,9 +493,8 @@
Password change time
- By default, &os; does not force users to change
- their passwords periodically. Password expiration can
- be enforced on a per-user basis using &man.pw.8;,
+ By default, passwords do not expire. However, password
+ expiration can be enabled on a per-user basis,
forcing some or all users to change their passwords
after a certain amount of time has elapsed.
@@ -868,7 +864,7 @@
When passed no options, aside from an optional username,
&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.
@@ -1165,8 +1161,8 @@
&man.sysctl.8;. Setting this limit too small may hinder
a user's productivity as it is often useful to be logged
in multiple times or to execute pipelines. Some tasks,
- such as compiling a large program, spawn multiple
- processes and other intermediate preprocessors.
+ such as compiling a large program, start lots of
+ processes.
@@ -1241,7 +1237,7 @@
limiting users
sbsize
,
- a user may consume in order to limit network
+ a user may consume. This can be generally used to limit network
communications.
@@ -1395,7 +1391,7 @@
In this example, the argument to -m is a
comma-delimited list of users who are to be added to the
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.
Index: en_US.ISO8859-1/books/handbook/basics/chapter.xml
===
--- en_US.ISO8859-1/books/handbook/basics/chapter.xml (revision 43259)
+++ en_US.ISO8859-1/books/handbook/basics/chapter.xml (working copy)
@@ -1410,6 +1410,50 @@
/etc/group, refer to &man.pw.8; and
&man.group.5;.
+
+
+ Becoming Superuser
+
+ There are several ways to do things as the superuser. The
+ worst way is to log in as root
+ directly. Very little activity requires superuser privileges,
+ so logging off and logging in as root,
+ performing tasks, then logging off and on again as a normal user
+ is a waste of time.
+
+ A better way is to use &man.su.1; without providing a login
+ but using - to inherit the root environment.
+ Not providing a user name will imply superuser. For this to work
+ the current user must belong to the wheel group.
+ An example of a typical software installation would involve the
+ administrator unpacking the software as a normal user and then
+ elevating their privileges for the build and installation of
+ the software.
+
+
+ Install a Program As The Superuser
+
+ &prompt.user; configure
+&prompt.user; make
+&prompt.user; su -
+Password:
+&prompt.root; make install
+&prompt.root; exit
+&prompt.user;
+
+
+ Note in this example the transition to
+ root is less painful than
+ logging off and back on twice.
+
+ &man.su.1; works well for single systems or small networks with
+ just one system administrator. For more complex environments,
+ sudo is useful. It is available as a
+ security/
en/handbook/basics: proposed corrections #2
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 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 UID. 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. + recommended to use a UID less than 65535, since higher + values may cause compatibility issues with some + software. + @@ -486,7 +488,7 @@ mechanism that provide additional flexibility when tailoring the system to different users. Login classes are discussed further in - + . @@ -522,7 +524,7 @@ 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. @@ -637,7 +639,7 @@ &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. @@ -714,7 +716,7 @@ /usr/share/skel, and can optionally mail the new user a welcome message. This utility must be run as the - superuser. + superuser. 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 wheel 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. + Adding a User on &os; ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: en/handbook/basics: proposed corrections #2
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 @@ > > &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. > > 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 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 UID. 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. + recommended to use a UID less than 65535, since higher + values may cause compatibility issues with some + software. @@ -486,7 +486,7 @@ mechanism that provide additional flexibility when tailoring the system to different users. Login classes are discussed further in - + . @@ -522,7 +522,7 @@ 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. @@ -637,7 +637,7 @@ &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. @@ -714,7 +714,7 @@ /usr/share/skel, and can optionally mail the new user a welcome message. This utility must be run as the - superuser. + superuser. 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 wheel 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. ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: docs/185481: sh/bash Parameter Expansion +/- syntax not documented
The following reply was made to PR docs/185481; it has been noted by GNATS.
From: Taras Korenko
To: freebsd-gnats-sub...@freebsd.org
Cc:
Subject: Re: docs/185481: sh/bash Parameter Expansion +/- syntax not
documented
Date: Sun, 5 Jan 2014 12:30:13 +0200
On Sat, Jan 04, 2014 at 07:45:19PM -0800, Ronald F.Guilmette wrote:
> ...
> ${parameter-word}
> ${parameter+word}
>
> These forms are not however documented in the "Parameter Expansion"
> sections of either the man page for sh or the man page for bash.
> ...
"In the parameter expansions shown previously, use of the colon in the
format results in a test for a parameter that is unset or null; omission
of the colon results in a test for a parameter that is only unset."
(c) sh(1) under "Parameter Expansion" section (also on web -> [1]).
--
1.
http://www.freebsd.org/cgi/man.cgi?query=sh&apropos=0&sektion=1&manpath=FreeBSD+9.2-RELEASE&arch=default&format=html
--
WBR, Taras Korenko
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
en/handbook/kernelconfig: proposed corrections
Good morning, doc@ folks. The following notes were made while working on russian translation of kernelconfig chapter. I hope some parts of the following diff might be useful. So, could anyone review that diff? -- WBR, Taras Korenko Index: en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml === --- en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml (revision 43745) +++ en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml (working copy) @@ -204,8 +204,8 @@ &man.pciconf.8;, which provides more verbose output. For example: -pciconf -lv -ath0@pci0:3:0:0:class=0x02 card=0x058a1014 chip=0x1014168c rev=0x01 hdr=0x00 +&prompt.user; pciconf -lv +ath0@pci0:3:0:0:class=0x02 card=0x058a1014 chip=0x1014168c rev=0x01 hdr=0x00 vendor = 'Atheros Communications Inc.' device = 'AR5212 Atheros AR5212 802.11abg wireless' class = network @@ -226,7 +226,7 @@ ath_hal(4) - Atheros Hardware Access Layer (HAL) Once the hardware inventory list is created, refer to it - to ensure that installed hardware is not removed as you edit the custom + to ensure that drivers for installed hardware are not removed as you edit the custom kernel configuration file. @@ -250,11 +250,7 @@ If /usr/src/ does not exist or it is empty, source has not been installed. Source can be installed using - svn, which is described in , or by installing the - src distribution using &man.sysinstall.8;. This - distribution can be selected by navigating to the - Configuration and then to the - Distributions menu within &man.sysinstall.8;. + svn, which is described in . Once source is installed, review the contents of /usr/src/sys. This directory contains a number of subdirectories, including those which represent the following @@ -350,7 +346,7 @@ To build a file which contains all available options, run the following command as root: - &prompt.root; cd /usr/src/sys/i386/conf && make LINT + &prompt.root; cd /usr/src/sys/arch/conf && make LINT @@ -521,10 +517,10 @@ options SCSI_DELAY=5000 # Delay (in ms) before probing SCSI This causes the kernel to pause for 5 seconds before probing - each SCSI device in the system. If the system only has IDE hard - drives, ignore this or lower the number to speed up booting. - However, if &os; has trouble recognizing the SCSI devices, the - number will have to be raised again. + each SCSI device in the system. If &os; has trouble recognizing + the SCSI devices, the number will have to be raised. On the + other hand, if the system has only IDE hard drives, ignore this + or lower the number to speed up booting. options KTRACE# ktrace(1) support @@ -577,7 +573,7 @@ processors. - This device exists only on the i386 architecture and this + This device exists only on the &i386; architecture and this configuration line should not be used on other architectures. @@ -743,8 +739,7 @@ The &man.vga.4; video card driver. - -device splash # Splash screen and screen saver support +device splash # Splash screen and screen saver support Required by the boot splash screen and screen savers. @@ -926,7 +921,7 @@ #device le ISA Ethernet drivers. See - /usr/src/sys/i386/conf/NOTES + /usr/src/sys/arch/conf/NOTES for details of which cards are supported by which driver. # Wireless NIC cards @@ -1065,7 +1060,7 @@ For more information and additional devices supported by &os;, see - /usr/src/sys/i386/conf/NOTES. + /usr/src/sys/arch/conf/NOTES. Large Memory Configurations ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: en/handbook/kernelconfig: proposed corrections
On Wed, Feb 05, 2014 at 12:37:48AM +0400, Sergey Kandaurov wrote: > On Tue, Feb 04, 2014 at 12:16:04PM +0200, Taras Korenko wrote: > > ... > > So, could anyone review that diff? > > Hi, see my 2c inline. > > > Index: en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml > > === > > --- en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml (revision 43745) > > +++ en_US.ISO8859-1/books/handbook/kernelconfig/chapter.xml (working copy) > > ... > > @@ -226,7 +226,7 @@ > > ath_hal(4) - Atheros Hardware Access Layer > > (HAL) > > > > Once the hardware inventory list is created, refer to it > > - to ensure that installed hardware is not removed as you edit the > > custom > > + to ensure that drivers for installed hardware are not removed as you > > edit the custom > Or rather "drivers OR installed hardware"? :) Both may be removed I guess. I guess user's task at this moment is to create a subset from all available drivers, noone is to add/pull_out NICs, videocards, etc... > > >kernel configuration file. > > > > > > @@ -250,11 +250,7 @@ > >If /usr/src/ does > > not exist or it is empty, source has not been installed. > > Source can be installed using > > - svn, which is described in > linkend="svn"/>, or by installing the > > - src distribution using &man.sysinstall.8;. This > > - distribution can be selected by navigating to the > > - Configuration and then to the > > - Distributions menu within &man.sysinstall.8;. > > + svn, which is described in > linkend="svn"/>. > You removed reference to sysinstall, but it is still in use in 9.x and 8.x > (well ok, only in 8.x but it also exists in 9.x). > If you want to touch this place, I would suggest to specify &os; version > this is applicable for and briefly mention bsdinstall with referring to > . It would be fine with simply > removing sysinstall part, but this leaves the reader without options. Well, OS 8.X: sysinstall allows us to install sources. OS 9.X: according to our hb, sysinstall is deprecated. Bsdinstall cannot install sources because it does not have such a post-install procedure. OS 10.X: we've svnlite (but cannot refer to it's man page). So, we've to provide detailed description of all available options, or keep just one. > ... -- WBR, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: new doceng member
On Wed, Feb 05, 2014 at 04:25:01PM +0900, Hiroki Sato wrote: > ... > Please welcome Warren Block as a new doceng > member. > ... It's a bit late, but, anyway: congratulations, Warren. -- WBR, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: Possible typo on doc/handbook/ports-using.html ?
On Mon, Feb 10, 2014 at 08:54:49PM -0800, Jason Helfman wrote: > > > On Feb 9, 2014, at 4:49 PM, Lampros Chaidas wrote: > > > > Hi there, > > > > I was just reading through the documentation for getting the ports > > collection with the subversion method and noticed the following in > > "Procedure 5.2. Subversion Method" - the link is > > http://www.freebsd.org/doc/handbook/ports-using.html > > > > "If the ports tree is not available, Subversion can be installed as > > a package: > > # pkg install subversion > > If pkgng is being used to manage packages, Subversion can be > > installed with it instead: > > # pkg install subversion" > > > > It looks like it's the same command in both situations - this looks > > redundant to me, is there a difference here that maybe I'm missing? > > > > Thanks, > > - Lampros > > Both statements are true, however I believe this can be reworded and > condensed. > > I'll put together a patch. That was introduced in [1] as an attempt to clear texts from mentioning our old package management system (aka pkg_install). 1. http://svnweb.freebsd.org/doc/head/en_US.ISO8859-1/books/handbook/ports/chapter.xml?r1=43693&r2=43747 -- WBR, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: docs/187215: Want to update Russian FreeBSD Handbook translation, how to do that?
The following reply was made to PR docs/187215; it has been noted by GNATS. From: Taras Korenko To: bug-follo...@freebsd.org, blueboa...@rambler.ru Cc: Subject: Re: docs/187215: Want to update Russian FreeBSD Handbook translation, how to do that? Date: Tue, 4 Mar 2014 17:23:28 +0200 The best way would be to get PRs, containing (svn)diffs relative to (outdated) XML source files. -- WBR, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
en/handbook/audit: proposed corrections
Good day, doc@ folks. There're a few things that could be improved within audit chapter of our handbook. However, those are just notes, which might require more polishing or wordsmithing. So, can anyone review and/or comment the following *.diff? Thanks. -- WBR, Taras Korenko Index: en_US.ISO8859-1/books/handbook/audit/chapter.xml === --- en_US.ISO8859-1/books/handbook/audit/chapter.xml (revision 44380) +++ en_US.ISO8859-1/books/handbook/audit/chapter.xml (working copy) @@ -196,8 +196,10 @@ Audit Configuration User space support for event auditing is installed as part - of the base &os; operating system. Kernel support can be - enabled by adding the following line to + of the base &os; operating system. Kernel support is available + in GENERIC kernel by default, + an &man.auditd.8; can be enabled + by adding the following line to /etc/rc.conf: auditd_enable="YES" @@ -217,10 +219,7 @@ Selection expressions are used in a number of places in the audit configuration to determine which events should be audited. Expressions contain a list of event classes to - match, each with a prefix indicating whether matching records - should be accepted or ignored, and optionally to indicate if - the entry is intended to match successful or failed - operations. Selection expressions are evaluated from left to + match. Selection expressions are evaluated from left to right, and two expressions are combined by appending one onto the other. @@ -383,10 +382,9 @@ These audit event classes may be customized by modifying - the audit_class and audit_ - event configuration files. + the audit_class and audit_event configuration files. - Each audit event class is combined with a prefix + Each audit event class may be combined with a prefix indicating whether successful/failed operations are matched, and whether the entry is adding or removing matching for the class and type. summarizes @@ -650,8 +648,8 @@ Since audit logs may be very large, a subset of records can be selected using auditreduce. This example selects all audit records produced for the user - trhodes stored in - AUDITFILE: + trhodes stored in + AUDITFILE: &prompt.root; auditreduce -u trhodes /var/audit/AUDITFILE | praudit @@ -739,8 +737,8 @@ Automatic rotation of the audit trail file based on file size is possible using filesz in - audit.control as described in . + audit_control as described in . As audit trail files can become very large, it is often desirable to compress or otherwise archive trails once they ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: en/handbook/audit: proposed corrections
On Mon, Mar 31, 2014 at 06:28:41AM -0700, Dru Lavigne wrote: > ___ > > > From: Taras Korenko > >To: freebsd-doc@freebsd.org > >Sent: Saturday, March 29, 2014 12:19 PM > >Subject: en/handbook/audit: proposed corrections > > > > ... However, those are just notes, which might require more polishing > >or wordsmithing. So, can anyone review and/or comment the following *.diff? > > ... > A slightly modified patch is attached. If it is acceptable to you, I can > commit it. > ... No objections; please, commit it. > Cheers, > > Dru > Index: chapter.xml > === > --- chapter.xml (revision 44393) > +++ chapter.xml (working copy) > @@ -196,8 +196,10 @@ > Audit Configuration > > User space support for event auditing is installed as part > - of the base &os; operating system. Kernel support can be > - enabled by adding the following line to > + of the base &os; operating system. Kernel support is available > + in the GENERIC kernel by default, > + and &man.auditd.8; can be enabled > + by adding the following line to >/etc/rc.conf: > > auditd_enable="YES" > @@ -217,10 +219,7 @@ >Selection expressions are used in a number of places in > the audit configuration to determine which events should be > audited. Expressions contain a list of event classes to > - match, each with a prefix indicating whether matching records > - should be accepted or ignored, and optionally to indicate if > - the entry is intended to match successful or failed > - operations. Selection expressions are evaluated from left to > + match. Selection expressions are evaluated from left to > right, and two expressions are combined by appending one onto > the other. > > @@ -383,10 +382,10 @@ > > >These audit event classes may be customized by modifying > - the audit_class and audit_ > - event configuration files. > + the audit_class and > + audit_event configuration files. > > - Each audit event class is combined with a prefix > + Each audit event class may be combined with a prefix > indicating whether successful/failed operations are matched, > and whether the entry is adding or removing matching for the > class and type. summarizes > @@ -650,8 +649,8 @@ > Since audit logs may be very large, a subset of records can >be selected using auditreduce. This example >selects all audit records produced for the user > - trhodes stored in > - AUDITFILE: > + trhodes stored in > + AUDITFILE: > > &prompt.root; auditreduce -u > trhodes > /var/audit/AUDITFILE | praudit > > @@ -739,8 +738,8 @@ > >Automatic rotation of the audit trail file based on file > size is possible using filesz in > - audit.control as described in - linkend="audit-config"/>. > + audit_control as described in + linkend="audit-auditcontrol"/>. > >As audit trail files can become very large, it is often > desirable to compress or otherwise archive trails once they P.S.: thanks for your huge work on the Handbook. -- WBR, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: Mistake in handbook 23.6 Rebuilding world
On Wed, Apr 09, 2014 at 09:06:35AM -0400, Kevin Thompson wrote: > Howdy folks, > > I think there is a mistake in this document: > http://www5.us.freebsd.org/doc/handbook/makeworld.html > > In: > - Section 23.6.1 "Overview of Process" > - Procedure 23.2 "Overview of Build World Process" > - Step 9 "Update any remaining configuration files." > > the command line given for mergemaster is 'mergemaster -p' - this looks > like copy-pasta from step 7, that command line option isn't appropriate > for /finishing/ the config merge. Please check the main web site, it is refreshed more often: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html > ... -- WBR, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: Some translated pages
On Mon, Oct 13, 2014 at 09:31:20AM +0300, Dmitry Luhtionov wrote: > ru_RU.KOI8-R/share/xml/ru_RU.KOI8-R/share/xml/header.l10n.ent This one seems to be lost ^^^, > and > ru_RU.KOI8-R/htdocs/index.xsl and this one (with slight modifications) was committed [1]. Thanks. 1. http://svnweb.freebsd.org/doc?view=revision&revision=45817 -- WBR, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: Ukrainian documentation translation
On Sat, Jul 11, 2015 at 02:50:09PM +, Andrej Solonenko via freebsd-doc wrote: > Hi, I'm going to start translating the documentation into Ukrainian and I > will appreciate any advice regarding the first steps. You might start reading FDP Primer: http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ The same question was raised earlier (at least twice): http://lists.freebsd.org/pipermail/freebsd-doc/2012-March/019651.html http://lists.freebsd.org/pipermail/freebsd-doc/2014-May/023723.html -- WBR, Taras Korenko ___ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
