Annotation of mandoc/index.sgml, Revision 1.78
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>
1.75 kristaps 18: <DIV CLASS="subhead">
19: <A HREF="#description">Description</A> |
20: <A HREF="#sources">Sources</A> |
21: <A HREF="#documentation">Documentation</A> |
22: <A HREF="#contact">Contact</A> |
23: <A HREF="#news">News</A>
24: </DIV>
1.40 kristaps 25: </TD>
26: </TR>
27: <TR>
28: <TD VALIGN="top">
29: <H1>
1.75 kristaps 30: <A NAME="description">DESCRIPTION</A>
1.40 kristaps 31: </H1>
1.1 kristaps 32:
1.40 kristaps 33: <P>
34: <SPAN CLASS="nm">mdocml</SPAN> is a suite of tools compiling <Q>-mdoc</Q>, the roff macro package
35: of choice for BSD manual pages, and <Q>-man</Q>, the predominant historical package for UNIX
36: manuals. The mission of <SPAN CLASS="nm">mdocml</SPAN> is to deprecate <A
37: HREF="http://www.gnu.org/software/groff/" CLASS="external">groff</A>, the GNU roff implementation, for
1.18 kristaps 38: displaying -mdoc pages whilst providing token support for -man.
1.40 kristaps 39: </P>
1.9 kristaps 40:
1.40 kristaps 41: <P>
1.13 kristaps 42: Why? groff amounts to over 5 MB of source code, most of which is C++ and all of which is GPL. It runs
43: slowly, produces uncertain output, and varies in operation from system to system. mdocml strives to fix
44: this (respectively small, C, ISC-licensed, fast and regular).
1.40 kristaps 45: </P>
1.1 kristaps 46:
1.40 kristaps 47: <P>
1.74 kristaps 48: The core of <SPAN CLASS="nm">mdocml</SPAN> is composed of the <A HREF="mdoc.3.html">libmdoc</A>, <A
49: HREF="man.3.html">libman</A>, and <A HREF="roff.3.html">libroff</A> validating compiler libraries. All
50: are simple, fast libraries operating on memory buffers, so they may be used for a variety of front-ends
51: (terminal-based, CGI and so on). The front-end is <A HREF="mandoc.1.html">mandoc</A>, which formats
52: manuals for display.
1.40 kristaps 53: </P>
54:
55: <P>
1.74 kristaps 56: The <SPAN CLASS="nm">mdocml</SPAN> suite is a <A CLASS="external" HREF="http://bsd.lv/">BSD.lv
1.40 kristaps 57: Project</A> member.
58: </P>
59: </TD>
60: </TR>
61: <TR>
62: <TD>
63: <H1>
1.75 kristaps 64: <A NAME="sources">SOURCES</A>
1.40 kristaps 65: </H1>
1.1 kristaps 66:
1.40 kristaps 67: <P>
1.74 kristaps 68: Sources correctly build and install on DragonFly BSD, FreeBSD, OpenBSD, NetBSD, GNU/Linux, and many
69: other operating systems, tested variously on i386, AMD64, alpha, and others. The most current version
70: is <SPAN CLASS="attn">@VERSION@</SPAN>, dated <SPAN class="attn">@VDATE@</SPAN>. A full <A
1.40 kristaps 71: HREF="ChangeLog.html">ChangeLog</A> (<A HREF="ChangeLog.txt">txt</A>) is written with each release.
72: </P>
1.7 kristaps 73:
1.40 kristaps 74: <H2>
1.26 kristaps 75: Current
1.40 kristaps 76: </H2>
1.1 kristaps 77:
1.40 kristaps 78: <TABLE WIDTH="100%" SUMMARY="Current Sources">
79: <COL WIDTH="200">
80: <COL>
81: <TBODY>
82: <TR>
83: <TD>Source archive</TD>
84: <TD>
85: <A HREF="/snapshots/mdocml.tar.gz">/snapshots/mdocml.tar.gz</A>
86: (<A HREF="/snapshots/mdocml.md5">md5</A>)
87: </TD>
88: </TR>
89: <TR>
90: <TD>Online source</TD>
91: <TD>
1.74 kristaps 92: <A HREF="http://mdocml.bsd.lv/cgi-bin/cvsweb/?cvsroot=mdocml">cvsweb</A>
1.40 kristaps 93: </TD>
94: </TR>
95: </TBODY>
96: </TABLE>
1.1 kristaps 97:
1.40 kristaps 98: <H2>
1.26 kristaps 99: Downstream
1.40 kristaps 100: </H2>
1.1 kristaps 101:
1.40 kristaps 102: <TABLE WIDTH="100%" SUMMARY="Downstream Sources">
103: <COL WIDTH="200">
104: <COL>
105: <TBODY>
106: <TR>
107: <TD>DragonFly BSD</TD>
108: <TD>
109: <A HREF="http://gitweb.dragonflybsd.org/dragonfly.git/tree/HEAD:/usr.bin/mandoc"
110: CLASS="external">usr.bin/mandoc</A>
111: </TD>
112: </TR>
113: <TR>
114: <TD>FreeBSD</TD>
115: <TD>
116: <A HREF="http://www.freebsd.org/cgi/cvsweb.cgi/ports/textproc/mdocml/"
117: CLASS="external">ports/textproc/mdocml</A>
118: </TD>
119: </TR>
120: <TR>
121: <TD>NetBSD</TD>
122: <TD>
123: <A HREF="http://cvsweb.netbsd.org/bsdweb.cgi/src/external/bsd/mdocml/"
124: CLASS="external">src/external/bsd/mdocml</A>
125: </TD>
126: </TR>
127: <TR>
128: <TD>OpenBSD</TD>
129: <TD>
130: <A HREF="http://www.openbsd.org/cgi-bin/cvsweb/src/usr.bin/mandoc/"
131: CLASS="external">src/usr.bin/mandoc</A>
132: </TD>
133: </TR>
134: </TBODY>
135: </TABLE>
1.1 kristaps 136:
1.40 kristaps 137: <H2>
1.22 kristaps 138: Historical
1.40 kristaps 139: </H2>
1.10 kristaps 140:
1.40 kristaps 141: <TABLE WIDTH="100%" SUMMARY="Archived Sources">
142: <COL WIDTH="200">
143: <COL>
144: <TBODY>
145: <TR>
146: <TD>Source archive</TD>
147: <TD>
148: <A HREF="/snapshots/">/snapshots/</A>
149: </TD>
150: </TR>
151: </TBODY>
152: </TABLE>
153: </TD>
154: </TR>
155: <TR>
156: <TD>
157: <H1>
1.75 kristaps 158: <A NAME="documentation">DOCUMENTATION</A>
1.40 kristaps 159: </H1>
1.18 kristaps 160:
1.40 kristaps 161: <P>
1.39 kristaps 162: These manuals are generated automatically and refer to the current snapshot.
1.40 kristaps 163: </P>
1.24 kristaps 164:
1.40 kristaps 165: <TABLE WIDTH="100%" SUMMARY="Documentation">
166: <COL WIDTH="200">
167: <COL>
168: <TBODY>
169: <TR>
1.74 kristaps 170: <TD><A HREF="man.3.html">man(3)</A> (<A HREF="man.3.txt">text</A>)</TD>
171: <TD>man macro compiler library</TD>
172: </TR>
173: <TR>
174: <TD><A HREF="man.7.html">man(7)</A> (<A HREF="man.7.txt">text</A>)</TD>
175: <TD>man language reference</TD>
176: </TR>
177: <TR>
1.40 kristaps 178: <TD><A HREF="mandoc.1.html">mandoc(1)</A> (<A HREF="mandoc.1.txt">text</A>)</TD>
179: <TD>format and display UNIX manuals</TD>
180: </TR>
181: <TR>
182: <TD><A HREF="mandoc_char.7.html">mandoc_char(7)</A> (<A HREF="mandoc_char.7.txt">text</A>)</TD>
183: <TD>mandoc special characters</TD>
184: </TR>
185: <TR>
186: <TD><A HREF="mdoc.3.html">mdoc(3)</A> (<A HREF="mdoc.3.txt">text</A>)</TD>
187: <TD>mdoc macro compiler library</TD>
188: </TR>
189: <TR>
1.74 kristaps 190: <TD><A HREF="mdoc.7.html">mdoc(7)</A> (<A HREF="mdoc.7.txt">text</A>)</TD>
191: <TD>mdoc language reference</TD>
192: </TR>
193: <TR>
194: <TD><A HREF="roff.3.html">roff(3)</A> (<A HREF="roff.3.txt">text</A>)</TD>
195: <TD>roff macro compiler library</TD>
1.40 kristaps 196: </TR>
1.71 kristaps 197: <TR>
198: <TD><A HREF="roff.7.html">roff(7)</A> (<A HREF="roff.7.txt">text</A>)</TD>
1.74 kristaps 199: <TD>roff-mandoc language reference</TD>
1.71 kristaps 200: </TR>
1.40 kristaps 201: </TBODY>
202: </TABLE>
203: </TD>
204: </TR>
205: <TR>
206: <TD>
207: <H1>
1.75 kristaps 208: <A NAME="contact">CONTACT</A>
1.40 kristaps 209: </H1>
1.1 kristaps 210:
1.40 kristaps 211: <P>
212: For all issues related to <SPAN CLASS="nm">mdocml</SPAN>, contact Kristaps Dzonsons, kris<A
213: CLASS="external"
214: HREF="http://mailhide.recaptcha.net/d?k=01M6h_w7twDp58ZgH57eWC_w==&c=Q2DBUt401ePlSeupJFrq_Q=="
215: TITLE="Reveal this e-mail address">...</A>@bsd.lv.
216: </P>
1.18 kristaps 217:
1.40 kristaps 218: <P>
1.68 kristaps 219: You may also subscribe to several mailing lists (these require subscription, which is moderated). An
1.74 kristaps 220: archive is not yet available on-line, although you may request one once subscribed.
1.40 kristaps 221: </P>
1.57 kristaps 222:
223: <TABLE WIDTH="100%" SUMMARY="Mailing Lists">
224: <COL WIDTH="200">
225: <COL>
226: <TBODY>
227: <TR>
228: <TD>
1.60 kristaps 229: disc<A CLASS="external" TITLE="Reveal this e-mail address"
1.76 kristaps 230: HREF="http://www.google.com/recaptcha/mailhide/d?k=01KQ80PFH5n3BBNpF5Gs4sRg==&c=EV1QytpQqTHSItc2IXvZyocgYLPnG5K0JKw_gwMC9yc=">...</A>@mdocml.bsd.lv
1.57 kristaps 231: </TD>
1.72 kristaps 232: <TD>high-level discussions and version announcements</TD>
233: </TR>
234: <TR>
235: <TD>
236: tec<A CLASS="external" TITLE="Reveal this e-mail address"
1.76 kristaps 237: HREF="http://www.google.com/recaptcha/mailhide/d?k=01qDX_iV0RlUOarEvb6mR28g==&c=gRXsTjza0NNCFPaYu-Taj2tF0pmYZSc90EZkFkhkxgo=">...</A>@mdocml.bsd.lv
1.72 kristaps 238: </TD>
239: <TD>low-level discussions</TD>
1.58 kristaps 240: </TR>
1.67 kristaps 241: <TR>
1.58 kristaps 242: <TD>
243: sou<A CLASS="external" TITLE="Reveal this e-mail address"
1.76 kristaps 244: HREF="http://www.google.com/recaptcha/mailhide/d?k=01prQrAZhhl2EbIwVcRfABsQ==&c=KtTW4Yic9xk-8g40KzJoca4fR3MYXv28g8NC6OQV-T8=">...</A>@mdocml.bsd.lv
1.58 kristaps 245: </TD>
1.59 kristaps 246: <TD>source commit messages</TD>
1.67 kristaps 247: </TR>
1.57 kristaps 248: </TBODY>
249: </TABLE>
1.40 kristaps 250: </TD>
251: </TR>
252: <TR>
253: <TD>
254: <H1>
1.75 kristaps 255: <A NAME="news">NEWS</A>
1.40 kristaps 256: </H1>
1.77 kristaps 257: <DIV CLASS="news">
258: <P>
259: <SPAN CLASS="date">xx-06-2010</SPAN>:
260: version 1.10.1
261: </P>
262: <P>
263: This primarily focusses on the <Q>Bl</Q> and <Q>It</Q> macros described in <A
264: HREF="mdoc.7.html">mdoc</A>. Multi-line column support is now fully compatible with
1.78 ! kristaps 265: groff, as are implicit list entries for columns. Removed manuals.7 in favour of <A
! 266: CLASS="external" HREF="http://manpages.bsd.lv">http://manpages.bsd.lv</A>.
1.77 kristaps 267: </P>
268: </DIV>
1.75 kristaps 269: <DIV CLASS="news">
270: <P>
271: <SPAN CLASS="date">29-05-2010</SPAN>:
272: version 1.10.0
273: </P>
274: <P>
275: Release consisting of the results from the m2k10 hackathon and up-merge from OpenBSD.
276: This requires a significant note of thanks to Ingo Schwarze (OpenBSD) and Joerg
277: Sonnenberger (NetBSD) for their hard work, and again to Joerg for hosting m2k10.
278: Highlights (mostly cribbed from Ingo's m2k10 report) follow in no particular order:
279: </P>
280: <UL>
281: <LI>a <A HREF="roff.3.html">libroff</A> preprocessor in front of <A
282: HREF="mdoc.3.html">libmdoc</A> and <A HREF="man.3.html">libman</A> stripping out
283: <A HREF="roff.7.html">roff</A> instructions;</LI>
284: <LI>end-of-sentence (EOS) detection in free-form and macro lines;</LI>
285: <LI>correct handling of tab-separated columnar lists in <SPAN
286: CLASS="flag">-mdoc</SPAN>;</LI>
287: <LI>improved main calling routines to optionally use mmap() for better
288: performance;</LI>
289: <LI>cleaned up exiting when invoked as <SPAN CLASS="flag">-Tlint</SPAN> or over
290: multiple files with <SPAN CLASS="flag">-fign-errors</SPAN>;</LI>
291: <LI>error and warning message handling re-written to be unified for <A
292: HREF="roff.3.html">libroff</A>, <A HREF="mdoc.3.html">libmdoc</A>, and <A
293: HREF="man.3.html">libman</A>;</LI>
294: <LI>handling of badly-nested explicit-scoped macros;</LI>
295: <LI>improved free-form text parsing in <A HREF="man.3.html">libman</A> and <A
296: HREF="mdoc.3.html">libmdoc</A>;</LI>
297: <LI>significant GNU troff compatibility improvements in <SPAN
298: CLASS="flag">-Tascii</SPAN>, largely in terms of spacing;</LI>
299: <LI>a regression framework for making sure the many fragilities of GNU troff
300: aren't trampled in subsequent work;</LI>
301: <LI>support for <SPAN CLASS="flag">-Tascii</SPAN> breaking at hyphens
302: encountered in free-form text;</LI>
303: <LI>and many more minor fixes and improvements (no really, consult <A
304: HREF="http://mdocml.bsd.lv/cgi-bin/cvsweb/?cvsroot=mdocml">cvsweb</A> and see
305: for yourself!).</LI>
306: </UL>
307: </DIV>
308: <DIV CLASS="news">
309: <P>
310: <SPAN CLASS="date">13-05-2010</SPAN>:
311: version 1.9.25
312: </P>
313: <P>
314: Fixed handling of <Q>\*(Ba</Q> escape. Backed out <SPAN
315: CLASS="flag">-fno-ign-chars</SPAN> (pointless complexity). Fixed erroneous
316: breaking of literal lines. Fixed SYNOPSIS breaking lines before non-initial
317: macros. Changed default section ordering. Most importantly, the framework for
318: end-of-sentence double-spacing is in place, now implemented for the
319: <Q>end-of-sentence, end-of-line</Q> rule. This is a stable roll-back point
320: before the mandoc hackathon in Rostock!
321: </P>
322: </DIV>
323: <DIV CLASS="news">
324: <P>
325: <SPAN CLASS="date">09-05-2010</SPAN>:
326: version 1.9.24
327: </P>
328: <P>
329: Rolled back break-at-hyphen. <SPAN CLASS="flag">-DUGLY</SPAN> is now the
330: default (no feature splits!). Free-form text is not de-chunked any more: lines
331: are passed whole-sale into the front-end, including whitespace. Added mailing
332: lists. Lastly, <SPAN CLASS="nm">mdocml</SPAN> is the focus of two <A
333: CLASS="external" HREF="http://socghop.appspot.com/">Google Summer of Code</A>
334: projects this year: <Q><A CLASS="external"
335: HREF="http://netbsd-soc.sourceforge.net/projects/mandoc_ps/">mandoc -Tps</A></Q>
336: (NetBSD) and <Q><A CLASS="external"
337: HREF="http://wiki.freebsd.org/SummerOfCode2010Projects">BSD-licensed
338: Text-Processing Tools</A></Q> (FreeBSD).
339: </P>
340: </DIV>
341:
342: <DIV CLASS="news">
343: <P>
344: <SPAN CLASS="date">07-04-2010</SPAN>:
345: version 1.9.23
346: </P>
347: <P>
348: <SPAN CLASS="nm">mdocml</SPAN> has been linked to the <A CLASS="external"
349: HREF="http://www.openbsd.org/faq/current.html#20100403">OpenBSD build</a>. This
350: version incorporates many small changes, mostly from patches by OpenBSD,
351: allowing crufty manuals to slip by with warnings instead of erroring-out. Some
352: subtle semantic issues, such as punctuation scope, have also been fixed.
353: Lastly, some issues with <SPAN CLASS="flag">-Thtml</SPAN> have been fixed, which
354: prompted an update to the <A HREF="mandoc.1.html">online</A> <A
355: HREF="mandoc_char.7.html">manual</A> <A HREF="man.7.html">pages</A> style
356: layout.
357: </P>
358: </DIV>
359: <P>
360: See <A HREF="http://mdocml.bsd.lv/cgi-bin/cvsweb/index.sgml?cvsroot=mdocml">cvsweb</A> for
361: historical notes.
362: </P>
1.40 kristaps 363: </TD>
364: </TR>
365: <TR>
366: <TD>
367: <DIV CLASS="foot">
1.78 ! kristaps 368: Copyright © 2008–2010 Kristaps Dzonsons, $Date: 2010/06/03 14:52:48 $
1.40 kristaps 369: </DIV>
370: </TD>
371: </TR>
372: </TBODY>
373: </TABLE>
374: </BODY>
375: </HTML>
CVSweb