Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 29 Oct 2020 18:37:20 +0000 (UTC)
From:      =?UTF-8?Q?Fernando_Apestegu=c3=ada?= <fernape@FreeBSD.org>
To:        src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org
Subject:   svn commit: r367142 - head/usr.bin/fmt
Message-ID:  <202010291837.09TIbKap040707@repo.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: fernape (ports committer)
Date: Thu Oct 29 18:37:20 2020
New Revision: 367142
URL: https://svnweb.freebsd.org/changeset/base/367142

Log:
  fmt(1): Add EXAMPLES section
  
  Very small EXAMPLES section.
  
  While here, remove reference to nroff(1).
  
  Approved by:	manpages (bcr@)
  Differential Revision:		https://reviews.freebsd.org/D26947

Modified:
  head/usr.bin/fmt/fmt.1

Modified: head/usr.bin/fmt/fmt.1
==============================================================================
--- head/usr.bin/fmt/fmt.1	Thu Oct 29 18:34:47 2020	(r367141)
+++ head/usr.bin/fmt/fmt.1	Thu Oct 29 18:37:20 2020	(r367142)
@@ -30,7 +30,7 @@
 .\"
 .\" Modified by Gareth McCaughan to describe the new version of `fmt'
 .\" rather than the old one.
-.Dd December 1, 2017
+.Dd October 29, 2020
 .Dt FMT 1
 .Os
 .Sh NAME
@@ -89,10 +89,6 @@ Try to format mail header lines contained in the input
 Format lines beginning with a
 .Ql \&.
 (dot) character.
-Normally,
-.Nm
-does not fill these lines, for compatibility with
-.Xr nroff 1 .
 .It Fl p
 Allow indented paragraphs.
 Without the
@@ -159,10 +155,23 @@ environment variables affect the execution of
 .Nm
 as described in
 .Xr environ 7 .
+.Sh EXAMPLES
+Center the text in standard input:
+.Bd -literal -offset indent
+$ echo -e 'The merit of all things\enlies\enin their difficulty' | fmt -c
+                     The merit of all things
+                               lies
+                       in their difficulty
+.Ed
+.Pp
+Format the text in standard input collapsing spaces:
+.Bd -literal -offset indent
+$ echo -e 'Multiple   spaces    will be collapsed' | fmt -s
+Multiple spaces will be collapsed
+.Ed
 .Sh SEE ALSO
 .Xr fold 1 ,
-.Xr mail 1 ,
-.Xr nroff 1
+.Xr mail 1
 .Sh HISTORY
 The
 .Nm



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202010291837.09TIbKap040707>