index.sgml

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
   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">
   7                 <TITLE>mdocml.bsd.lv</TITLE>
   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>
  23                                         DESCRIPTION
  24                                         </H1>
  25
  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
  31                                         displaying -mdoc pages whilst providing token support for -man.
  32                                         </P>
  33
  34                                         <P>
  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).
  38                                         </P>
  39
  40                                         <P>
  41                                         The core of <SPAN CLASS="nm">mdocml</SPAN> is composed of the <i>libmdoc</i> and <i>libman</i>
  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.
  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>
  56                                         SOURCES
  57                                         </H1>
  58
  59                                         <P>
  60                                         Sources correctly build and install on DragonFly BSD, FreeBSD, OpenBSD, NetBSD, and GNU/Linux operating
  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>
  65
  66                                         <H2>
  67                                         Current
  68                                         </H2>
  69
  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>
  89
  90                                         <H2>
  91                                         Downstream
  92                                         </H2>
  93
  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>
 128
 129                                         <H2>
 130                                         Historical
 131                                         </H2>
 132
 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>
 150                                         DOCUMENTATION
 151                                         </H1>
 152
 153                                         <P>
 154                                         These manuals are generated automatically and refer to the current snapshot.
 155                                         </P>
 156
 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>
 196                                         CONTACT
 197                                         </H1>
 198
 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>
 205
 206                                         <P>
 207                                         If you want to receive a semi-automated mail-out of new releases, then please write with a message
 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">
 219                                                 <COL CLASS="date">
 220                                                 <TBODY>
 221                                                         <TR>
 222                                                                 <TD VALIGN="top"><SPAN CLASS="date">27-03-2010</SPAN></TD>
 223                                                                 <TD VALIGN="top">
 224                                                                 Version <SPAN CLASS="rev">1.9.18</SPAN>: many fixes (largely pertaining to
 225                                                                 scope) and improvements (e.g., handling of apostrophe-control macros, which
 226                                                                 fixes the strange <Q>BR</Q> seen in some macro output) to handling roff
 227                                                                 instructions in -man documents.
 228                                                                 </TD>
 229                                                         </TR>
 230                                                         <TR>
 231                                                                 <TD VALIGN="top"><SPAN CLASS="date">25-03-2010</SPAN></TD>
 232                                                                 <TD VALIGN="top">
 233                                                                 Version <SPAN CLASS="rev">1.9.17</SPAN> highlights: accept <A
 234                                                                 HREF="http://perldoc.perl.org/" CLASS="external">perlpod</A> standard preamble.
 235                                                                 Also accept (and discard) <Q>de</Q>, <Q>dei</Q>, <Q>am</Q>, <Q>ami</Q>, and
 236                                                                 <Q>ig</Q> roff macro blocks.
 237                                                                 </TD>
 238                                                         </TR>
 239                                                         <TR>
 240                                                                 <TD VALIGN="top"><SPAN CLASS="date">22-03-2010</SPAN></TD>
 241                                                                 <TD VALIGN="top">
 242                                                                 Version <SPAN CLASS="rev">1.9.16</SPAN> highlights: inspired by patches and bug
 243                                                                 reports by Ingo Schwarze, allowed <SPAN CLASS="flag">-man</SPAN> to accept
 244                                                                 non-printing elements to be nested within next-line scopes, such as <Q>br</Q>
 245                                                                 within <Q>B</Q> or <Q>TH</Q>, which is valid roff.  Longsoon architecture also
 246                                                                 noted and Makefile cleaned up.
 247                                                                 </TD>
 248                                                         </TR>
 249                                                         <TR>
 250                                                                 <TD VALIGN="top"><SPAN CLASS="date">18-02-2010</SPAN></TD>
 251                                                                 <TD VALIGN="top">
 252                                                                 Moved to our new <A HREF="http://bsd.lv" CLASS="external">BSD.lv</A> home.
 253                                                                 Version <SPAN CLASS="rev">1.9.15</SPAN> highlights: XHTML is now an acceptable
 254                                                                 output mode for <A HREF="mandoc.1.html">mandoc(1)</A>;  <Q>Xr</Q> made more
 255                                                                 compatible with groff; <Q>Vt</Q> fixed when invoked in SYNOPSIS;  <Q>\\</Q>
 256                                                                 escape removed; end-of-line white-space detected for all lines;  subtle bug
 257                                                                 fixed in list display for some modes;  compatibility layer checked in for
 258                                                                 compilation in diverse UNIX systems;  and column lengths handled correctly.
 259                                                                 </TD>
 260                                                         </TR>
 261                                                 </TBODY>
 262                                         </TABLE>
 263                                 </TD>
 264                         </TR>
 265                         <TR>
 266                                 <TD>
 267                                         <DIV CLASS="foot">
 268                                                 Copyright &#169; 2008&#8211;2010 Kristaps Dzonsons, $Date: 2010/03/27 10:04:56 $
 269                                         </DIV>
 270                                 </TD>
 271                         </TR>
 272                 </TBODY>
 273         </TABLE>
 274         </BODY>
 275 </HTML>