Annotation of mandoc/index.sgml, Revision 1.51
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.1 kristaps 23: DESCRIPTION
1.40 kristaps 24: </H1>
1.1 kristaps 25:
1.40 kristaps 26: <P>
27: <SPAN CLASS="nm">mdocml</SPAN> is a suite of tools compiling <Q>-mdoc</Q>, the roff macro package
28: of choice for BSD manual pages, and <Q>-man</Q>, the predominant historical package for UNIX
29: manuals. The mission of <SPAN CLASS="nm">mdocml</SPAN> is to deprecate <A
30: HREF="http://www.gnu.org/software/groff/" CLASS="external">groff</A>, the GNU roff implementation, for
1.18 kristaps 31: 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
37: this (respectively small, C, ISC-licensed, fast and regular).
1.40 kristaps 38: </P>
1.1 kristaps 39:
1.40 kristaps 40: <P>
41: The core of <SPAN CLASS="nm">mdocml</SPAN> is composed of the <i>libmdoc</i> and <i>libman</i>
1.19 kristaps 42: validating compiler libraries. Both are simple, fast libraries operating on memory buffers, so they may
43: be used for a variety of front-ends (terminal-based, CGI and so on). The primary front-end is <i>
44: mandoc</i>, which formats manuals for display on the terminal.
1.40 kristaps 45: </P>
46:
47: <P>
48: The <SPAN CLASS="nm">mdocml</SPAN> utility is a <A CLASS="external" HREF="http://bsd.lv/">BSD.lv
49: Project</A> member.
50: </P>
51: </TD>
52: </TR>
53: <TR>
54: <TD>
55: <H1>
1.33 kristaps 56: SOURCES
1.40 kristaps 57: </H1>
1.1 kristaps 58:
1.40 kristaps 59: <P>
1.39 kristaps 60: Sources correctly build and install on DragonFly BSD, FreeBSD, OpenBSD, NetBSD, and GNU/Linux operating
1.40 kristaps 61: systems, tested variously on i386, AMD64, alpha, and others. The most current version is <SPAN
62: CLASS="attn">@VERSION@</SPAN>, dated <SPAN class="attn">@VDATE@</SPAN>. A full <A
63: HREF="ChangeLog.html">ChangeLog</A> (<A HREF="ChangeLog.txt">txt</A>) is written with each release.
64: </P>
1.7 kristaps 65:
1.40 kristaps 66: <H2>
1.26 kristaps 67: Current
1.40 kristaps 68: </H2>
1.1 kristaps 69:
1.40 kristaps 70: <TABLE WIDTH="100%" SUMMARY="Current Sources">
71: <COL WIDTH="200">
72: <COL>
73: <TBODY>
74: <TR>
75: <TD>Source archive</TD>
76: <TD>
77: <A HREF="/snapshots/mdocml.tar.gz">/snapshots/mdocml.tar.gz</A>
78: (<A HREF="/snapshots/mdocml.md5">md5</A>)
79: </TD>
80: </TR>
81: <TR>
82: <TD>Online source</TD>
83: <TD>
84: <A CLASS="external" HREF="http://mdocml.bsd.lv/cgi-bin/cvsweb/?cvsroot=mdocml">cvsweb</A>
85: </TD>
86: </TR>
87: </TBODY>
88: </TABLE>
1.1 kristaps 89:
1.40 kristaps 90: <H2>
1.26 kristaps 91: Downstream
1.40 kristaps 92: </H2>
1.1 kristaps 93:
1.40 kristaps 94: <TABLE WIDTH="100%" SUMMARY="Downstream Sources">
95: <COL WIDTH="200">
96: <COL>
97: <TBODY>
98: <TR>
99: <TD>DragonFly BSD</TD>
100: <TD>
101: <A HREF="http://gitweb.dragonflybsd.org/dragonfly.git/tree/HEAD:/usr.bin/mandoc"
102: CLASS="external">usr.bin/mandoc</A>
103: </TD>
104: </TR>
105: <TR>
106: <TD>FreeBSD</TD>
107: <TD>
108: <A HREF="http://www.freebsd.org/cgi/cvsweb.cgi/ports/textproc/mdocml/"
109: CLASS="external">ports/textproc/mdocml</A>
110: </TD>
111: </TR>
112: <TR>
113: <TD>NetBSD</TD>
114: <TD>
115: <A HREF="http://cvsweb.netbsd.org/bsdweb.cgi/src/external/bsd/mdocml/"
116: CLASS="external">src/external/bsd/mdocml</A>
117: </TD>
118: </TR>
119: <TR>
120: <TD>OpenBSD</TD>
121: <TD>
122: <A HREF="http://www.openbsd.org/cgi-bin/cvsweb/src/usr.bin/mandoc/"
123: CLASS="external">src/usr.bin/mandoc</A>
124: </TD>
125: </TR>
126: </TBODY>
127: </TABLE>
1.1 kristaps 128:
1.40 kristaps 129: <H2>
1.22 kristaps 130: Historical
1.40 kristaps 131: </H2>
1.10 kristaps 132:
1.40 kristaps 133: <TABLE WIDTH="100%" SUMMARY="Archived Sources">
134: <COL WIDTH="200">
135: <COL>
136: <TBODY>
137: <TR>
138: <TD>Source archive</TD>
139: <TD>
140: <A HREF="/snapshots/">/snapshots/</A>
141: </TD>
142: </TR>
143: </TBODY>
144: </TABLE>
145: </TD>
146: </TR>
147: <TR>
148: <TD>
149: <H1>
1.18 kristaps 150: DOCUMENTATION
1.40 kristaps 151: </H1>
1.18 kristaps 152:
1.40 kristaps 153: <P>
1.39 kristaps 154: These manuals are generated automatically and refer to the current snapshot.
1.40 kristaps 155: </P>
1.24 kristaps 156:
1.40 kristaps 157: <TABLE WIDTH="100%" SUMMARY="Documentation">
158: <COL WIDTH="200">
159: <COL>
160: <TBODY>
161: <TR>
162: <TD><A HREF="mandoc.1.html">mandoc(1)</A> (<A HREF="mandoc.1.txt">text</A>)</TD>
163: <TD>format and display UNIX manuals</TD>
164: </TR>
165: <TR>
166: <TD><A HREF="mandoc_char.7.html">mandoc_char(7)</A> (<A HREF="mandoc_char.7.txt">text</A>)</TD>
167: <TD>mandoc special characters</TD>
168: </TR>
169: <TR>
170: <TD><A HREF="mdoc.7.html">mdoc(7)</A> (<A HREF="mdoc.7.txt">text</A>)</TD>
171: <TD>mdoc language reference</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>
178: <TD><A HREF="manuals.7.html">manuals(7)</A> (<A HREF="manuals.7.txt">text</A>)</TD>
179: <TD>a guide to writing UNIX manuals</TD>
180: </TR>
181: <TR>
182: <TD><A HREF="mdoc.3.html">mdoc(3)</A> (<A HREF="mdoc.3.txt">text</A>)</TD>
183: <TD>mdoc macro compiler library</TD>
184: </TR>
185: <TR>
186: <TD><A HREF="man.3.html">man(3)</A> (<A HREF="man.3.txt">text</A>)</TD>
187: <TD>man macro compiler library</TD>
188: </TR>
189: </TBODY>
190: </TABLE>
191: </TD>
192: </TR>
193: <TR>
194: <TD>
195: <H1>
1.1 kristaps 196: CONTACT
1.40 kristaps 197: </H1>
1.1 kristaps 198:
1.40 kristaps 199: <P>
200: For all issues related to <SPAN CLASS="nm">mdocml</SPAN>, contact Kristaps Dzonsons, kris<A
201: CLASS="external"
202: HREF="http://mailhide.recaptcha.net/d?k=01M6h_w7twDp58ZgH57eWC_w==&c=Q2DBUt401ePlSeupJFrq_Q=="
203: TITLE="Reveal this e-mail address">...</A>@bsd.lv.
204: </P>
1.18 kristaps 205:
1.40 kristaps 206: <P>
1.24 kristaps 207: If you want to receive a semi-automated mail-out of new releases, then please write with a message
1.40 kristaps 208: subject of <I>subscribe mdocml</I> (or <I>unsubscribe mdocml</I>).
209: </P>
210: </TD>
211: </TR>
212: <TR>
213: <TD>
214: <H1>
215: NEWS
216: </H1>
217:
218: <TABLE WIDTH="100%" CELLPADDING="2">
1.42 kristaps 219: <COL CLASS="date">
1.40 kristaps 220: <TBODY>
221: <TR>
1.51 ! kristaps 222: <TD VALIGN="top"><SPAN CLASS="date">07-04-2010</SPAN></TD>
1.50 kristaps 223: <TD VALIGN="top">
224: <SPAN CLASS="nm">mdocml</SPAN> has been linked to the <A CLASS="external"
225: HREF="http://www.openbsd.org/faq/current.html#20100403">OpenBSD build</a>. This
226: version incorporates many small changes, mostly from patches by OpenBSD,
227: allowing crufty manuals to slip by with warnings instead of erroring-out. Some
228: subtle semantic issues, such as punctuation scope, have also been fixed.
229: Lastly, some issues with <SPAN CLASS="flag">-Thtml</SPAN> have been fixed, which
230: prompted an update to the <A HREF="mandoc.1.html">online</A> <A
231: HREF="mandoc_char.7.html">manual</A> <A HREF="man.7.html">pages</A> style
232: layout.
233: </TD>
234: </TR>
235:
236: <TR>
1.49 kristaps 237: <TD VALIGN="top"><SPAN CLASS="date">31-03-2010</SPAN></TD>
238: <TD VALIGN="top">
239: Version <SPAN CLASS="rev">1.9.22</SPAN>: adjusted merge of the significant work
240: by Ingo Schwarze in getting <Q>Xo</Q> blocks (block full implicit, e.g.,
241: <Q>It</Q> for non-columnar lists) to work properly. This isn't enabled by
242: default: you must specify <SPAN CLASS="flag">-DUGLY</SPAN> as a compiler flag
243: (see the Makefile for details).
244: </TD>
245: </TR>
246: <TR>
1.48 kristaps 247: <TD VALIGN="top"><SPAN CLASS="date">30-03-2010</SPAN></TD>
1.47 kristaps 248: <TD VALIGN="top">
249: Version <SPAN CLASS="rev">1.9.20</SPAN>: more efforts to get roff instructions
1.48 kristaps 250: in -man documents under control. Note that roff instructions embedded in
251: line-scoped, next-line macros (e.g. <Q>B</Q>) are not supported. Leading
252: punctuation for -mdoc macros, such as <Q>Fl ( ( a</Q>, are now correctly
253: handled.
1.47 kristaps 254: </TD>
255: </TR>
256: <TR>
1.46 kristaps 257: <TD VALIGN="top"><SPAN CLASS="date">27-03-2010</SPAN></TD>
258: <TD VALIGN="top">
259: Version <SPAN CLASS="rev">1.9.18</SPAN>: many fixes (largely pertaining to
260: scope) and improvements (e.g., handling of apostrophe-control macros, which
261: fixes the strange <Q>BR</Q> seen in some macro output) to handling roff
262: instructions in -man documents.
263: </TD>
264: </TR>
265: <TR>
1.45 kristaps 266: <TD VALIGN="top"><SPAN CLASS="date">25-03-2010</SPAN></TD>
1.43 kristaps 267: <TD VALIGN="top">
1.45 kristaps 268: Version <SPAN CLASS="rev">1.9.17</SPAN> highlights: accept <A
269: HREF="http://perldoc.perl.org/" CLASS="external">perlpod</A> standard preamble.
270: Also accept (and discard) <Q>de</Q>, <Q>dei</Q>, <Q>am</Q>, <Q>ami</Q>, and
271: <Q>ig</Q> roff macro blocks.
1.43 kristaps 272: </TD>
273: </TR>
274: <TR>
1.42 kristaps 275: <TD VALIGN="top"><SPAN CLASS="date">22-03-2010</SPAN></TD>
276: <TD VALIGN="top">
277: Version <SPAN CLASS="rev">1.9.16</SPAN> highlights: inspired by patches and bug
278: reports by Ingo Schwarze, allowed <SPAN CLASS="flag">-man</SPAN> to accept
279: non-printing elements to be nested within next-line scopes, such as <Q>br</Q>
280: within <Q>B</Q> or <Q>TH</Q>, which is valid roff. Longsoon architecture also
281: noted and Makefile cleaned up.
282: </TD>
283: </TR>
284: <TR>
1.41 kristaps 285: <TD VALIGN="top"><SPAN CLASS="date">18-02-2010</SPAN></TD>
1.40 kristaps 286: <TD VALIGN="top">
287: Moved to our new <A HREF="http://bsd.lv" CLASS="external">BSD.lv</A> home.
1.41 kristaps 288: Version <SPAN CLASS="rev">1.9.15</SPAN> highlights: XHTML is now an acceptable
289: output mode for <A HREF="mandoc.1.html">mandoc(1)</A>; <Q>Xr</Q> made more
290: compatible with groff; <Q>Vt</Q> fixed when invoked in SYNOPSIS; <Q>\\</Q>
291: escape removed; end-of-line white-space detected for all lines; subtle bug
292: fixed in list display for some modes; compatibility layer checked in for
293: compilation in diverse UNIX systems; and column lengths handled correctly.
1.40 kristaps 294: </TD>
295: </TR>
296: </TBODY>
297: </TABLE>
298: </TD>
299: </TR>
300: <TR>
301: <TD>
302: <DIV CLASS="foot">
1.51 ! kristaps 303: Copyright © 2008–2010 Kristaps Dzonsons, $Date: 2010/04/06 11:52:04 $
1.40 kristaps 304: </DIV>
305: </TD>
306: </TR>
307: </TBODY>
308: </TABLE>
309: </BODY>
310: </HTML>
CVSweb