Re: [PATCH] environ.7: srcfix in the manual

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hello Bjarne

On 02/20/2018 10:29 PM, Bjarni Ingi Gislason wrote:
   (There is a slight difference (italic correction) between the
formatted output from ".I" and ".IR" for uneven number of arguments.)

Can you explain in more detail what problem these patches
are supposed to fix?

Tanks,

Michael

Input file is environ.7

Test nr. 2: Fix warning from man/groff
Test nr. 14: Change a two-fonts macro to an one-font macro.

Input file is /tmp/environ.7

<standard input>:89 (macro BR): only 1 argument, but more are expected
<standard input>:93 (macro BR): only 1 argument, but more are expected
<standard input>:142 (macro IR): only 1 argument, but more are expected
<standard input>:148 (macro IR): only 1 argument, but more are expected
<standard input>:195 (macro BR): only 1 argument, but more are expected

chk_manuals: Output is from: test-groff -Tutf8 -b -e -mandoc -rF0 -t -w w -z

####

Test nr. 19: Use a macro to change to italic font

63:have the form "\fIname\fP\fB=\fP\fIvalue\fP".

#####

Test nr. 21: Avoid space at the beginning of a text line; use a
request or a macro to create the indent, or use "\&" where that cannot
be used

152:    NAME=value command

#####

   NO PATCH FOR THIS

Test nr. 29: Surround a block of comments with the macros ".ig" and "..".
The .\" at the beginning of each line is then not needed.

   Lines 1-33

Signed-off-by: Bjarni Ingi Gislason <bjarniig@xxxxxxxxx>
   ---
  man7/environ.7 | 17 ++++++++++-------
  1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/man7/environ.7 b/man7/environ.7
index d9d80129d..cd4d884d1 100644
--- a/man7/environ.7
+++ b/man7/environ.7
@@ -60,7 +60,9 @@ of its parent's environment.
  .PP
  By convention the strings in
  .I environ
-have the form "\fIname\fP\fB=\fP\fIvalue\fP".
+have the form "\c
+.IB name = value\c
+".
  Common examples are:
  .TP
  .B USER
@@ -86,11 +88,11 @@ or more specific environment variables such as
  .BR LC_MONETARY ,
  .BR LC_NUMERIC ,
  and
-.BR LC_TIME
+.B LC_TIME
  (see
  .BR locale (7)
  for further details of the
-.BR LC_*
+.B LC_*
  environment variables).
  .TP
  .B PATH
@@ -139,20 +141,21 @@ command if you use
  .PP
  The initial environment of the shell is populated in various ways,
  such as definitions from
-.IR /etc/environment
+.I /etc/environment
  that are processed by
  .BR pam_env (8)
  for all users at login time (on systems that employ
  .BR pam (8)).
  In addition, various shell initialization scripts, such as the system-wide
-.IR /etc/profile
+.I /etc/profile
  script and per-user initializations script may include commands
  that add variables to the shell's environment;
  see the manual page of your preferred shell for details.
  .PP
  Bourne-style shells support the syntax
  .PP
-    NAME=value command
+.ti +4n
+NAME=value command
  .PP
  to create an environment variable definition only in the scope
  of the process that executes
@@ -192,7 +195,7 @@ and other programs.
  .IP *
  .BR LD_LIBRARY_PATH ", " LD_PRELOAD ,
  and other
-.BR LD_*
+.B LD_*
  variables influence the behavior of the dynamic loader/linker.
  .IP *
  .B POSIXLY_CORRECT

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux