Hi,
Attached patch replaces in several usage texts some periods with
semicolons, removes from them several inconsistent final periods,
properly double-indents continuation lines, and rephrases two or
three sentences a little for increased clarity.
Regards,
Benno
--
http://www.fastmail.fm - Accessible with your email software
or over the web
From 2bac2f05a68bc3534b54b480469f58bfd2489c8f Mon Sep 17 00:00:00 2001
From: Benno Schulenberg
Date: Sun, 28 Jul 2013 13:54:20 +0200
Subject: [PATCH] textual: use semicolon instead of period in option descriptions
Also do not end option descriptions with a period, properly indent
continuation lines, and make some tiny clarifications.
* src/du.c (usage): Lowercase after semicolon.
* src/ls.c (usage): Semicolons instead of periods, small rephrasing
and two hyphens for clarity, proper indentation.
* src/mktemp.c (usage): Semicolons and lowercase.
* src/od.c (usage): Semicolons.
* src/ptx.c (usage): Use the standard phrase, clarify default option.
* src/setuidgid.c (usage): Properly indent continuation line.
* src/split.c (usage): Semicolons, lowercase, no final period.
* src/stat.c (usage): Semicolons, lowercase.
* src/tail.c (usage): Proper indentation, one shorter rephrasing,
semicolons, no final periods.
* src/timeout.c (usage): Properly indent, semicolons, no final periods.
---
src/du.c|4 ++--
src/ls.c| 28 ++--
src/mktemp.c| 12 ++--
src/od.c|6 +++---
src/ptx.c |2 +-
src/setuidgid.c |2 +-
src/split.c |8
src/stat.c |4 ++--
src/tail.c | 21 ++---
src/timeout.c | 16
10 files changed, 51 insertions(+), 52 deletions(-)
diff --git a/src/du.c b/src/du.c
index 9f1f98c..849ddab 100644
--- a/src/du.c
+++ b/src/du.c
@@ -312,8 +312,8 @@ Summarize disk usage of each FILE, recursively for directories.\n\
"), stdout);
fputs (_("\
--files0-from=F summarize disk usage of the NUL-terminated file\n\
- names specified in file F;\n\
- If F is - then read names from standard input\n\
+ names specified in file F; if F is -, then read\n\
+ names from standard input\n\
-Hequivalent to --dereference-args (-D)\n\
-h, --human-readable print sizes in human readable format (e.g., 1K 234M 2G)\
\n\
diff --git a/src/ls.c b/src/ls.c
index e341c67..2936498 100644
--- a/src/ls.c
+++ b/src/ls.c
@@ -4758,19 +4758,19 @@ Sort entries alphabetically if none of -cftuvSUX nor --sort is specified.\n\
-b, --escape print C-style escapes for nongraphic characters\n\
"), stdout);
fputs (_("\
- --block-size=SIZE scale sizes by SIZE before printing them. E.g.,\n\
+ --block-size=SIZE scale sizes by SIZE before printing them; e.g.,\n\
'--block-size=M' prints sizes in units of\n\
- 1,048,576 bytes. See SIZE format below.\n\
+ 1,048,576 bytes; see SIZE format below\n\
-B, --ignore-backups do not list implied entries ending with ~\n\
-c with -lt: sort by, and show, ctime (time of last\n\
- modification of file status information)\n\
- with -l: show ctime and sort by name\n\
+ modification of file status information);\n\
+ with -l: show ctime and sort by name;\n\
otherwise: sort by ctime, newest first\n\
"), stdout);
fputs (_("\
-C list entries by columns\n\
--color[=WHEN] colorize the output. WHEN defaults to 'always'\n\
- or can be 'never' or 'auto'. More info below\n\
+ or can be 'never' or 'auto'; more info below\n\
-d, --directorylist directory entries instead of contents,\n\
and do not dereference symbolic links\n\
-D, --diredgenerate output designed for Emacs' dired mode\n\
@@ -4788,8 +4788,8 @@ Sort entries alphabetically if none of -cftuvSUX nor --sort is specified.\n\
"), stdout);
fputs (_("\
--group-directories-first\n\
- group directories before files.\n\
- augment with a --sort option, but any\n\
+ group directories before files;\n\
+ can be augmented with a --sort option, but any\n\
use of --sort=none (-U) disables grouping\n\
"), stdout);
fputs (_("\
@@ -4803,7 +4803,7 @@ Sort entries alphabetically if none of -cftuvSUX nor --sort is specified.\n\
follow symbolic links listed