summaryrefslogtreecommitdiff
path: root/usr.bin/mandoc/mandoc.1
AgeCommit message (Collapse)Author
2012-05-24Support -Ios='OpenBSD 5.1' to override uname(3) as the source of theIngo Schwarze
default value for the mdoc(7) .Os macro. Needed for man.cgi on the OpenBSD website. Problem with man.cgi first noticed by deraadt@; beck@ and deraadt@ agree with the way to solve the issue.
2011-12-25State default usage before listing arguments of a utility;Ingo Schwarze
from kristaps@, ok jmc@.
2011-11-13overful -> overfull;Jason McIntyre
2011-11-13Make the default left text margin configurable from the command line,Ingo Schwarze
just like the default right margin already is. This may be useful for people with expensive screen real estate. Besides, it helps automated man(7) to mdoc(7) output comparisons to validate -Tman output. ok kristaps@ on an earlier version
2011-10-09A bit more precision and nicer wording in the descriptionsIngo Schwarze
of -Ofragment and -Tman; using input from jmc@ and kristaps@.
2011-10-09Sync to version 1.12.0; all code by kristaps@:Ingo Schwarze
Implement .Rv in -Tman. Let -man -Tman work a bit like cat(1). Add the -Ofragment option to -T[x]html. Minor fixes in -T[x]html. Lots of apropos(1) and -Tman code cleanup.
2011-09-26retain alphabetical order for the -Toutput list, and use a widthJason McIntyre
specifier that makes it look nicer; ok schwarze kristaps
2011-09-18sync to version 1.11.5:Ingo Schwarze
adding an implementation of the eqn(7) language by kristaps@ So far, only .EQ/.EN blocks are handled, in-line equations are not, and rendering is not yet very pretty, but the parser is fairly complete.
2011-09-17Initial, incomplete support for -TmanIngo Schwarze
to convert mdoc(7) documents to the man(7) language. This is work in progress and will be developed in tree. It does already handle the cat(1) manual, but will hardly handle all your fancy manuals yet. go ahead kristaps@ jmc@ millert@ deraadt@
2011-05-31Minor fixes by kristaps@, based on issues reported by jmc@.Ingo Schwarze
2011-05-29Merge release 1.11.3, almost all code by kristaps@:Ingo Schwarze
* Unicode output support (no Unicode input yet, though). * Refactoring: completely handle predefined strings in roff.c. - New function mandoc_escape() replaces a2roffdeco() and mandoc_special(). - Start using mandoc_getarg() in mdoc_argv.c. - Clean up parsing of delimiters in mdoc(7). * And many minor fixes and lots of cleanup.
2011-01-09Add and install tbl(7);Ingo Schwarze
written by kristaps@, looked over by jmc@.
2010-12-22More small -Thtml improvements by kristaps@,Ingo Schwarze
in particular, use <B>, <I> and <U> where appropriate. Provide relative widths for header and footer lines. Manuals: More concise short descriptions of output modes. Correct a few places still talking about CSS2 to say CSS1. Code examples should use .Dl, not .D1.
2010-12-19Significant improvements to -Thtml by kristaps@:Ingo Schwarze
Use less <DIV>, use more <H1>, <H2>, <P>, <BR>, <PRE>, <UL>, <OL>, <DL> etc. Triggered by input from Will Backman. Remove CSS2 note in mandoc.1, which is no longer true.
2010-09-26new sentence, new line;Jason McIntyre
2010-09-26sync to bsd.lv:Ingo Schwarze
do not talk about \s, it is ignored anyway do not .Xr groff(1) any longer, just talk about GNU troff because in the long run, groff may not even be installed
2010-08-20Implement a simple, consistent user interface for error handling.Ingo Schwarze
We now have sufficient practical experience to know what we want, so this is intended to be final: - provide -Wlevel (warning, error or fatal) to select what you care about - provide -Wstop to stop after parsing a file with warnings you care about - provide consistent exit status codes for those warnings you care about - fully document what warnings, errors and fatal errors mean - remove all other cruft from the user interface, less is more: - remove all -f knobs along with the whole -f option - remove the old -Werror because calling warnings "fatal" is silly - always finish parsing each file, unless fatal errors prevent that This commit also includes a couple of related simplifications behind the scenes regarding error handling. Feedback and OK kristaps@; Joerg Sonnenberger (NetBSD) and Sascha Wildner (DragonFly BSD) agree with the general direction.
2010-08-18Remove mandoc(1) compatibility notes that are no longer relevant;Ingo Schwarze
from kristaps@.
2010-07-25Sync to bsd.lv; in particular, pull in lots of bug fixes.Ingo Schwarze
new features: * support the .in macro in man(7) * support minimal PDF output * support .Sm in mdoc(7) HTML output * support .Vb and .nf in man(7) HTML output * complete the mdoc(7) manual bug fixes: * do not let mdoc(7) .Pp produce a newline before/after .Sh; reported by jmc@ * avoid double blank lines related to man(7) .sp and .br * let man(7) .nf and .fi flush the line; reported by jsg@ and naddy@ * let "\ " produce a non-breaking space; reported by deraadt@ * discard \m colour escape sequences; reported by J.C. Roberts * map undefined 1-character-escapes to the literal character itself maintenance: * express mdoc(7) arguments in terms of an enum for additional type-safety * simplify mandoc_special() and a2roffdeco() * use strcspn in term_word() in place of a manual loop * minor optimisations in the -Tps and -Thtml formatting frontends
2010-07-13Merge release 1.10.4 (all code by kristaps@), providing four new features:Ingo Schwarze
1) Proper .Bk support: allow output line breaks at input line breaks, but keep input lines together in the output, finally fixing synopses like aucat(1), mail(1) and tmux(1). 2) Mostly finished -Tps (PostScript) output. 3) Implement -Thtml output for .Nm blocks and .Bk -words. 4) Allow iterative interpolation of user-defined roff(7) strings. Also contains some minor bugfixes and some performance improvements.
2010-06-29sync to bsd.lv version 1.10.3:Ingo Schwarze
* support -Tps -Opaper=a4 and -Opaper=letter * lots of mandoc.1 manual improvements
2010-06-29framework for glyph width encoding; from kristaps@Ingo Schwarze
2010-06-26merge release 1.10.2Ingo Schwarze
* bug fixes: - interaction of ASCII_HYPH with special chars (found by Ulrich Spoerlein) - handling of roff conditionals (found by Ulrich Spoerlein) - .Bd -offset will no more default to 6n * maintenance: - more caching of .Bd and .Bl arguments for efficiency - deconstify man(7) validation routines - add FreeBSD library names (provided by Ulrich Spoerlein) * start PostScript font-switching
2010-06-10minimal initial -Tps support, from kristaps@ GSOCIngo Schwarze
so far, monospace without font decoration, but it already has page headers and footers
2010-06-08Merge more bits that will be going into 1.10.1:Ingo Schwarze
Clean up vertical spacing in the SYNOPSIS, making the code much more systematic; this doesn't solve all SYNOPSIS problems yet, in particular not those related to keeps, indentation and the low-level .nr roff instruction, but it's a nice step forward and i couldn't find relevant regressions. (from kristaps) Besides, * make the output width configurable (default: -Owidth=80) (kristaps) * use mmap with MAP_SHARED (from Joerg Sonnenberger)
2010-05-14merge 1.9.24, keeping local patches; some changes:Ingo Schwarze
* preserve multiple consecutive space characters in input * do not restrict .Cd and .Rv to certain sections (requested by Joerg) * do not run lookup() on quoted words * enum return types for mdoc_args and mdoc_argv * fix auto-closing of LINK tag in -Txhtml (from Daniel Friesel) * various lint and manual fixes
2010-05-13Remove the command line option -fno-ign-chars.Ingo Schwarze
This option was not useful, you never want mandoc to die just because there is an invalid character in the input file, neither in production nor when linting: a warning is sufficient. This was particularly annoying because it was part of -fstrict and could not be switched off. "less is more" kristaps@
2010-04-13zap all the (rather useless) dot lines; ok kristapsJason McIntyre
2010-04-13- sort everythingJason McIntyre
- prefer Cm to Ar for stuff like -Tascii - fix wonky ellipsis - standard $ prompt - update usage() kristaps has these diffs rolled in already ok schwarze kristaps
2010-04-08first pass at cleaning this page up:Jason McIntyre
- add openbsd rcsid - new sentence, new line - > -> \*(Gt ok schwarze diff sent to kristaps; this commit includes a tweak from kristaps to keep the page up to date
2010-03-29merge 1.9.19, keeping local patchesIngo Schwarze
* scoping fixes for roff instructions * accept apostroph in place of dot as a macro control character * accept tabs between the control character and the macro name * check that man(7) .TH titles use capital letters
2010-03-26merge 1.9.17, keeping local patchesIngo Schwarze
* much improved pod2man support and low-level roff robustness * have -Tlint imply -Wall and -fstrict * use fewer macros and more enum in libman * and various bug fixes
2010-03-25merge 1.9.16, keeping local patchesIngo Schwarze
This is mostly cleanup by kristaps@ after my rather hackish patch to tolerate the non-text macros .na, .sp, .br in next-line scope; plus some nesting issues fixed by him, all in man(7). This survived a full cd /usr/src; make man.
2010-02-18sync to release 1.9.15:Ingo Schwarze
* corrected .Vt handling (spotted by Joerg Sonnenberger) * corrected .Xr argument handling (based on my patch) * removed \\ escape sequence (because it is for low-level roff only) * warn about trailing whitespace (suggested by jmc@) * -Txhtml support * and some general cleanup and doc improvements
2009-12-24sync to 1.9.14: rewrite escape sequence handling:Ingo Schwarze
- new function a2roffdeco - font modes (\f) only affect the current stack point - implement scaling (\s) - implement space suppression (\c) - implement non-breaking space (\~) in -Tascii - many manual improvements
2009-12-22sync to 1.9.12, mostly portability and refactoring:Ingo Schwarze
correctness/functionality: - bugfix: do not die when overstep hits the right margin - new option: -fign-escape - and various HTML features portability: - replace bzero(3) by memset(3), which is ANSI C - replace err(3)/warn(3) by perror(3)/exit(3), which is ANSI C - iuse argv[0] instead of __progname - add time.h to various files for FreeBSD compilation simplicity: - do not allocate header/footer data dynamically in *_term.c - provide and use malloc frontends that error out on failure for full changelogs, see http://bsd.lv/cgi-bin/cvsweb.cgi/
2009-10-27sync to 1.9.11: adapt printing of dates to groff conventions,Ingo Schwarze
NetBSD portability fixes and some minor bugfixes and feature enhancements; also checked that my hyphenation code still works on top of this
2009-10-21sync to 1.9.9, featuring:Ingo Schwarze
* -Thtml output mode * roff scaling units * and some minor fixes for full changelogs, see http://bsd.lv/cgi-bin/cvsweb.cgi/
2009-09-18sync to 1.9.2: Add .UC libman macro for compatibility, has no effect.Ingo Schwarze
Correct .UC and .DT to not print their arguments. Document that .UC and .DT should not be used.
2009-09-18fix typo (overriden -> overridden); from jmc@; included in 1.9.2Ingo Schwarze
2009-08-22another large chunk of -man updates,Ingo Schwarze
among others regarding .DT, .HP, .RS, .RE, .SH, .SS, and scoping, now in sync vith release 1.9.1
2009-08-22sync to 1.8.5: note that \~ does not work;Ingo Schwarze
noticed by <uqs at spoerlein dot net>
2009-08-22sync to 1.8.4: add option -fign-errors to check several manual pagesIngo Schwarze
without stopping at errors
2009-08-09sync to 1.8.3: quote macro names without a preceding dotIngo Schwarze
2009-08-09sync to 1.8.2: remove trailing whitespaceIngo Schwarze
2009-07-18sync to 1.8.0: support .Bl -hangIngo Schwarze
2009-07-12sync to 1.7.23: Fewer knobs: provide -Wall -Werror but not -Wsyntax -Wcompat.Ingo Schwarze
The simplification of the internal code has already been done before, this is just the user interface adjustment.
2009-06-23sync to 1.7.20: Document whitespace handling.Ingo Schwarze
Currently, mandoc(1) produces French spacing, which is a bug and needs to be fixed, but document it anyway for the time being. While here, fix a few typos, also reported upstream.
2009-06-21sync to 1.7.19: update and reorder COMPATIBILITY and CAVEATSIngo Schwarze
2009-06-17use standard Ds (eight char) indents for tab lists documenting options;Ingo Schwarze
ok kristaps@