Annotation of mandoc/index.sgml, Revision 1.100
1.1 kristaps 1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
1.40 kristaps 2: <HTML>
3: <HEAD>
4: <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8">
5: <META NAME="resource-type" CONTENT="document">
6: <LINK REL="stylesheet" HREF="index.css" TYPE="text/css" MEDIA="all">
1.47 kristaps 7: <TITLE>mdocml | mdoc macro compiler</TITLE>
1.40 kristaps 8: </HEAD>
9: <BODY>
10: <TABLE CLASS="frame" SUMMARY="[frame]">
11: <COL WIDTH="100%">
12: <TBODY>
13: <TR>
14: <TD>
15: <DIV CLASS="head">
16: <B>mdocml</B> – mdoc macro compiler
17: </DIV>
18: </TD>
19: </TR>
20: <TR>
21: <TD VALIGN="top">
22: <H1>
1.75 kristaps 23: <A NAME="description">DESCRIPTION</A>
1.40 kristaps 24: </H1>
1.1 kristaps 25:
1.40 kristaps 26: <P>
1.84 kristaps 27: <SPAN CLASS="nm">mdocml</SPAN> is a suite of tools compiling <Q>-<A HREF="mdoc.7.html">mdoc</A></Q>, the
28: roff macro package of choice for BSD manual pages, and <Q>-<A HREF="man.7.html">man</A></Q>, the
29: predominant historical package for UNIX manuals. The mission of <SPAN CLASS="nm">mdocml</SPAN> is to
30: deprecate <A HREF="http://www.gnu.org/software/groff/" CLASS="external">groff</A>, the GNU troff
31: implementation, for displaying -mdoc pages whilst providing token support for -man.
1.40 kristaps 32: </P>
1.9 kristaps 33:
1.40 kristaps 34: <P>
1.13 kristaps 35: Why? groff amounts to over 5 MB of source code, most of which is C++ and all of which is GPL. It runs
36: slowly, produces uncertain output, and varies in operation from system to system. mdocml strives to fix
1.84 kristaps 37: this (respectively small, C, <A CLASS="external"
38: HREF="http://www.isc.org/software/license">ISC</A>-licensed, fast and regular).
1.40 kristaps 39: </P>
1.1 kristaps 40:
1.40 kristaps 41: <P>
1.84 kristaps 42: <SPAN CLASS="nm">mdocml</SPAN> consists of the <A HREF="mdoc.3.html">libmdoc</A>, <A
43: HREF="man.3.html">libman</A>, and <A HREF="roff.3.html">libroff</A> validating compilers; and <A
44: HREF="mandoc.1.html">mandoc</A>, which interfaces with the compiler libraries to format output for UNIX
1.98 kristaps 45: terminals, XHTML, HTML, PostScript, and PDF. <SPAN CLASS="nm">mdocml</SPAN> is a <A CLASS="external"
1.84 kristaps 46: HREF="http://bsd.lv/">BSD.lv</A> project.
1.40 kristaps 47: </P>
48:
49: <P>
1.84 kristaps 50: <I>Disambiguation</I>: <SPAN CLASS="nm">mdocml</SPAN> is often referred to by its installed binary,
51: <Q>mandoc</Q>.
1.40 kristaps 52: </P>
53: </TD>
54: </TR>
55: <TR>
56: <TD>
57: <H1>
1.75 kristaps 58: <A NAME="sources">SOURCES</A>
1.40 kristaps 59: </H1>
1.1 kristaps 60:
1.40 kristaps 61: <P>
1.84 kristaps 62: <SPAN CLASS="nm">mdocml</SPAN> is architecture- and system-neutral, written in plain-old C. The most
63: current version is <SPAN CLASS="attn">@VERSION@</SPAN>, dated <SPAN class="attn">@VDATE@</SPAN>. A full
64: <A HREF="ChangeLog.html">ChangeLog</A> (<A HREF="ChangeLog.txt">txt</A>) is written with each release.
1.40 kristaps 65: </P>
1.7 kristaps 66:
1.40 kristaps 67: <H2>
1.26 kristaps 68: Current
1.40 kristaps 69: </H2>
1.1 kristaps 70:
1.40 kristaps 71: <TABLE WIDTH="100%" SUMMARY="Current Sources">
1.98 kristaps 72: <COL WIDTH="175">
1.40 kristaps 73: <COL>
74: <TBODY>
75: <TR>
76: <TD>Source archive</TD>
77: <TD>
78: <A HREF="/snapshots/mdocml.tar.gz">/snapshots/mdocml.tar.gz</A>
79: (<A HREF="/snapshots/mdocml.md5">md5</A>)
80: </TD>
81: </TR>
82: <TR>
83: <TD>Online source</TD>
84: <TD>
1.74 kristaps 85: <A HREF="http://mdocml.bsd.lv/cgi-bin/cvsweb/?cvsroot=mdocml">cvsweb</A>
1.40 kristaps 86: </TD>
87: </TR>
88: </TBODY>
89: </TABLE>
1.1 kristaps 90:
1.40 kristaps 91: <H2>
1.26 kristaps 92: Downstream
1.40 kristaps 93: </H2>
1.1 kristaps 94:
1.40 kristaps 95: <TABLE WIDTH="100%" SUMMARY="Downstream Sources">
1.98 kristaps 96: <COL WIDTH="175">
1.40 kristaps 97: <COL>
98: <TBODY>
99: <TR>
100: <TD>DragonFly BSD</TD>
101: <TD>
102: <A HREF="http://gitweb.dragonflybsd.org/dragonfly.git/tree/HEAD:/usr.bin/mandoc"
103: CLASS="external">usr.bin/mandoc</A>
104: </TD>
105: </TR>
106: <TR>
107: <TD>FreeBSD</TD>
108: <TD>
109: <A HREF="http://www.freebsd.org/cgi/cvsweb.cgi/ports/textproc/mdocml/"
110: CLASS="external">ports/textproc/mdocml</A>
111: </TD>
112: </TR>
113: <TR>
114: <TD>NetBSD</TD>
115: <TD>
116: <A HREF="http://cvsweb.netbsd.org/bsdweb.cgi/src/external/bsd/mdocml/"
117: CLASS="external">src/external/bsd/mdocml</A>
118: </TD>
119: </TR>
120: <TR>
121: <TD>OpenBSD</TD>
122: <TD>
123: <A HREF="http://www.openbsd.org/cgi-bin/cvsweb/src/usr.bin/mandoc/"
124: CLASS="external">src/usr.bin/mandoc</A>
125: </TD>
126: </TR>
127: </TBODY>
128: </TABLE>
1.1 kristaps 129:
1.40 kristaps 130: <H2>
1.22 kristaps 131: Historical
1.40 kristaps 132: </H2>
1.10 kristaps 133:
1.40 kristaps 134: <TABLE WIDTH="100%" SUMMARY="Archived Sources">
1.98 kristaps 135: <COL WIDTH="175">
1.40 kristaps 136: <COL>
137: <TBODY>
138: <TR>
139: <TD>Source archive</TD>
140: <TD>
141: <A HREF="/snapshots/">/snapshots/</A>
142: </TD>
143: </TR>
144: </TBODY>
145: </TABLE>
146: </TD>
147: </TR>
148: <TR>
149: <TD>
150: <H1>
1.75 kristaps 151: <A NAME="documentation">DOCUMENTATION</A>
1.40 kristaps 152: </H1>
1.18 kristaps 153:
1.40 kristaps 154: <P>
1.84 kristaps 155: These manuals are generated automatically and refer to the current snapshot.
1.40 kristaps 156: </P>
1.24 kristaps 157:
1.40 kristaps 158: <TABLE WIDTH="100%" SUMMARY="Documentation">
1.98 kristaps 159: <COL WIDTH="175">
1.40 kristaps 160: <COL>
161: <TBODY>
162: <TR>
1.80 kristaps 163: <TD VALIGN="top"><A HREF="man.3.html">man(3)</A></TD>
164: <TD VALIGN="top">
165: man macro compiler library
1.84 kristaps 166: <SPAN STYLE="font-size: smaller;">
1.91 kristaps 167: (<A HREF="man.3.txt">text</A> |
1.97 kristaps 168: <A HREF="man.3.xhtml">xhtml</A> |
1.91 kristaps 169: <A HREF="man.3.pdf">pdf</A> |
170: <A HREF="man.3.ps">postscript</A>)
1.84 kristaps 171: </SPAN>
1.80 kristaps 172: </TD>
173: </TR>
174: <TR>
175: <TD VALIGN="top"><A HREF="man.7.html">man(7)</A></TD>
176: <TD VALIGN="top">
177: man language reference
1.84 kristaps 178: <SPAN STYLE="font-size: smaller;">
1.91 kristaps 179: (<A HREF="man.7.txt">text</A> |
1.97 kristaps 180: <A HREF="man.7.xhtml">xhtml</A> |
1.91 kristaps 181: <A HREF="man.7.pdf">pdf</A> |
182: <A HREF="man.7.ps">postscript</A>)
1.84 kristaps 183: </SPAN>
1.80 kristaps 184: </TD>
185: </TR>
186: <TR>
187: <TD VALIGN="top"><A HREF="mandoc.1.html">mandoc(1)</A></TD>
188: <TD VALIGN="top">
189: format and display UNIX manuals
1.84 kristaps 190: <SPAN STYLE="font-size: smaller;">
1.91 kristaps 191: (<A HREF="mandoc.1.txt">text</A> |
1.97 kristaps 192: <A HREF="mandoc.1.xhtml">xhtml</A> |
1.91 kristaps 193: <A HREF="mandoc.1.pdf">pdf</A> |
194: <A HREF="mandoc.1.ps">postscript</A>)
1.84 kristaps 195: </SPAN>
1.80 kristaps 196: </TD>
197: </TR>
198: <TR>
199: <TD VALIGN="top"><A HREF="mandoc_char.7.html">mandoc_char(7)</A></TD>
200: <TD VALIGN="top">
201: mandoc special characters
1.84 kristaps 202: <SPAN STYLE="font-size: smaller;">
1.91 kristaps 203: (<A HREF="mandoc_char.7.txt">text</A> |
1.97 kristaps 204: <A HREF="mandoc_char.7.xhtml">xhtml</A> |
1.91 kristaps 205: <A HREF="mandoc_char.7.pdf">pdf</A> |
206: <A HREF="mandoc_char.7.ps">postscript</A>)
1.84 kristaps 207: </SPAN>
1.80 kristaps 208: </TD>
209: </TR>
210: <TR>
211: <TD VALIGN="top"><A HREF="mdoc.3.html">mdoc(3)</A></TD>
212: <TD VALIGN="top">
213: mdoc macro compiler library
1.84 kristaps 214: <SPAN STYLE="font-size: smaller;">
1.91 kristaps 215: (<A HREF="mdoc.3.txt">text</A> |
1.97 kristaps 216: <A HREF="mdoc.3.xhtml">xhtml</A> |
1.91 kristaps 217: <A HREF="mdoc.3.pdf">pdf</A> |
218: <A HREF="mdoc.3.ps">postscript</A>)
1.84 kristaps 219: </SPAN>
1.80 kristaps 220: </TD>
221: </TR>
222: <TR>
223: <TD VALIGN="top"><A HREF="mdoc.7.html">mdoc(7)</A></TD>
224: <TD VALIGN="top">
225: mdoc language reference
1.84 kristaps 226: <SPAN STYLE="font-size: smaller;">
1.91 kristaps 227: (<A HREF="mdoc.7.txt">text</A> |
1.97 kristaps 228: <A HREF="mdoc.7.xhtml">xhtml</A> |
1.91 kristaps 229: <A HREF="mdoc.7.pdf">pdf</A> |
230: <A HREF="mdoc.7.ps">postscript</A>)
1.84 kristaps 231: </SPAN>
1.80 kristaps 232: </TD>
233: </TR>
234: <TR>
235: <TD VALIGN="top"><A HREF="roff.3.html">roff(3)</A></TD>
236: <TD VALIGN="top">
237: roff macro compiler library
1.84 kristaps 238: <SPAN STYLE="font-size: smaller;">
1.91 kristaps 239: (<A HREF="roff.3.txt">text</A> |
1.97 kristaps 240: <A HREF="roff.3.xhtml">xhtml</A> |
1.91 kristaps 241: <A HREF="roff.3.pdf">pdf</A> |
242: <A HREF="roff.3.ps">postscript</A>)
1.84 kristaps 243: </SPAN>
1.80 kristaps 244: </TD>
245: </TR>
246: <TR>
247: <TD VALIGN="top"><A HREF="roff.7.html">roff(7)</A></TD>
248: <TD VALIGN="top">
249: roff-mandoc language reference
1.84 kristaps 250: <SPAN STYLE="font-size: smaller;">
1.91 kristaps 251: (<A HREF="roff.7.txt">text</A> |
1.97 kristaps 252: <A HREF="roff.7.xhtml">xhtml</A> |
1.91 kristaps 253: <A HREF="roff.7.pdf">pdf</A> |
254: <A HREF="roff.7.ps">postscript</A>)
1.84 kristaps 255: </SPAN>
1.80 kristaps 256: </TD>
1.71 kristaps 257: </TR>
1.40 kristaps 258: </TBODY>
259: </TABLE>
1.79 kristaps 260:
261: <P>
262: See <Q><A CLASS="external" HREF="http://manpages.bsd.lv">Writing UNIX Manual Pages</A></Q> for a general
263: introduction to manpages and mdoc.
1.82 kristaps 264: </P>
1.40 kristaps 265: </TD>
266: </TR>
267: <TR>
268: <TD>
269: <H1>
1.75 kristaps 270: <A NAME="contact">CONTACT</A>
1.40 kristaps 271: </H1>
1.1 kristaps 272:
1.40 kristaps 273: <P>
1.84 kristaps 274: Please use the mailing lists for bug-reports, patches, questions, etc. Beyond that, contact
275: Kristaps at <A
276: HREF="http://mailhide.recaptcha.net/d?k=01M6h_w7twDp58ZgH57eWC_w==&c=Q2DBUt401ePlSeupJFrq_Q=="
277: TITLE="Reveal this e-mail address">kris...</A>@bsd.lv.
1.40 kristaps 278: </P>
1.18 kristaps 279:
1.40 kristaps 280: <P>
1.84 kristaps 281: You may also subscribe to several mailing lists (these require subscription, which is
1.92 kristaps 282: moderated).
1.40 kristaps 283: </P>
1.57 kristaps 284:
285: <TABLE WIDTH="100%" SUMMARY="Mailing Lists">
1.98 kristaps 286: <COL WIDTH="175">
1.57 kristaps 287: <COL>
288: <TBODY>
289: <TR>
290: <TD>
1.60 kristaps 291: disc<A CLASS="external" TITLE="Reveal this e-mail address"
1.76 kristaps 292: HREF="http://www.google.com/recaptcha/mailhide/d?k=01KQ80PFH5n3BBNpF5Gs4sRg==&c=EV1QytpQqTHSItc2IXvZyocgYLPnG5K0JKw_gwMC9yc=">...</A>@mdocml.bsd.lv
1.57 kristaps 293: </TD>
1.92 kristaps 294: <TD>
295: bug-reports, general questions, and announcements
1.93 kristaps 296: <SPAN STYLE="font-size: smaller;">(<A HREF="/archives/discuss/summary.html">archive</A>)</SPAN>
1.92 kristaps 297: </TD>
1.72 kristaps 298: </TR>
299: <TR>
300: <TD>
301: tec<A CLASS="external" TITLE="Reveal this e-mail address"
1.76 kristaps 302: HREF="http://www.google.com/recaptcha/mailhide/d?k=01qDX_iV0RlUOarEvb6mR28g==&c=gRXsTjza0NNCFPaYu-Taj2tF0pmYZSc90EZkFkhkxgo=">...</A>@mdocml.bsd.lv
1.72 kristaps 303: </TD>
1.92 kristaps 304: <TD>
305: patches and system discussions
1.93 kristaps 306: <SPAN STYLE="font-size: smaller;">(<A HREF="/archives/tech/summary.html">archive</A>)</SPAN>
1.92 kristaps 307: </TD>
1.58 kristaps 308: </TR>
1.67 kristaps 309: <TR>
1.58 kristaps 310: <TD>
311: sou<A CLASS="external" TITLE="Reveal this e-mail address"
1.76 kristaps 312: HREF="http://www.google.com/recaptcha/mailhide/d?k=01prQrAZhhl2EbIwVcRfABsQ==&c=KtTW4Yic9xk-8g40KzJoca4fR3MYXv28g8NC6OQV-T8=">...</A>@mdocml.bsd.lv
1.58 kristaps 313: </TD>
1.92 kristaps 314: <TD>
315: source commit messages
1.93 kristaps 316: <SPAN STYLE="font-size: smaller;">(<A HREF="/archives/source/summary.html">archive</A>)</SPAN>
1.92 kristaps 317: </TD>
1.67 kristaps 318: </TR>
1.57 kristaps 319: </TBODY>
320: </TABLE>
1.40 kristaps 321: </TD>
322: </TR>
323: <TR>
324: <TD>
325: <H1>
1.75 kristaps 326: <A NAME="news">NEWS</A>
1.40 kristaps 327: </H1>
1.77 kristaps 328: <DIV CLASS="news">
329: <P>
1.100 ! kristaps 330: <SPAN CLASS="date">03-01-2011</SPAN>:
! 331: version 1.10.9
! 332: </P>
! 333: <P>
! 334: Table functionality (see the <A HREF="roff.7.html#x5c265453">roff</A> manual) has been
! 335: merged from <A CLASS="external" HREF="http://tbl.bsd.lv">tbl.bsd.lv</A>. Many back-end
! 336: fixes have also been implemented, primarily in argument handling (quoting) and <A
! 337: HREF="man.7.html">man</A> documents.
! 338: </P>
! 339: </DIV>
! 340: <DIV CLASS="news">
! 341: <P>
1.99 kristaps 342: <SPAN CLASS="date">24-12-2010</SPAN>:
1.95 kristaps 343: version 1.10.8
344: </P>
345: <P>
346: Significant improvements merged from <A CLASS="external"
347: HREF="http://www.openbsd.org">OpenBSD</A> downstream, including
348: </P>
349: <UL>
350: <LI>many new <A HREF="roff.7.html">roff</A> components,</LI>
351: <LI>in-line implementation of troff's soelim,</LI>
352: <LI>broken-block handling,</LI>
353: <LI>overhauled error classifications, and</LI>
354: <LI>cleaned up handling of error conditions.</LI>
355: </UL>
356: <P>
357: Also overhauled the <SPAN CLASS="flag">-Thtml</SPAN> and <SPAN
1.96 kristaps 358: CLASS="flag">-Txhtml</SPAN> output modes. They now display readable output in arbitrary
359: browsers, including text-based ones like <A CLASS="external"
1.98 kristaps 360: HREF="http://lynx.isc.org">lynx</A>. See HTML and XHTML manuals in the <A
361: HREF="#documentation">DOCUMENTATION</A> section for examples. <SPAN
362: CLASS="attn">Attention: available style-sheet classes have been considerably
363: changed!</SPAN> See the <SPAN CLASS="file">example.style.css</SPAN> file for details.
364: Lastly, <A HREF="mdoc.3.html">libmdoc</A> and <A HREF="man.3.html">libman</A> have been
365: cleaned up and reduced in size and complexity.
1.95 kristaps 366: </P>
367: </DIV>
368: <DIV CLASS="news">
369: <P>
1.94 kristaps 370: <SPAN CLASS="date">27-09-2010</SPAN>:
371: version 1.10.6
372: </P>
373: <P>
374: Calling conventions for <A HREF="mandoc.1.html">mandoc</A> have changed: <SPAN
375: CLASS="flag">-W</SPAN> improved and <SPAN CLASS="flag">-f</SPAN> deprecated. Non-ASCII
376: characters are also now uniformly discarded. Lots of documentation improvements. Many
377: incremental fixes accomodating for groff's more interesting productions. Lastly, <A
378: HREF="http://perldoc.perl.org/pod2man.html" CLASS="external">pod2man</A> preambles are
379: now fully accepted after some considerable <A HREF="roff.7.html">roff</A> and special
380: character support.
381: </P>
382: </DIV>
383: <DIV CLASS="news">
384: <P>
1.89 kristaps 385: <SPAN CLASS="date">27-07-2010</SPAN>:
1.86 kristaps 386: version 1.10.5
387: </P>
388: <P>
1.89 kristaps 389: Primarily a bug-fix and polish release, but including <SPAN CLASS="flag">-Tpdf</SPAN>
390: support in <A HREF="mandoc.1.html">mandoc</A> by way of <A CLASS="external"
391: HREF="http://netbsd-soc.sourceforge.net/projects/mandoc_ps/">Summer of Code</A>.
392: Highlights:
1.86 kristaps 393: </P>
394: <UL>
1.89 kristaps 395: <LI>fix <Q>Sm</Q> and <Q>Bd</Q> handling</LI>
1.86 kristaps 396: <LI>fix end-of-sentence handling for embedded sentences</LI>
397: <LI>polish <A HREF="man.7.html">man</A> documentation</LI>
398: <LI>document all <A HREF="mdoc.7.html">mdoc</A> macros</LI>
1.89 kristaps 399: <LI>polish <A HREF="mandoc.1.html">mandoc</A> <SPAN CLASS="flag">-Tps</SPAN> output</LI>
1.86 kristaps 400: <LI>lots of internal clean-ups in character escapes</LI>
401: <LI>un-break literal contexts in <A HREF="man.7.html">man</A> documents</LI>
1.90 kristaps 402: <LI>improve <SPAN CLASS="flag">-Thtml</SPAN> output for <SPAN CLASS="flag">-man</SPAN></LI>
1.89 kristaps 403: <LI>add <A HREF="mandoc.1.html">mandoc</A> <SPAN CLASS="flag">-Tpdf</SPAN> support</LI>
1.86 kristaps 404: </UL>
405: </DIV>
406: <DIV CLASS="news">
407: <P>
1.83 kristaps 408: <SPAN CLASS="date">12-07-2010</SPAN>:
409: version 1.10.4
410: </P>
411: <P>
412: Lots of features developed during both <A CLASS="external"
413: HREF="http://netbsd-soc.sourceforge.net/projects/mandoc_ps/">Summer of Code</A> and the
414: <A CLASS="external" HREF="http://www.openbsd.org">OpenBSD</A> c2k10 hackathon:
415: </P>
416: <UL>
417: <LI>minimal <Q>ds</Q> <A HREF="roff.7.html">roff</A> symbols are supported</LI>
418: <LI><Q>Bk</Q> <A HREF="mdoc.7.html">mdoc</A> support</LI>
419: <LI>beautified SYNOPSIS section output</LI>
420: <LI>variable font-width and paper-size support in <A HREF="mandoc.1.html">mandoc</A>
1.90 kristaps 421: <SPAN CLASS="flag">-Tps</SPAN> output</LI>
1.83 kristaps 422: <LI>acceptance of scope-block breakage in <A HREF="mdoc.7.html">mdoc</A></LI>
423: <LI>clarify error message status</LI>
424: <LI>many minor bug-fixes and formatting issues resolved</LI>
425: </UL>
426: </DIV>
427: <DIV CLASS="news">
428: <P>
1.82 kristaps 429: <SPAN CLASS="date">19-06-2010</SPAN>:
430: version 1.10.2
431: </P>
432: <P>
433: Small release featuring text-decoration in <SPAN CLASS="flag">-Tps</SPAN> output, a few
434: minor relaxations of errors, and some optimisations.
435: </P>
436: </DIV>
437: <DIV CLASS="news">
438: <P>
1.79 kristaps 439: <SPAN CLASS="date">07-06-2010</SPAN>:
1.77 kristaps 440: version 1.10.1
441: </P>
442: <P>
443: This primarily focusses on the <Q>Bl</Q> and <Q>It</Q> macros described in <A
444: HREF="mdoc.7.html">mdoc</A>. Multi-line column support is now fully compatible with
1.78 kristaps 445: groff, as are implicit list entries for columns. Removed manuals.7 in favour of <A
1.79 kristaps 446: CLASS="external" HREF="http://manpages.bsd.lv">http://manpages.bsd.lv</A>. The way we
447: handle the SYNOPSIS section (see the SYNOPSIS documentation in <A
448: HREF="mdoc.7.html#x4d414e55414cx20x535452554354555245">MANUAL STRUCTURE</A>) has also
1.80 kristaps 449: been considerably simplified compared to groff's method. Furthermore, the <SPAN
1.79 kristaps 450: CLASS="flag">-Owidth=width</SPAN> output option has been added to <SPAN
1.80 kristaps 451: CLASS="flag">-Tascii</SPAN> (see <A HREF="mandoc.1.html">mandoc</A>). Lastly, initial
452: PostScript output has been added with the <SPAN CLASS="flag">-Tps</SPAN> option to <A
453: HREF="mandoc.1.html">mandoc</A>. It's brutally simple at the moment: fixed-font, with
454: no font decorations.
1.77 kristaps 455: </P>
456: </DIV>
1.75 kristaps 457: <DIV CLASS="news">
458: <P>
459: <SPAN CLASS="date">29-05-2010</SPAN>:
460: version 1.10.0
461: </P>
462: <P>
463: Release consisting of the results from the m2k10 hackathon and up-merge from OpenBSD.
464: This requires a significant note of thanks to Ingo Schwarze (OpenBSD) and Joerg
465: Sonnenberger (NetBSD) for their hard work, and again to Joerg for hosting m2k10.
466: Highlights (mostly cribbed from Ingo's m2k10 report) follow in no particular order:
467: </P>
468: <UL>
469: <LI>a <A HREF="roff.3.html">libroff</A> preprocessor in front of <A
470: HREF="mdoc.3.html">libmdoc</A> and <A HREF="man.3.html">libman</A> stripping out
471: <A HREF="roff.7.html">roff</A> instructions;</LI>
472: <LI>end-of-sentence (EOS) detection in free-form and macro lines;</LI>
473: <LI>correct handling of tab-separated columnar lists in <SPAN
474: CLASS="flag">-mdoc</SPAN>;</LI>
475: <LI>improved main calling routines to optionally use mmap() for better
476: performance;</LI>
477: <LI>cleaned up exiting when invoked as <SPAN CLASS="flag">-Tlint</SPAN> or over
478: multiple files with <SPAN CLASS="flag">-fign-errors</SPAN>;</LI>
479: <LI>error and warning message handling re-written to be unified for <A
480: HREF="roff.3.html">libroff</A>, <A HREF="mdoc.3.html">libmdoc</A>, and <A
481: HREF="man.3.html">libman</A>;</LI>
482: <LI>handling of badly-nested explicit-scoped macros;</LI>
483: <LI>improved free-form text parsing in <A HREF="man.3.html">libman</A> and <A
484: HREF="mdoc.3.html">libmdoc</A>;</LI>
485: <LI>significant GNU troff compatibility improvements in <SPAN
486: CLASS="flag">-Tascii</SPAN>, largely in terms of spacing;</LI>
487: <LI>a regression framework for making sure the many fragilities of GNU troff
488: aren't trampled in subsequent work;</LI>
489: <LI>support for <SPAN CLASS="flag">-Tascii</SPAN> breaking at hyphens
490: encountered in free-form text;</LI>
491: <LI>and many more minor fixes and improvements (no really, consult <A
492: HREF="http://mdocml.bsd.lv/cgi-bin/cvsweb/?cvsroot=mdocml">cvsweb</A> and see
493: for yourself!).</LI>
494: </UL>
495: </DIV>
496: <P>
497: See <A HREF="http://mdocml.bsd.lv/cgi-bin/cvsweb/index.sgml?cvsroot=mdocml">cvsweb</A> for
498: historical notes.
499: </P>
1.40 kristaps 500: </TD>
501: </TR>
502: <TR>
503: <TD>
504: <DIV CLASS="foot">
1.100 ! kristaps 505: Copyright © 2008–2010 Kristaps Dzonsons, $Date: 2010/12/24 14:14:00 $
1.40 kristaps 506: </DIV>
507: </TD>
508: </TR>
509: </TBODY>
510: </TABLE>
511: </BODY>
512: </HTML>
CVSweb