Commit Graph
1318 Commits
Author SHA1 Message Date
Jim Meyering ea32998672 . 2004-07-02 17:02:32 +00:00
Jim Meyering ebc78a4613 *** empty log message *** 2004-07-02 17:02:20 +00:00
Jim Meyering 57fcc427c0 (Common options, Target directory, cp invocation,
install invocation, mv invocation, ln invocation): Add -t as a
short option for --target-directory, and -T as a short option for
--no-target-directory.  Clean up relevant synopses a bit, so that
the language is similar for all.
2004-07-02 17:02:15 +00:00
Jim Meyering 6433f83ccb . 2004-07-02 16:34:40 +00:00
Jim Meyering 6119eaca83 Put the right amount of space at sentence ends.
Make sure "i.e." and "e.g." are followed by commas (the GNU style).
Put blank lines before and after every @example, prefer the
previous line to end in ":" (when not a sentence end, for consistency),
and prepend @noindent to the following line when appropriate.
In examples, use "--" arguments when needed to prevent undesired
interpretation of operands as options.
Use "file name" rather than "filename", as per the GNU coding standards.
Remove unwanted spaces before @footnote.
Use "---" when appropriate, instead of " -- ".
Use "name" (or something like that) rather than "path" or "pathname",
since the GNU coding standards don't allow "path".
Use @acronym, @command, @minus{}, @samp in a few places,
where appropriate.
(Target directory): Clarify description of example.
(fmt invocation): Give issue number for reference, and reword
for clarity.
(sort invocation): Note that xargs without -0 also mishandles
file names containing some special characters other than newline.
(Translating): Mention that \012 is not universally portable.
Use '\0' rather than '\000'.
(Squeezing): bourne -> Bourne.
Fix unportable usage of '\n' by replacing it with '[\n*]'.
(More details about version sort): Remove unnecessary indent
in examples.
(dd invocation): Use 'kill -s USR1', not 'kill -USR1', as POSIX
indicates that the former is more portable (the latter is an XSI
extension).
(shred invocation): Use @uref rather than @url, and use a more-typical
style for the date.
(kill invocation): Clarify usage; for example, "kill -s TERM -1"
isn't allowed.
(seq invocation): Reword to avoid implying that printf necessarily
fails for numbers outside the 32-bit range.  Prefer separating
options from their operands.
(Opening the software toolbox): Give an online reference to
Robbins's article, and give a date.  Don't imply that the
current documentation is unchanged from his article.
(Putting the tools together): Rework examples so that they don't
assume the C locale; nowadays many users now operate outside the C
locale by default.  While we're at it, don't assume ASCII either.
Indent example to match actual output from GNU uniq.  Remove some
unnecessary and confusing brackets from 'tr' operands.  "Software
Tools in Pascal" is back in print, according to Amazon anyway.
Add references to Kernighan's online copies of examples.
2004-07-02 16:29:50 +00:00
Jim Meyering 7c2ebb9f5b *** empty log message *** 2004-07-02 15:18:46 +00:00
Jim Meyering 0f9eb70e23 Fail upon use of @url. Use @uref instead. 2004-07-02 15:18:43 +00:00
Jim Meyering 6b46a1435c *** empty log message *** 2004-07-02 15:14:44 +00:00
Jim Meyering cb2e51e38a (check-texinfo): Fail if a @footnote directive follows non-punctuation. 2004-07-02 15:13:42 +00:00
Jim Meyering 6ca52b93dc (check-texinfo): Disallow `filename' in .texi files. 2004-07-02 15:05:40 +00:00
Jim Meyering 11e80aab17 *** empty log message *** 2004-06-30 22:09:36 +00:00
Jim Meyering 5e5f4bc2fb Standardize on "file system" rather
than "filesystem", as POSIX prefers it with a space.
2004-06-30 22:09:00 +00:00
Jim Meyering b2a58b9d3c (Common options, Target directory, cp
invocation, install invocation, mv invocation, ln invocation):
Likewise.
(link invocation): Explain how to rewrite link using ln now
that we have --no-target-directory.
(ln invocation): Explain that --no-target-directory subsumes
--no-dereference.
(unlink invocation): Modify wording to match new wording in
link invocation.
2004-06-30 18:42:01 +00:00
Jim Meyering f421438665 *** empty log message *** 2004-06-30 18:41:49 +00:00
Jim Meyering 273624ce56 *** empty log message *** 2004-06-29 14:42:19 +00:00
Jim Meyering 67930cefbe (install invocation): Document --target-directory in synopsis, too. 2004-06-29 14:41:51 +00:00
Jim Meyering 05c93d0212 *** empty log message *** 2004-06-17 14:40:51 +00:00
Jim Meyering 65f4c6c6bf (yes invocation): "--" is now supported.
(false invocation, true invocation): --help and --version now
work unconditionally.
2004-06-17 14:38:52 +00:00
Jim Meyering 75e49a2b17 Remove special cases for POSIXLY_CORRECT when POSIX allows the GNU behavior.
(pr invocation, unlink invocation): Document this.
2004-06-15 21:56:15 +00:00
Jim Meyering 91476b4612 . 2004-06-08 17:07:19 +00:00
Jim Meyering b50934d2a9 . 2004-06-08 14:58:57 +00:00
Jim Meyering 0ce5f6610f *** empty log message *** 2004-06-07 08:21:10 +00:00
Jim Meyering 34b2d4920f Remove menu references to just-removed subsection. 2004-06-07 08:21:07 +00:00
Jim Meyering d14676e7fc *** empty log message *** 2004-06-06 19:31:46 +00:00
Jim Meyering 032b5b3bcf (tr invocation): Remove the section describing
how POSIXLY_CORRECT changes tr's behavior.
2004-06-06 19:31:43 +00:00
Jim Meyering 0539abe980 *** empty log message *** 2004-06-02 21:23:42 +00:00
Jim Meyering 2cd87c6562 (cut invocation): Clarify what --output-delimiter=STR
does with byte/character ranges.
2004-06-02 21:23:39 +00:00
Jim Meyering 7a9884545c *** empty log message *** 2004-06-02 08:35:27 +00:00
Jim Meyering 733ceab1b8 (tr invocation): Mention -C. 2004-06-02 08:35:02 +00:00
Jim Meyering 980b8cf2f7 *** empty log message *** 2004-06-01 12:47:37 +00:00
Jim Meyering d34466e25d Add some index references for POSIXLY_CORRECT.
(echo invocation): Document today's changes.
2004-06-01 12:46:22 +00:00
Jim Meyering 92b4b9ffba . 2004-06-01 07:49:47 +00:00
Jim Meyering 97930170e8 . 2004-05-29 22:23:31 +00:00
Jim Meyering 36708ba6b5 *** empty log message *** 2004-05-17 12:07:30 +00:00
Jim Meyering 3591f10746 chgrp and chown now dereference symlinks by default, per POSIX.
(chgrp invocation, chown invocation): Document it.
2004-05-17 12:07:25 +00:00
Jim Meyering eed02be1b6 *** empty log message *** 2004-05-14 07:33:23 +00:00
Jim Meyering d667552245 (sort invocation): Document that "sort -m -o F"
might write F before reading all the input.
2004-05-14 07:32:56 +00:00
Jim Meyering b9d74188f2 . 2004-05-09 19:43:35 +00:00
Jim Meyering 61a7a3871d *** empty log message *** 2004-05-09 19:43:27 +00:00
Jim Meyering bc99952263 (check-texinfo): grep -w IO 2004-05-09 19:43:23 +00:00
Jim Meyering d77d6d8b9e *** empty log message *** 2004-05-09 19:42:23 +00:00
Jim Meyering 77cd88719f (stat invocation): Change IO to I/O. 2004-05-09 19:42:19 +00:00
Jim Meyering 53080d0a85 . 2004-04-26 16:31:14 +00:00
Jim Meyering 79f8908c8a *** empty log message *** 2004-04-26 15:38:16 +00:00
Jim Meyering c20e6668c8 (sort invocation): Mention -k earlier, so
that the options are in alphabetical order.  Describe how -b works
more-accurately; this involves fixing some examples, too.  Mention
what happens if the start field falls after an end field or after
a line end.  Warn about using -k without -b, -g, -M, -n, or -t.
Add an example of how to sort IPv4 addresses and Apache Common
Log Format dates.  Remove a duplicate example.
(Putting the tools together): Use separate options rather
than agglomerating them.
2004-04-26 15:37:48 +00:00
Jim Meyering 332853e722 . 2004-04-19 18:58:24 +00:00
Jim Meyering 7c22ac2383 . 2004-04-14 08:43:32 +00:00
Jim Meyering 907e43cc4a . 2004-04-12 09:39:24 +00:00
Jim Meyering 0a70213d4d *** empty log message *** 2004-04-12 09:27:25 +00:00
Jim Meyering 3b2bcb8359 *** empty log message *** 2004-04-12 09:22:08 +00:00