Age | Commit message (Collapse) | Author |
|
|
|
This macro is unusual in so far as trailing punction needs to remain
inside the scope because it must be inside, not after the display
of long URIs in terminal output mode.
Improves formatting of fw_update(1), help(1), less(1), sendbug(1),
acx(4), inet6(4), ipsec(4), oce(4), isakmpd.conf(5), afterboot(8),
release(8), traceroute(8).
|
|
Suggested by bentley@.
|
|
I just pushed the same change to GNU troff.
|
|
suggested by and OK jmc@
|
|
delete the descriptions and point to man(1) instead.
Inspired by apropos.1 rev. 1.35.
|
|
rather than stating it separately for each option.
Suggested, OKed, and tweaked by jmc@.
|
|
delete the verbose descriptions and point to man(1) and mandoc(1),
respectively, instead. That shortens the pages and makes them
easier to read.
Tweaks and OK jmc@, based in part on ideas from tedu@.
|
|
to mandoc(1) for details, and remove duplicate .Xr to whatis(1);
OK jmc@
|
|
OK jmc@
|
|
|
|
As observed by Jan Stary <hans at stare dot cz>, this is useful such
that after 'alias man="man -m $HOME/man"', 'man -l foo.1' still works.
Simplify and shorten the description of -m, and use .Ic for macros.
|
|
to the ENVIRONMENT section; OK jmc@
|
|
Suggested by bentley@.
Delete the HTTP_HOST configuration variable that is now obsolete.
|
|
Patch from <andreas at AndreasVoegele dot com>.
|
|
and correct description of apropos(1) output search order.
Suggested by tb@.
|
|
Outdated information reported by an Anonymous Coward on undeadly.org.
|
|
For .Sh, .Ss, .SH, .SS, only write selflink if an id could be constructed.
Crash reported by Raf Czlonka <rczlonka at gmail dot com>,
analysis of root cause by natano@
|
|
only write the manpath if it does not match the default.
|
|
Based on a patch from <Anton dot Lindqvist at gmail dot com>,
but simplified and also covering apropos(1) search results.
|
|
As the man(7) language does not provide semantic markup,
only .SH, .SS, and .UR become anchors for now.
|
|
like "/OpenBSD-current/manN/". To discourage that, let man.cgi(8)
redirect search form results to nice, concise URIs.
|
|
for .Bl -tag lists and SYNOPSIS .Nm blocks), such that the text
still fits even if it is printed in bold font.
This is an ugly band aid - but implementing font-dependent width
measurements would be a major project and even more difficult
for HTML than for PostScript.
Issue reported by Jan Stary <hans at stare dot cz>.
|
|
to HTML output. For certain macros appearing at the beginning of .It
heads, write HTML id="..." attributes such that deep linking works.
Write HTML <a> attributes such that you can easily copy out link
targets with the mouse. Try: http://man.openbsd.org/vmctl.8#create
Feature suggested by <guettliml at Thomas dash Guettler dot de>,
some details of the design and implementation by me.
|
|
that can be searched for by apropos(1), such that you see the
semantic function in a tooltip when hovering with the mouse.
|
|
Do not only catch "define key 'key other stuff'",
but also "define key 'other stuff key'".
Fixing infinite loop found by tb@ with afl(1).
|
|
with respect to what constitutes a valid autolink, and if a compiler
deems an autolink invalid, the input turns into an unintended and
potentially harmful raw HTML tag. So, never write autolinks.
Instead of <link>, write [link](link).
Instead of <addr>, write [addr](mailto:addr).
Issue pointed out by bentley@, who also agrees with the general
direction of the change.
|
|
consistent even when aborting the parsing of the line. That buffer
is not our own, but owned and reused by mparse_buf_r(), read.c.
Returning without cleanup leaked memory and caused write overruns
of the old, typically much smaller buffer in mparse_buf_r().
Promptly noticed by tb@ with afl(1), using MALLOC_OPTIONS=C.
|
|
limitations. Of course, we could write UTF-8 output instead,
but even the CommonMark specification doesn't require parsers
to support that, so portability would be doubtful.
While here, provide a link to the CommonMark specification.
|
|
inside link destinations be escaped.
While here, remove the obsolete ESC_PAR.
|
|
and markdown markup do not work inside code spans.
|
|
as well as "number. ", so escape closing parentheses after leading digits
to improve portability.
|
|
Otherwise, we would indent subsequent paragraphs less than
the CommonMark specification requires, harming portability.
|
|
|
|
If is allowed by markdown syntax and more human-readable.
|
|
of a user-defined macro; issue found by tb@ with afl(1)
|
|
limit, usually due to infinite recursion, discard whatever remains
in all those open stack levels. Otherwise, insane constructions
like the following could generate macros of enormous size, causing
mandoc(1) to die from memory exhaustion:
.de m \" original macro definition
.m \" recursion to blow up the stack
.de m \" definition to be run during the call of .m marked (*)
very long plain text (some kilobytes)
.m \" expand the above a thousand times while unwinding the stack
.. \" end of the original definition
.m \" (*) recursively generate a ridiculously large macro
.. \" end of recursively generated definition
.m \" execute the giant macro, exhausting memory
Very creative abuse found by tb@ with afl(1).
|
|
such that they don't look like output line breaks.
|
|
|
|
|
|
|
|
No ‌ in the middle of **, please.
|
|
Warn if that macro occurs elsewhere.
Triggered by a question from Dag-Erling Smoergrav <des @ FreeBSD>.
|
|
|
|
Found by jsg@ with scan-build.
|
|
Basic idea suggested by jmc@, OK jmc@.
|
|
this bug could cause wrong output in other modes as well):
Do not misinterpret tab characters as .Ta macros when they appear
on non-column .It lines in non-column .Bl lists that are nested
inside a parent .Bl -column list. (Admittedly, such constructions
are not very useful; don't use them!)
Found by tb@ with afl(1) because the resulting tree corruption
triggered an assertion in the markdown output module.
|
|
thanks to reyk@ and to Vsevolod at FreeBSD for suggesting it
|
|
|
|
a section number in .TH to be misinterpreted as preformatted.
Found by jsg@ with cppcheck.
|