diff options
| author | G. Branden Robinson <g.branden.robinson@gmail.com> | 2022-08-03 21:24:26 +0200 |
|---|---|---|
| committer | Jean Delvare <jdelvare@suse.de> | 2022-08-03 21:24:26 +0200 |
| commit | 653c0f98d1234b6e6ab9d47cba4306d611a5be04 (patch) | |
| tree | 50e1632fbf1ffa0251b6c8a137169c7a31d241ab | |
| parent | 7bf580d6e21a42ee4c0bbf0c88714191ba8d2081 (diff) | |
| download | quilt-653c0f98d1234b6e6ab9d47cba4306d611a5be04.tar.gz | |
Man page: update internal and external cross-references
Embolden internal subsection reference, and refer to its parent section.
Point explicitly to the GNU Diffutils manual regarding unified diff
format, and add cross-reference in the See Also section.
Add cross-reference to diffstat man page.
Sort man page cross-reference list in alphabetical order.
| -rw-r--r-- | doc/quilt.1.in | 39 |
1 files changed, 30 insertions, 9 deletions
diff --git a/doc/quilt.1.in b/doc/quilt.1.in index 31060ed..2017dac 100644 --- a/doc/quilt.1.in +++ b/doc/quilt.1.in @@ -61,7 +61,11 @@ By default, most commands apply to the topmost patch on the stack. .PP Patch files are located in the .I patches -sub-directory of the source tree (see EXAMPLE OF WORKING TREE below). +sub-directory of the source tree (see +.BR "Example of working tree" , +under +.BR FILES , +below). The .I QUILT_PATCHES environment variable can be used to override this location. @@ -127,8 +131,9 @@ file. is careful to preserve all text that precedes the actual patch when doing a refresh. (This is limited to patches in unified format; see -.B diff -documentation). +the GNU +.I Diffutils +manual.) .PP The series file is looked up in the .pc directory, in the root of the source tree, and in the patches directory. @@ -427,14 +432,30 @@ This man page was written by Martin Quinson, based on information found in the pdf documentation, and in the help messages of each commands. . .SH EXAMPLES -Please refer to the pdf documentation for a full example of use. +Please refer to the pdf documentation for a full example of use (under +.B "SEE ALSO" +below). . .SH "SEE ALSO" -The pdf documentation, which should be under @DOCSUBDIR@/quilt.pdf. +.I "How to Survive with Many Patches, or: Introduction to Quilt" +is installed at @DOCSUBDIR@/quilt.pdf. Note that some distributors compress this file. -.BR zxpdf ( 1 ) +.BR zxpdf (1) can be used to display compressed pdf files. .PP -.BR diff ( 1 ), -.BR patch ( 1 ), -.BR guards ( 1 ). +The GNU +.I Diffutils +manual, +.UR https://\\:www.gnu.org/\\:software/\\:diffutils/\\:manual/ +.I "Comparing and Merging Files" +.UE , +documents +.I diff +and +.I patch +in detail. +.PP +.BR diff (1), +.BR diffstat (1), +.BR guards (1), +.BR patch (1) |