| Commit message (Collapse) | Author | Age | Files | Lines |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
These are ANSI escape sequences as defined by ECMA-48; recast the entire
discussion in light of that fact.
Condense the many tagged paragraphs with a templated discussion of
defaults into a table.
Sort the QUILT_COLORS format names into alphabetical order.
Add a hint to the formatter (man) to call the tbl preprocessor to
render the table.
Expand the example to be more demonstrative.
Add pointers to the ECMA-48 standard document and the console_codes
section 4 man page (from Michael Kerrisk's man-pages project, widely
available) to the See Also section.
[JD: Some fixes, added patch_offs to the table, added a note that the
patches command shares colors with the series command]
|
|
|
|
|
|
|
| |
Use the groff extension .schar to provide an alternative output sequence
for output devices missing the Unicode box-drawing characters.
[JD: removed a .fi request which I believed was restored by accident]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* Give working tree example a name that looks more like an actual
software project's directory name.
* Fix pronoun/antecedent agreement (multiple occurrences).
* Tighten language (e.g., unnecessary use of "some").
* Reorganize discussion of how quilt finds its rc file to proceed
strictly in the order attempted.
* Leave breadcrumbs about EDITOR and LESS, which used to be part of this
discussion; add cross-reference to where the material is now.
* Make explicit the fact that quilt command names need to be manually
up-cased for use in QUILT_COMMAND_ARGS.
* Set configuration variable names in italics.
* Transform a popular Denglish construction into idiomatic English.
https://english.stackexchange.com/questions/85069/is-the-construction-it-allows-to-proper-english
* Clarify that "if set to anything" variables function as Booleans.
* Recast "a shortcut to" as "shorthand for", which is more idiomatic
English in context.
* Add cross-reference to diffstat man page on first occurrence.
* Fix typo: each commands -> each command.
[JD: reverted 2 changes I did not like; fixes one more typo]
|
|
|
|
|
|
| |
* Remove dependent clause used as a topic transition when this material
was not in its own section.
* Provide examples of when $EDITOR is used.
|
|
|
|
| |
* Eliminate otherwise unused term "sub-command".
|
|
|
|
|
|
|
|
| |
* Don't introduce a metavariable without explaining it or using it in
context.
* Drop the reference to the PDF documentation which doesn't belong
there.
* Clarify options --trace and --version.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* Don't end a sentence with an abbreviation period if possible (also,
man-pages(7) discourages the use of Latin abbreviations altogether).
* Users of quilt are not merely outputting patches; they are consuming
them and altering them as well.
* Clarify the (shall we say) truncability of command names.
* Use directional double-quotes instead of boldface to set off literals.
Some typographers claim that frequent font face changes tire the eye.
* Offer an example of a patch name.
* Introduce the "quilt series" command in the same paragraph the series
file itself is first described, to eliminate forward reference.
* Introduce quilt command names only once each.
* Add a paragraph summarizing the work cycle for starting and refining a
new patch.
[JD: Some editions and clean-ups]
|
| |
|
|
|
|
| |
Per style recommendation in man-pages(7).
|
|
|
|
| |
Everything in manual sections 1 or 8 is a tool, in some sense.
|
| |
|
| |
|
|
|
|
| |
Also add a clarifying introductory sentence.
|
|
|
|
|
|
|
|
| |
Variable content in an italic context is set in roman for contrast, but
still in italics in running roman prose.
[JD: Revert some of the changes which did not belong there, and
restored the original indentation level as I think it looked better]
|
|
|
|
|
|
|
|
|
|
|
| |
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.
|
|
|
|
| |
...including names of software projects (such as quilt itself).
|
|
|
|
|
|
|
|
| |
The Latin "exempli gratia" is abbreviated "e.g.".
Also, use a zero-width-space escape to defeat roff's end-of-sentence
detection. See section 4.1 of CSTR #54, "Troff User's Manual", Ossanna
& Kernighan <https://www.troff.org/54.pdf>.
|
|
|
|
| |
Also add quotation marks where they make semantic sense.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Document --quiltrc, --trace, and --version options explicitly.
Separate the informational operation modes for reporting help and
version information.
Mark up synopsis canonically (literals in bold, variable content in
italics, and roman for "synopsis language" (option brackets, etc.)).
Use groff_man(7)'s SY and YS macros for more attractive presentation.
[JD: Restore [options] and strip duplicate line]
|
|
|
|
|
|
|
|
|
|
|
|
| |
When a "literal" ASCII 45 hyphen-minus character is desired, it has to
be escaped; this is a requirement going all the way back to Bell Labs
Troff, but is frequently overlooked. Getting it right enables
accurate cut-and-paste of code examples, filenames, URLs, and so forth
from roff documents prepared for UTF-8 terminal and PDF output, possibly
among others.
See section 2.1 of CSTR #54, "Troff User's Manual", Ossanna & Kernighan
<https://www.troff.org/54.pdf>.
|
|
|
|
|
|
| |
This eliminates the use of low-level requests in this man page (the
groffism ".fam" to change the font family and the switching off and on
of fill mode with ".nf" and ".fi".)
|
|
|
|
|
| |
Apart from being higher-level and easier to read, the macros get you
proper italic corrections when abutting italic with non-italic text.
|
|
|
|
|
|
|
|
| |
Use only section names endorsed by man-pages(7), and put them in the
recommended order.
Use subsection macro (SS) where helpful.
[JD: Preserve the EXAMPLE section as EXAMPLES]
|
|
|
|
|
|
|
| |
Also reflow input lines to 72 columns.
Both are recommended by *roff experts:
https://www.gnu.org/software/groff/manual/html_node/Input-Conventions.html
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Blank lines are bad roff style. Per CSTR #54, blank lines are the
equivalent of ".sp 1", but in GNU roff this can be overridden with a
blank line macro (".blm"), and all macro packages for text formatting
(mm, ms, me, man, etc.) have macros for paragraph separation, and the
inter-paragraph spacing is usually different from ".sp 1" for typesetter
output (this can be seen in PostScript and PDF output). Explicit
spacing is also unnecessary immediately adjacent to section headings.
See section 5.3 of CSTR #54, "Troff User's Manual", Ossanna & Kernighan
<https://www.troff.org/54.pdf>.
[JD: Added an empty request (.) before each section to preserve the
readability of the input.]
|
|
|
|
|
|
|
|
|
|
| |
This causes warnings from roff when the warning level is turned up
really high, as some roff/man page hackers do.
<standard input>:891: warning: number register `an-saved-margin2' not defined
<standard input>:891: warning: number register `an-saved-prevailing-indent2' not defined
Stop supplying the extraneous argument.
|
|
|
|
|
|
|
|
|
| |
Document the list of latex packages that must be installed in order
to build the PDF documentation.
Suggested by Ondřej Lysoněk.
Signed-off-by: Jean Delvare <jdelvare@suse.de>
|
|
|
|
|
|
|
|
| |
quilt loads /etc/quilt.quiltrc if ~/.quiltrc doesn't exist. Document
it.
Signed-off-by: Ondřej Lysoněk <olysonek@redhat.com>
Signed-off-by: Jean Delvare <jdelvare@suse.de>
|
|
|
|
|
|
|
|
|
|
|
|
| |
In order to have cross-references in the PDF documentation, we need
a two-pass process, where the first pass prepares the references
while the second pass generates the actual PDF.
Do that explicitly from now on, so that the cross-references are OK
even when building the documentation for the first time.
Signed-off-by: Jean Delvare <jdelvare@suse.de>
Tested-by: Ondřej Lysoněk <olysonek@redhat.com>
|
| |
|
|
|
|
|
|
|
|
|
|
| |
In Latex, a double dash produces an "en dash". If a literal double
dash is needed, '-{}-' can be used.
Based on a similar fix to the English version of the document by
Ondřej Lysoněk.
Signed-off-by: Jean Delvare <jdelvare@suse.de>
|
|
|
|
|
|
|
|
| |
In Latex, a double dash produces an "en dash". If a literal double
dash is needed, '-{}-' can be used.
Signed-off-by: Ondřej Lysoněk <olysonek@redhat.com>
Signed-off-by: Jean Delvare <jdelvare@suse.de>
|
|
|
|
|
|
|
| |
"Serie" is not a word. Change it to "series".
Signed-off-by: Ondřej Lysoněk <olysonek@redhat.com>
Signed-off-by: Jean Delvare <jdelvare@suse.de>
|
|
|
|
|
|
|
|
|
|
| |
Explain how patch options like the strip level can be recoded in the
series file.
Suggested by Cristian Rigamonti in bug #56886:
https://savannah.nongnu.org/bugs/index.php?56886
Signed-off-by: Jean Delvare <jdelvare@suse.de>
|
|
|
|
|
|
|
| |
If some users are already changing the value of QUILT_PC and it
works, we may as well document it.
Signed-off-by: Jean Delvare <jdelvare@suse.de>
|
|
|
|
|
|
|
|
|
|
|
|
| |
The Content-Disposition headers quilt has been adding since 2015 are
causing problems with Thunderbird and Gmail, which display patches as
attachments instead of text if this header is present and includes a
filename. This breaks email-based patch reviewing and isn't likely to
get fixed on the email client side, so stop adding those headers.
Recipients of patches via email already need a mechanism to construct
filenames for messages coming from anything but quilt, so this change is
unlikely to cause major problems for existing users.
|
|
|
|
|
|
| |
Most people don't know about the guards helper which can be used
to generate series files. Mentioning it in the quilt manual page
should help raise the awareness.
|
|
|
|
| |
Translation updates take time so it should be the first item.
|
| |
|
| |
|
|
|
|
|
| |
Update doc/RELEASING to mention the NEWS file instead of the
quilt.changes file.
|
| |
|
|
|
|
|
|
|
| |
* Delete blank lines at end of files.
* Delete white space at end of lines.
* Delete spaces before tab.
* Replace 8 spaces by a tab where it makes sense.
|
|
|
|
|
|
|
| |
Explain why -E is no longer passed to patch by default, and why a
user may want to revert to the old behavior.
Based on a preliminary patch by Martin Quinson.
|
| |
|
|
|
|
|
|
|
| |
Documentation update: add an EXIT STATUS section to the manual page.
Closes Debian bug #587001:
http://bugs.debian.org/587001
|
|
|
|
| |
Add a few words to the example section to make it clearer.
|
|
|
|
|
|
|
|
| |
Similar to EDITOR, document quilt's use of LESS when paging output.
QUILT_LESS_ARGS is unnecessary, so revert 497979e561e880fb0d11be82c78544e5718d531b.
Signed-off-by: Kent R. Spillner <kspillner@acm.org>
Signed-off-by: Jean Delvare <jdelvare@suse.de>
|
|
|
|
|
|
|
|
|
| |
Add a QUILT_LESS_ARGS variable that can be used to configure what quilt will
set LESS to when LESS is undefined. Defaults to -FSRX so no functional change
in the default case, but allows users to drop the -F argument as needed (for
example, when using a multiline shell prompt) without explicitly setting LESS.
Signed-off-by: Kent R. Spillner <kspillner@acm.org>
|
| |
|