| Age | Commit message (Collapse) | Author |
|---|
|
and only got adopted by GNU two decades later.
Thanks to Doug McIlroy <doug at cs dot dartmouth dot edu>
for pointing out the error.
|
|
Instead, use a tagged list and the canonical .Ic macro
as it is natural for such purposes.
While here, also delete heaps of needless escaping.
|
|
rather than in the man(7) parser and formatters, document them in the
roff(7) manual, where they belong, rather than in the man(7) manual.
Mention that they imply an output line break, and mention which macros
imply these requests.
|
|
because it serves no real purpose and works poorly with HTML.
While here, describe the section argument of .TH,
clarify the syntax display of .TP, and polish some wordings.
|
|
to understand existing man(7) code and deleting parts that would only
be useful for writing new documents, which we strongly discourage:
* Delete the MANUAL STRUCTURE section which merely duplicates mdoc(7).
* Delete internal cross references only useful for writing new code.
* Delete many instances of "included only for compatibility" as the
whole language is only provided for compatibility.
* Fix a few minor errors and omissions.
|
|
used in most manual pages of the groff package
|
|
used for example by groff_diff(7)
|
|
nor the heirloom-doctools support it. Adding it was a mistake in
the first place.
|
|
feedback and ok schwarze@
|
|
|
|
If is not a macro but a low-level roff request
and not recommended for use in manual pages.
|
|
|
|
Remove lots of lies, dozens of irrelevant implementation details,
and all references to groff versions older than 1.17. Move relevant
information to the pages where it belongs, and out of mandoc(1) in
particular. Add some missing general remarks to roff(7), where it
fits the character and purpose of the page much better.
|
|
parser. Simplify the code by moving it into the roff(7) parser, also
making it work for mdoc(7).
|
|
|
|
|
|
* State the defaults for .Os and the fourth .TH argument.
* Sync the section titles, and stop advertising obscure sections that
aren't actually fully supported and certainly not recommended for use.
|
|
* Mention that the list is incomplete.
* Quoting quotes by doubling them is documented in the
Ossanna/Kernighan/Ritter Nroff/Troff User's Manual, Section 7.3.
* Our roff(7) manual documents handling of escape sequences;
besides, we partially support \w and \z now.
* Scaling widths are documented in roff(7) as well, and f is not \f.
* Negative arguments to .sp are handled now.
|
|
which contexts you can call functions in. deraadt@ encouraged me
to pursue it. ive applied it to a few pages and i think it is worth
moving forward with.
this specific diff was requested by schwartz@ while we were discussing
it before 5.5.
tweaks from jmc@ schwartz@
ok schwartz@
|
|
page template contained in groff_mdoc(7), catch up with our own stuff.
In particular, allow ERRORS in section 4 and DIAGNOSTICS in section 9.
ok jmc@
|
|
|
|
some files. To make it clear that he also put his contributions
under the ISC license, with his explicit permission, add his
Copyright notice to the relevant files. No code change.
|
|
|
|
While here, also add .EX/.EE and .PD to the MACRO SYNTAX table.
|
|
From: Jan Stary
|
|
consistently use the style ".An name Aq Mt email".
Triggered by a question from Jan Stary <hans at stare dot cz>.
Somehow, i missed these two files, jmc@ agrees with the principle.
|
|
|
|
to roff(7) some time ago, i forgot to adjust the cross-references.
Reported by Tim van der Molen <tbvdm at xs4all dot nl>, thanks.
ok jmc@
|
|
Do not use this, it is not portable and only defined in esr's man-ext.
For example, sox(1) wants these macros.
|
|
Do not use this GNU extension, we take it for compatibility only.
|
|
volume name for the respective manual section, just like in mdoc(7).
This gives us nicer page headers for cvs(1), lynx(1), tic(1),
mkhybrid(8), and many curses(3) manuals.
ok kristaps@
To not break compatibility, i wrote a corresponding patch for GNU troff
which Werner Lemberg accepted upstream at rev. 1.65 of:
http://cvs.savannah.gnu.org/viewvc/groff/tmac/an-old.tmac?root=groff
|
|
1) Move the LANGUAGE SYNTAX from mdoc(7) and man(7) to roff(7),
it's common to both and it's actually roff syntax.
2) Move the MACRO SYNTAX down to the bottom, such that the less
technical parts MANUAL STRUCTURE and MACRO OVERVIEW get to the top.
Getting everything to again fit together after the reshuffling
required various adjustments; also adjust and improve
the DESCRIPTIONS while there.
feedback and "go ahead" jmc@ kristaps@
|
|
from kristaps@
|
|
writing this for man(7), too, was suggested by kristaps@
|
|
document eqn(7) and many other improvements
from kristaps@
no objection from deraadt@ against adding an eqn.7 page
|
|
.Bl -column header1 header2 ... <Bl flags>
mixing things up confuses mandoc, and adding flags in can screw up the list.
this hopefully just makes things a bit safer (and more consistent).
(one more bit of work left and all column lists should format how we want)
|
|
will update mandoc repo
|
|
from kristaps@.
|
|
jmc@ agrees that it's easiest to first commit it,
then tweak it in the tree
|
|
as a first step to get rid of the frequent petty warnings in this area:
- always store dates as strings, not as seconds since the Epoch
- for input, try the three most common formats everywhere
- for unrecognized format, just pass the date though verbatim
- when there is no date at all, still use the current date
Originally triggered by a one-line patch from Tim van der Molen,
<tbvdm at xs4all dot nl>, which is included here.
Feedback and OK on manual parts from jmc@.
"please check this in" kristaps@
|
|
on a UNIX system use UNIX conventions, and UNIX tools working
on them expect that.
ok jmc@
|
|
ok jmc@.
|
|
then it will start a new output line;
from kristaps@.
|
|
written by kristaps@, looked over by jmc@.
|
|
* one additional pair of .Sx cross references
* prefer .Dl over .D1 for code examples
|
|
which we have in roff.7):
Remove documentation of the bogus macros .i and .r (which we just
removed from mandoc and which never worked in groff), of .b (which
never existed at all), and of the commented-out chunks for .PD, .Sp,
.Vb, and .Ve (the latter three occur in the pod2man preamble and are
now handled by roff.7 .de).
|
|
note that \k, \o, \w, \z roff escapes are ignored by mandoc(1)
add a short HISTORY to mdoc(7)
move the sentence telling which sections use LIBRARY in man(7)
|
|
section 6 pages currently contain this information);
|
|
- note which section headings (.Sh) are not used by openbsd
- move the description of the section heading to under the heading, rather
than before it: a much more logical way to read
diffs mailed upstream...
|
|
* update escape COMPATIBILITY in mdoc(7) and man(7); from kristaps@
|
