docs/77024: typo/bad grammar in indent(1) manpage

Adrian Filipi adrian at ubergeeks.com
Thu Feb 3 17:20:24 UTC 2005


The following reply was made to PR docs/77024; it has been noted by GNATS.

From: Adrian Filipi <adrian at ubergeeks.com>
To: Giorgos Keramidas <keramida at freebsd.org>
Cc: bug-followup at freebsd.org
Subject: Re: docs/77024: typo/bad grammar in indent(1) manpage
Date: Thu, 3 Feb 2005 12:17:04 -0500 (EST)

  	Sounds good to me.  Better than the original.
 
  	Adrian
 -- 
 [ adrian at ubergeeks.com ]
 
 On Thu, 3 Feb 2005, Giorgos Keramidas wrote:
 
 > % --- indent.1.orig	Thu Feb  3 00:35:20 2005
 > % +++ indent.1	Thu Feb  3 00:36:37 2005
 > % @@ -534,7 +534,7 @@
 > %  .Pp
 > %  .Dl indent *.c
 > %  .Pp
 > % -to the shell in an attempt to indent all the
 > % +To the shell this is an attempt to indent all the
 > %  .Em C
 > %  programs in a directory.
 > % -This is probably a bug, not a feature.
 > % +It is probably a bug, not a feature.
 >
 > This shows too little context from the original manpage.  Reading both the
 > preceding paragraph and the one that follows the displayed material we see:
 >
 > %    A common mistake that often causes grief is typing:
 > %
 > %          indent *.c
 > %
 > %    to the shell in an attempt to indent all the C programs in a
 > %    directory.  This is probably a bug, not a feature.
 >
 > If you read both these paragraphs as one sentence, it probably
 > makes more sense.  I agree it looks a bit confusing though.
 >
 > We can probably rewrite this part as:
 >
 > %   A common mistake is to try to indent all the C programs in a
 > %   directory by typing:
 > %
 > %         indent *.c
 > %
 > %   This is probably a bug, not a feature.
 >



More information about the freebsd-doc mailing list