summaryrefslogtreecommitdiff
path: root/usr.bin/mandoc
AgeCommit message (Collapse)Author
2017-04-17implement display of long .Lk URIs to match -TasciiIngo Schwarze
2017-04-17Fix handling of trailing punctuation in .Lk.Ingo Schwarze
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).
2017-04-14Show long .Lk URIs in like an indented display, similar to groff.Ingo Schwarze
Suggested by bentley@.
2017-04-14Do not make the colon after the .Lk link text italic.Ingo Schwarze
I just pushed the same change to GNU troff.
2017-03-27simplify the SYNOPSIS as well, just like the option lists;Ingo Schwarze
suggested by and OK jmc@
2017-03-27For some options that are rarely needed in mandoc(1),Ingo Schwarze
delete the descriptions and point to man(1) instead. Inspired by apropos.1 rev. 1.35.
2017-03-27Simplify: mention at one place that -fkl override each other,Ingo Schwarze
rather than stating it separately for each option. Suggested, OKed, and tweaked by jmc@.
2017-03-25For some options that are rarely needed in apropos(1) and man(1),Ingo Schwarze
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@.
2017-03-22simplify description of -S and -w, point from EXIT STATUSIngo Schwarze
to mandoc(1) for details, and remove duplicate .Xr to whatis(1); OK jmc@
2017-03-21simplify .Nd; to display manuals, use man(1) instead;Ingo Schwarze
OK jmc@
2017-03-21delete documentation of a hack that was removed years agoIngo Schwarze
2017-03-20Silently ignore invalid -m input formats rather than erroring out.Ingo Schwarze
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.
2017-03-18Correct description of MANPATH, and a few more improvementsIngo Schwarze
to the ENVIRONMENT section; OK jmc@
2017-03-18Simplify: write HTTP 303 redirects with relative locations.Ingo Schwarze
Suggested by bentley@. Delete the HTTP_HOST configuration variable that is now obsolete.
2017-03-18Bugfix: use SCRIPT_NAME for .Xr hyperlinks.Ingo Schwarze
Patch from <andreas at AndreasVoegele dot com>.
2017-03-17Document man(1) section selection priority,Ingo Schwarze
and correct description of apropos(1) output search order. Suggested by tb@.
2017-03-17Update HISTORY and AUTHORS: we no longer use SQLite.Ingo Schwarze
Outdated information reported by an Anonymous Coward on undeadly.org.
2017-03-17Fix regression in mdoc_html.c 1.150, man_html 1.87:Ingo Schwarze
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@
2017-03-15In URIs in apropos(1) result tables,Ingo Schwarze
only write the manpath if it does not match the default.
2017-03-15Mention the manual page name and section in the HTML page <title>.Ingo Schwarze
Based on a patch from <Anton dot Lindqvist at gmail dot com>, but simplified and also covering apropos(1) search results.
2017-03-15Minimal support for deep linking into man(7) pages.Ingo Schwarze
As the man(7) language does not provide semantic markup, only .SH, .SS, and .UR become anchors for now.
2017-03-15It's annoying that people keep writing URIs including redundant partsIngo Schwarze
like "/OpenBSD-current/manN/". To discourage that, let man.cgi(8) redirect search form results to nice, concise URIs.
2017-03-14Slightly increase widths calculated from string lengths (mainlyIngo Schwarze
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>.
2017-03-13Port ctags-style, less(1) :t internal searching from terminal outputIngo Schwarze
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.
2017-03-13Print title="..." in addition to id="..." attributes for macro keysIngo Schwarze
that can be searched for by apropos(1), such that you see the semantic function in a tooltip when hovering with the mouse.
2017-03-11Improve detection of recursive eqn(7) "define" statements:Ingo Schwarze
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).
2017-03-11In markdown, autolinks are dangerous. Different compilers disagreeIngo Schwarze
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.
2017-03-09Fix blunder in previous: we must keep the line parse bufferIngo Schwarze
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.
2017-03-08Document that -T markdown produces ASCII output, and the impliedIngo Schwarze
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.
2017-03-08The CommonMark specification wants that opening parenthesesIngo Schwarze
inside link destinations be escaped. While here, remove the obsolete ESC_PAR.
2017-03-08According to the CommonMark specification, backslash escapesIngo Schwarze
and markdown markup do not work inside code spans.
2017-03-08The CommonMark specification allows list markers fo the form "number) "Ingo Schwarze
as well as "number. ", so escape closing parentheses after leading digits to improve portability.
2017-03-08Do not increment .Bl -enum list markers beyond two digits.Ingo Schwarze
Otherwise, we would indent subsequent paragraphs less than the CommonMark specification requires, harming portability.
2017-03-08.Bl -column never gets blank lines between rowsIngo Schwarze
2017-03-08Add a blank after ">" when quoting.Ingo Schwarze
If is allowed by markdown syntax and more human-readable.
2017-03-08prevent infinite recursion while expanding the argumentsIngo Schwarze
of a user-defined macro; issue found by tb@ with afl(1)
2017-03-07If a user-defined macro is aborted because it exceeds the stackIngo Schwarze
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).
2017-03-07Escape blanks at the end of markdown linesIngo Schwarze
such that they don't look like output line breaks.
2017-03-07fix completely empty .Eo: no blank line wantedIngo Schwarze
2017-03-07fix spacing after empty .FlIngo Schwarze
2017-03-07implement .An -split and -nosplitIngo Schwarze
2017-03-07Fix .In formatting in the SYNOPSIS:Ingo Schwarze
No &zwnj; in the middle of **, please.
2017-03-06Using .Nd only makes sense in the NAME section.Ingo Schwarze
Warn if that macro occurs elsewhere. Triggered by a question from Dag-Erling Smoergrav <des @ FreeBSD>.
2017-03-06URIs need different escaping; reported by reyk@Ingo Schwarze
2017-03-04Remove a redundant condition in .%T handling, no functional change.Ingo Schwarze
Found by jsg@ with scan-build.
2017-03-04Make the description of -K autodetection easer to understand.Ingo Schwarze
Basic idea suggested by jmc@, OK jmc@.
2017-03-03Markdown output mode helped us to find the first parser bug (as such,Ingo Schwarze
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.
2017-03-03new -mdoc -Tmarkdown output mode; OK millert@ reyk@ tb@;Ingo Schwarze
thanks to reyk@ and to Vsevolod at FreeBSD for suggesting it
2017-03-03remove a few redundant conditions that jsg@ found with cppcheckIngo Schwarze
2017-03-03Fix a copy-and-paste error that caused man(7) manuals withoutIngo Schwarze
a section number in .TH to be misinterpreted as preformatted. Found by jsg@ with cppcheck.