summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorBruce Korb <bkorb@gnu.org>2012-04-05 17:13:14 -0700
committerJim Meyering <meyering@redhat.com>2012-04-12 22:46:51 +0200
commit0092d5d88bb620885b88aa8b49b079b04066583f (patch)
treef16aeb4d08428b60f19e55ec2f3c398fd9554995 /doc
parent3d53e7fe1c31aa440cc9708c7c51db6b78c07653 (diff)
downloadcoreutils-0092d5d88bb620885b88aa8b49b079b04066583f.tar.xz
fmt: accept new --goal=WIDTH (-g) option
Accept -g for BSD/Plan9 compatibility. * NEWS (New features): Mention it. * tests/fmt/goal-option: New test. * tests/fmt/long-line: Rename from tests/fmt-long-line. * tests/fmt/base: Rename from tests/misc/fmt. * doc/coreutils.texi: Document it. * src/fmt.c (main): Accept the new option (check_for_goals): new function to implement the operands Based on BSD's and Plan-9's fmt programs.
Diffstat (limited to 'doc')
-rw-r--r--doc/coreutils.texi12
1 files changed, 9 insertions, 3 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 1fbf05116..a7e69d15c 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -2203,9 +2203,15 @@ between sentences to two spaces.
@opindex -@var{width}
@opindex -w
@opindex --width
-Fill output lines up to @var{width} characters (default 75). @command{fmt}
-initially tries to make lines about 7% shorter than this, to give it
-room to balance line lengths.
+Fill output lines up to @var{width} characters (default 75 or @var{goal}
+plus 10, if @var{goal} is provided).
+
+@itemx -g @var{goal}
+@itemx --goal=@var{goal}
+@opindex -g
+@opindex --goal
+@command{fmt} initially tries to make lines @var{goal} characters wide.
+By default, this is 7% shorter than @var{width}.
@item -p @var{prefix}
@itemx --prefix=@var{prefix}