[BACK]Return to index.sgml CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Annotation of mandoc/index.sgml, Revision 1.52

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> &#8211; 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==&amp;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
1.52    ! kristaps  232:                                                                layout.  Version: <SPAN CLASS="rev">1.9.23</SPAN>.
1.50      kristaps  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.52    ! kristaps  303:                                                Copyright &#169; 2008&#8211;2010 Kristaps Dzonsons, $Date: 2010/04/07 11:25:56 $
1.40      kristaps  304:                                        </DIV>
                    305:                                </TD>
                    306:                        </TR>
                    307:                </TBODY>
                    308:        </TABLE>
                    309:        </BODY>
                    310: </HTML>

CVSweb