summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJim Meyering <meyering@redhat.com>2012-04-16 20:26:41 +0200
committerJim Meyering <meyering@redhat.com>2012-04-17 09:24:22 +0200
commit2bb1876c9aa926a96729acbb9e4ac1c44c1deae8 (patch)
treec09855b1011e7f1fbe06d9dd99065af928b3c6ba /doc
parent31f19d681f91347f0f4b9d4ed148b6aed996bf7e (diff)
downloadcoreutils-2bb1876c9aa926a96729acbb9e4ac1c44c1deae8.tar.xz
doc: use @xref{... only at start of a sentence
* doc/coreutils.texi: Correct many misuses of @xref.
Diffstat (limited to 'doc')
-rw-r--r--doc/coreutils.texi16
-rw-r--r--doc/perm.texi4
2 files changed, 11 insertions, 9 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 682536a18..416f0ba23 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -2366,7 +2366,7 @@ Double space the output.
@cindex time formats
@cindex formatting times
Format header dates using @var{format}, using the same conventions as
-for the command @samp{date +@var{format}}; @xref{date invocation}.
+for the command @samp{date +@var{format}}. @xref{date invocation}.
Except for directives, which start with
@samp{%}, characters in @var{format} are printed unchanged. You can use
this option to specify an arbitrary string in place of the header date,
@@ -4910,7 +4910,7 @@ all @sc{gnu} extensions and reverts to traditional mode, thus introducing some
limitations and changing several of the program's default option values.
When @option{-G} is not specified, @sc{gnu} extensions are always enabled.
@sc{gnu} extensions to @command{ptx} are documented wherever appropriate in this
-document. For the full list, see @xref{Compatibility in ptx}.
+document. @xref{Compatibility in ptx}, for the full list.
Individual options are explained in the following sections.
@@ -5047,8 +5047,9 @@ if it is listed in the Only file and not in the Ignore file.
On each input line, the leading sequence of non-white space characters will be
taken to be a reference that has the purpose of identifying this input
-line in the resulting permuted index. For more information about reference
-production, see @xref{Output formatting in ptx}.
+line in the resulting permuted index.
+@xref{Output formatting in ptx},
+for more information about reference production.
Using this option changes the default value for option @option{-S}.
Using this option, the program does not try very hard to remove
@@ -16000,7 +16001,7 @@ the @var{command}.
@opindex --signal
Send this @var{signal} to @var{command} on timeout, rather than the
default @samp{TERM} signal. @var{signal} may be a name like @samp{HUP}
-or a number. Also see @xref{Signal specifications}.
+or a number. @xref{Signal specifications}.
@end table
@cindex time units
@@ -16108,8 +16109,9 @@ number like @samp{1}, or an exit status of a process terminated by the
signal. A signal name can be given in canonical form or prefixed by
@samp{SIG}. The case of the letters is ignored, except for the
@option{-@var{signal}} option which must use upper case to avoid
-ambiguity with lower case option letters. For a list of supported
-signal names and numbers see @xref{Signal specifications}.
+ambiguity with lower case option letters.
+@xref{Signal specifications}, for a list of supported
+signal names and numbers.
@node Delaying
@chapter Delaying
diff --git a/doc/perm.texi b/doc/perm.texi
index 95de46a27..6c466f2bc 100644
--- a/doc/perm.texi
+++ b/doc/perm.texi
@@ -503,9 +503,9 @@ A numeric mode is usually shorter than the corresponding symbolic
mode, but it is limited in that normally it cannot take into account the
previous file mode bits; it can only set them absolutely.
The set-user-ID and set-group-ID bits of directories are an exception
-to this general limitation; @xref{Directory Setuid and Setgid}.
+to this general limitation. @xref{Directory Setuid and Setgid}.
Also, operator numeric modes can take previous file mode bits into
-account; @xref{Operator Numeric Modes}.
+account. @xref{Operator Numeric Modes}.
The permissions granted to the user,
to other users in the file's group,