From adrian@mail.ubergeeks.com  Wed Feb  2 17:41:25 2005
Return-Path: <adrian@mail.ubergeeks.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 223D116A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Wed,  2 Feb 2005 17:41:25 +0000 (GMT)
Received: from mail.ubergeeks.com (lorax.ubergeeks.com [209.145.65.55])
	by mx1.FreeBSD.org (Postfix) with ESMTP id A014A43D49
	for <FreeBSD-gnats-submit@freebsd.org>; Wed,  2 Feb 2005 17:41:24 +0000 (GMT)
	(envelope-from adrian@mail.ubergeeks.com)
Received: from mail.ubergeeks.com (localhost [127.0.0.1])
	by mail.ubergeeks.com (8.13.1/8.13.1) with ESMTP id j12HfLEX023858
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 2 Feb 2005 12:41:21 -0500 (EST)
	(envelope-from adrian@mail.ubergeeks.com)
Received: (from adrian@localhost)
	by mail.ubergeeks.com (8.13.1/8.13.1/Submit) id j12HfLbn023857;
	Wed, 2 Feb 2005 12:41:21 -0500 (EST)
	(envelope-from adrian)
Message-Id: <200502021741.j12HfLbn023857@mail.ubergeeks.com>
Date: Wed, 2 Feb 2005 12:41:21 -0500 (EST)
From: Adrian Filipi <adrian@ubergeeks.com>
Reply-To: Adrian Filipi <adrian@ubergeeks.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: typo/bad grammar in indent(1) manpage
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         77024
>Category:       docs
>Synopsis:       typo/bad grammar in indent(1) manpage
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Feb 02 17:50:12 GMT 2005
>Closed-Date:    Tue Feb 22 13:10:37 GMT 2005
>Last-Modified:  Tue Feb 22 13:10:37 GMT 2005
>Originator:     Adrian Filipi
>Release:        FreeBSD 5.3-RELEASE-p5 i386
>Organization:
Ubergeeks Consulting
>Environment:
System: FreeBSD atf.cs.virginia.edu 5.3-RELEASE-p5 FreeBSD 5.3-RELEASE-p5 #0: Fri Jan 21 01:48:39 EST 2005 root@atf.cs.virginia.edu:/usr/obj/usr/src/sys/GENERIC i386
>Description:
	The bug ssection of the indent(1) manpage has a typo that is
	grammatically incorrect.  I also reworded the section slightly
	to make it read more clearly.
>How-To-Repeat:
	Read the bug section of the manpage.
>Fix:

	Apply this patch:

begin-base64 644 indent.1.diff.gz
H4sICIS4AUICA2luZGVudC4xLmRpZmYAjY3NCsIwEITP5inmbEyI1ir0VPAHvHnoC6Qa20LblHR7
8O1dbRHxIMKwCzvfzCqlULVX15Jeah+qYpaVA44uByIYk0RxsjJYGRMLKeUb/aY2SbQdqTSFiqP1
Ygs5rjQV0OeOx76e8pjry3hU5EGlQ1+6+unCsohc0xHYmnDLHlNCZp80lVUP1s8I9KHBTqALvgi2
6V8/cK2Cu5APdy1UNtUwkdu8vrOdD8UCrecW3JylITgt5In+oB4ABtDUTwEAAA==
====


>Release-Note:
>Audit-Trail:

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

 % --- 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.
 

From: Adrian Filipi <adrian@ubergeeks.com>
To: Giorgos Keramidas <keramida@freebsd.org>
Cc: bug-followup@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@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.
 >
State-Changed-From-To: open->patched 
State-Changed-By: keramida 
State-Changed-When: Thu Feb 3 21:17:42 GMT 2005 
State-Changed-Why:  
Committed to HEAD. 


Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Thu Feb 3 21:17:42 GMT 2005 
Responsible-Changed-Why:  
I'll MFC this in a while.  Most likely in a week or so. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=77024 
State-Changed-From-To: patched->closed 
State-Changed-By: keramida 
State-Changed-When: Tue Feb 22 13:09:32 GMT 2005 
State-Changed-Why:  
The fix of this PR and several other more recent updates to the 
manpage have been merged to RELENG_5.  Thanks for sending this 
problem report and helping us improve the manpage :-) 

http://www.freebsd.org/cgi/query-pr.cgi?pr=77024 
>Unformatted:
