diff options
author | Eric S. Raymond <esr@thyrsus.com> | 2013-06-18 01:13:49 -0400 |
---|---|---|
committer | Andreas Gruenbacher <agruen@linbit.com> | 2013-06-18 09:48:32 +0200 |
commit | aac14e3187c18114f640592656396caba2a94de8 (patch) | |
tree | 0a930c7da56c4b3bc6400091ba5544ff2f4d7a8e | |
parent | 60c9d4838ff4c9c9af890d6f5a167a9c091067d2 (diff) | |
download | patch-aac14e3187c18114f640592656396caba2a94de8.tar.gz |
Fix some formatting problems in the manpage
* patch.1: Use higher-level markup that translates better into HTML and other
formats. (With changes by Andreas Gruenbacher.)
-rw-r--r-- | patch.man | 46 |
1 files changed, 28 insertions, 18 deletions
@@ -1,14 +1,10 @@ .\" patch man page -.de Id -.ds Dt \\$4 -.. .ds = \-\^\- .de Sp .if t .sp .3 .if n .sp .. -.TH PATCH 1 \*(Dt GNU -.ta 3n +.TH PATCH 1 "" GNU .SH NAME patch \- apply a diff file to an original .SH SYNOPSIS @@ -241,7 +237,9 @@ asks for confirmation before proceeding. The upshot of all this is that you should be able to say, while in a news interface, something like the following: .Sp - \fB| patch \-d /usr/src/local/blurfl\fP +.RS +\fB| patch \-d /usr/src/local/blurfl\fP +.RE .Sp and patch a file in the .B blurfl @@ -470,7 +468,9 @@ you keep your files in a different directory than the person who sent out the patch. For example, supposing the file name in the patch file was .Sp - \fB/u/howard/src/blurfl/blurfl.c\fP +.RS +\fB/u/howard/src/blurfl/blurfl.c\fP +.RE .Sp setting .B \-p0 @@ -478,13 +478,17 @@ gives the entire file name unmodified, .B \-p1 gives .Sp - \fBu/howard/src/blurfl/blurfl.c\fP +.RS +\fBu/howard/src/blurfl/blurfl.c\fP +.RE .Sp without the leading slash, .B \-p4 gives .Sp - \fBblurfl/blurfl.c\fP +.RS +\fBblurfl/blurfl.c\fP +.RE .Sp and not specifying .B \-p @@ -876,7 +880,9 @@ or option. Here is an example command, using Bourne shell syntax: .Sp - \fBLC_ALL=C TZ=UTC0 diff \-Naur gcc\-2.7 gcc\-2.8\fP +.RS +\fBLC_ALL=C TZ=UTC0 diff \-Naur gcc\-2.7 gcc\-2.8\fP +.RE .PP Tell your recipients how to apply the patch by telling them which directory to @@ -925,14 +931,16 @@ If the recipient is supposed to use the .BI \-p N option, do not send output that looks like this: .Sp -.ft B +.RS +.ft CW .ne 3 - diff \-Naur v2.0.29/prog/README prog/README +diff \-Naur v2.0.29/prog/README prog/README .br - \-\^\-\^\- v2.0.29/prog/README Mon Mar 10 15:13:12 1997 +\-\^\-\^\- v2.0.29/prog/README Mon Mar 10 15:13:12 1997 .br - +\^+\^+ prog/README Mon Mar 17 14:58:22 1997 ++\^+\^+ prog/README Mon Mar 17 14:58:22 1997 .ft +.RE .Sp because the two file names have different numbers of slashes, and different versions of @@ -940,14 +948,16 @@ and different versions of interpret the file names differently. To avoid confusion, send output that looks like this instead: .Sp -.ft B +.RS +.ft CW .ne 3 - diff \-Naur v2.0.29/prog/README v2.0.30/prog/README +diff \-Naur v2.0.29/prog/README v2.0.30/prog/README .br - \-\^\-\^\- v2.0.29/prog/README Mon Mar 10 15:13:12 1997 +\-\^\-\^\- v2.0.29/prog/README Mon Mar 10 15:13:12 1997 .br - +\^+\^+ v2.0.30/prog/README Mon Mar 17 14:58:22 1997 ++\^+\^+ v2.0.30/prog/README Mon Mar 17 14:58:22 1997 .ft +.RE .Sp .PP Avoid sending patches that compare backup file names like |