From mark@asana.dhis.org  Sun Sep 16 15:25:51 2001
Return-Path: <mark@asana.dhis.org>
Received: from asana.dhis.org (as5300-38.richmond.in.hypervine.net [216.117.89.38])
	by hub.freebsd.org (Postfix) with ESMTP id BEDE637B413
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 16 Sep 2001 15:25:49 -0700 (PDT)
Received: (from mark@localhost)
	by asana.dhis.org (8.11.3/8.11.1) id f8GMSDl01045;
	Sun, 16 Sep 2001 17:28:13 -0500 (EST)
	(envelope-from mark)
Message-Id: <200109162228.f8GMSDl01045@asana.dhis.org>
Date: Sun, 16 Sep 2001 17:28:13 -0500 (EST)
From: mark@summersault.com
Reply-To: mark@summersault.com
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: ediff man page incomplete 
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         30618
>Category:       docs
>Synopsis:       ediff man page incomplete
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Sep 16 15:30:00 PDT 2001
>Closed-Date:    Sat Dec 14 16:00:13 PST 2002
>Last-Modified:  Sat Dec 14 16:00:13 PST 2002
>Originator:     Mark Stosberg
>Release:        FreeBSD 4.3-RELEASE i386
>Organization:
>Environment:
System: FreeBSD asana.dhis.org 4.3-RELEASE FreeBSD 4.3-RELEASE #0: Sat Apr 21 10:54:49 GMT 2001 jkh@narf.osd.bsdi.com:/usr/src/sys/compile/GENERIC i386


	
>Description:
	Hello! I just discovered and tried to use the nice GNU sdiff utility. A primary feature 
of this utility is it's ability to interactively work with file differences. However, the
documentation (man sdiff) does not explain any of the commands that are used interactively. I found
that there are explained on the GNU site though: 
http://www.gnu.org/manual/diffutils/html_chapter/diff_9.html#SEC59

I'm not sure whether this is a GNU distribution bug or a FreeBSD bug. I'm sorry if I'm posted this
report in th wrong place. 

Thanks for the great OS. :)  -mark 
>How-To-Repeat:
	
>Fix:

	
>Release-Note:
>Audit-Trail:

From: Giorgos Keramidas <charon@labs.gr>
To: mark@summersault.com
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/30618: ediff man page incomplete
Date: Mon, 17 Sep 2001 01:45:33 +0300

 mark@summersault.com <mark@summersault.com> wrote:
 > 
 > I'm not sure whether this is a GNU distribution bug or a FreeBSD bug. I'm
 > sorry if I'm posted this report in th wrong place.
 
 The documentation of sdiff does not include a manpage that describes the
 merging commands, because GNU people seem to prefer the `info' format for
 documenting their programs.  You can find the documentation for merging with
 sdiff by reading up:
 
 	% info '(diff)'
 
 Read the node ``Interactive Merging''.  It does have what you want :-)
 
 I guess, now this PR can be closed.
 
 -giorgos

From: Mark Stosberg <mark@summersault.com>
To: Giorgos Keramidas <charon@labs.gr>
Cc: <FreeBSD-gnats-submit@FreeBSD.ORG>
Subject: Re: docs/30618: sdiff man page incomplete
Date: Sun, 16 Sep 2001 22:26:11 -0500 (EST)

 Thanks for the pointer Giorges. I also figured out that if I try
 "h" once I've started the program interactively, that will give me what I
 want, too. What about updating the man page to tell people they should
 read the "info" page for more information? I'm familiar with the info
 system, but that just didn't occur to me.
 
    -mark
 
 
 On Mon, 17 Sep 2001, Giorgos Keramidas wrote:
 
 > mark@summersault.com <mark@summersault.com> wrote:
 > >
 > > I'm not sure whether this is a GNU distribution bug or a FreeBSD bug. I'm
 > > sorry if I'm posted this report in th wrong place.
 >
 > The documentation of sdiff does not include a manpage that describes the
 > merging commands, because GNU people seem to prefer the `info' format for
 > documenting their programs.  You can find the documentation for merging with
 > sdiff by reading up:
 >
 > 	% info '(diff)'
 >
 > Read the node ``Interactive Merging''.  It does have what you want :-)
 >
 > I guess, now this PR can be closed.
 >
 > -giorgos
 >
 
 http://mark.stosberg.com/
 
 
Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Fri Dec 7 21:00:23 PST 2001 
Responsible-Changed-Why:  
I'm going to update sdiff's manpage from its info docs. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=30618 
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Sat Dec 14 15:59:05 PST 2002 
State-Changed-Why:  
I've added a pointer to the info documentation in revision 1.2 of 
src/gnu/usr.bin/sdiff/sdiff.1,v 

Thanks for submitting this bug report! 

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