From owner-svn-src-all@FreeBSD.ORG Sat Oct 6 06:07:34 2012 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 37A841065672; Sat, 6 Oct 2012 06:07:33 +0000 (UTC) (envelope-from joel@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id C06328FC12; Sat, 6 Oct 2012 06:07:33 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q9667X7l009805; Sat, 6 Oct 2012 06:07:33 GMT (envelope-from joel@svn.freebsd.org) Received: (from joel@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q9667Xex009803; Sat, 6 Oct 2012 06:07:33 GMT (envelope-from joel@svn.freebsd.org) Message-Id: <201210060607.q9667Xex009803@svn.freebsd.org> From: Joel Dahl Date: Sat, 6 Oct 2012 06:07:33 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r241243 - head/usr.sbin/sysrc X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 06 Oct 2012 06:07:34 -0000 Author: joel (doc committer) Date: Sat Oct 6 06:07:33 2012 New Revision: 241243 URL: http://svn.freebsd.org/changeset/base/241243 Log: mdoc: begin sentences on a new line. Modified: head/usr.sbin/sysrc/sysrc.8 Modified: head/usr.sbin/sysrc/sysrc.8 ============================================================================== --- head/usr.sbin/sysrc/sysrc.8 Sat Oct 6 06:02:29 2012 (r241242) +++ head/usr.sbin/sysrc/sysrc.8 Sat Oct 6 06:07:33 2012 (r241243) @@ -98,7 +98,8 @@ Show only variable values, not their nam .It Fl N Show only variable names, not their values. .It Fl q -Quiet. Ignore previous +Quiet. +Ignore previous .Fl v and/or .Ev SYSRC_VERBOSE . @@ -108,7 +109,8 @@ Operate within the root directory rather than .Pq Sq / . .It Fl v -Verbose. Print the pathname of the specific +Verbose. +Print the pathname of the specific .Xr rc.conf 5 file where the directive was found. .It Fl x @@ -135,16 +137,20 @@ The list of system configuration files i .Ql /etc/defaults/rc.conf within the variable .Ql rc_conf_files , -which by-default contains a space-separated list of pathnames. On all FreeBSD -systems, this defaults to the value "/etc/rc.conf /etc/rc.conf.local". Each -pathname is sourced in-order upon startup. It is in the same fashion that +which by-default contains a space-separated list of pathnames. +On all FreeBSD +systems, this defaults to the value "/etc/rc.conf /etc/rc.conf.local". +Each +pathname is sourced in-order upon startup. +It is in the same fashion that .Nm sources the configuration files before returning the value of the given variable. .Pp When supplied a variable name, .Nm -will return the value of the variable. If the variable does not appear in any +will return the value of the variable. +If the variable does not appear in any of the configured .Ql rc_conf_files , an error is printed and error status is returned. @@ -152,13 +158,16 @@ an error is printed and error status is When changing values of a given variable, it does not matter if the variable appears in any of the .Ql rc_conf_files -or not. If the variable does not appear in any of the files, it is appended to +or not. +If the variable does not appear in any of the files, it is appended to the end of the first pathname in the .Ql rc_conf_files -variable. Otherwise, +variable. +Otherwise, .Nm will replace only the last-occurrence in the last-file found to contain the -variable. This gets the value to take effect next boot without heavily +variable. +This gets the value to take effect next boot without heavily modifying these integral files (yet taking care not to allow the file to grow unwieldy should .Nm @@ -176,7 +185,8 @@ Location of .Ql /etc/defaults/rc.conf file. .It Ev SYSRC_VERBOSE -Default verbosity. Set to non-NULL to enable. +Default verbosity. +Set to non-NULL to enable. .El .Sh DEPENDENCIES The following standard commands are required by