From swear@blarg.net  Thu Mar 28 20:59:25 2002
Return-Path: <swear@blarg.net>
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id ADDA637B417
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 28 Mar 2002 20:59:24 -0800 (PST)
Received: from thig.blarg.net (thig.blarg.net [206.124.128.18])
	by lists.blarg.net (Postfix) with ESMTP id 5D98ABD8B
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 28 Mar 2002 20:59:24 -0800 (PST)
Received: from localhost.localdomain ([206.124.139.115])
	by thig.blarg.net (8.9.3/8.9.3) with ESMTP id UAA04424
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 28 Mar 2002 20:59:24 -0800
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.6/8.11.3) id g2T4vvh99716;
	Thu, 28 Mar 2002 20:57:57 -0800 (PST)
	(envelope-from swear@blarg.net)
Message-Id: <7git7gezsa.t7g@localhost.localdomain>
Date: 28 Mar 2002 20:57:57 -0800
From: "Gary W. Swearingen" <swear@blarg.net>
Reply-To: swear@blarg.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: diff(1) manual doesn't explain "=format".
X-GNATS-Notify:

>Number:         36464
>Category:       docs
>Synopsis:       diff(1) manual doesn't explain "=format".
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 28 21:00:09 PST 2002
>Closed-Date:    Thu Jul 11 14:12:36 PDT 2002
>Last-Modified:  Thu Jul 11 14:12:36 PDT 2002
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
none
>Environment:
n/a
================
>Description:

The diff(1) manual uses "=format" at the end of many option syntax
lines, but nowhere describes what "format" may be.
================
>How-To-Repeat:
n/a
================
>Fix:
?
>Release-Note:
>Audit-Trail:

From: Giorgos Keramidas <keramida@freebsd.org>
To: "Gary W. Swearingen" <swear@blarg.net>
Cc: bug-followup@freebsd.org
Subject: Re: docs/36464: diff(1) manual doesn't explain "=format".
Date: Fri, 29 Mar 2002 17:24:28 +0200 (EET)

 On 2002-03-28 20:57, Gary W. Swearingen wrote:
 
 > The diff(1) manual uses "=format" at the end of many option syntax
 > lines, but nowhere describes what "format" may be.
 
 There is a description of "formats" in the GNU diff info documentation.
 You're right that we probably need to point the user to info docs in the
 manpage though.  GNU programs tend to have more complete and up to date
 info documentation than manpages :-/
 
 Giorgos Keramidas                       FreeBSD Documentation Project
 keramida@{freebsd.org,ceid.upatras.gr}  http://www.FreeBSD.org/docproj/
 

From: swear@blarg.net (Gary W. Swearingen)
To: Giorgos Keramidas <keramida@freebsd.org>
Cc: bug-followup@freebsd.org
Subject: Re: docs/36464: diff(1) manual doesn't explain "=format".
Date: 29 Mar 2002 11:16:22 -0800

 Giorgos Keramidas <keramida@freebsd.org> writes:
 
 > There is a description of "formats" in the GNU diff info documentation.
 > You're right that we probably need to point the user to info docs in the
 > manpage though.  GNU programs tend to have more complete and up to date
 > info documentation than manpages :-/
 
 Good idea; I should have thought of the info pages.  Most of the Linux
 GNUish manuals have, close to the top, a very ugly comment about the
 manual being obsolete trash and how you should be using info.  I'm sure
 you'll show more tact.
 
 (I actually prefer the info scheme to manual pages, but that's a PR I'll
 never write. :)
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Thu Jul 11 14:11:30 PDT 2002 
State-Changed-Why:  
I've added a pointer to the info documentation to diff(1). 
I hope this makes it easier for users that wonder what =format is. 


Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Thu Jul 11 14:11:30 PDT 2002 
Responsible-Changed-Why:  

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