Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 28 Jun 1999 19:32:10 -0500 (CDT)
From:      dkelly@hiwaay.net
To:        FreeBSD-gnats-submit@freebsd.org
Subject:   docs/12440: I keep forgetting "diff -ruN"
Message-ID:  <199906290032.TAA82782@nospam.hiwaay.net>

next in thread | raw e-mail | index | archive | help

>Number:         12440
>Category:       docs
>Synopsis:       added an example to diff(1) man page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jun 28 17:50:03 PDT 1999
>Closed-Date:
>Last-Modified:
>Originator:     David Kelly
>Release:        FreeBSD 3.2-STABLE i386
>Organization:
n/a
>Environment:

	

>Description:

For some reason every time I fix something I'd like others to consider
for FreeBSD, I can't remember/find the proper syntax for diff. That is,
to do diff the way the team likes it.

When I go looking for this information, I know its in the handbook.
Somewhere in the handbook. It used to be on the post-it note on
my monitor. But I keep wishing to find it in diff(1).

So I've added it to diff.

Maybe I've done it right this time?

Am not totally pleased with my grammar. Would be happy if somebody
re-wrote it in man-ese. Just wish the "diff -ruN x.orig x" part
would remain.

Don't know enough man macros to know how to properly format the
literal example line to represent "typed text". What I've done
looks right in monospaced ASCII but probably not correct when
printed to a postscript printer.

>How-To-Repeat:

--- gnu/usr.bin/diff/diff.1.orig        Sun May 26 17:27:52 1996
+++ gnu/usr.bin/diff/diff.1     Mon Jun 28 19:17:24 1999
@@ -463,6 +463,14 @@
 .TP
 .B \-y
 Use the side by side output format.
+.SH EXAMPLE
+This is the prefered way to output the differences in something you
+wish to share with others, such as via send-pr(1) for consideration
+to be included in FreeBSD. Notice 'something.orig' and 'something'
+may be directories.
+.sp
+diff -ruN something.orig something
+.sp
 .SH SEE ALSO
 cmp(1), comm(1), diff3(1), ed(1), patch(1), pr(1), sdiff(1).
 .SH DIAGNOSTICS


>Fix:
>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




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