mandoc/index.sgml - diff

Return to index.sgml CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/Attic/index.sgml between version 1.92 and 1.106

version 1.92, 2010/08/18 15:57:16

version 1.106, 2011/03/22 10:02:50

Line 39

</P>

<P>

<SPAN CLASS="nm">mdocml</SPAN> consists of the <A HREF="mdoc.3.html">libmdoc</A>, <A

<SPAN CLASS="nm">mdocml</SPAN> consists of the <A HREF="mandoc.3.html">libmandoc</A> validating

HREF="man.3.html">libman</A>, and <A HREF="roff.3.html">libroff</A> validating compilers; and <A

compilers and <A HREF="mandoc.1.html">mandoc</A>, which interfaces with the compiler library to format

HREF="mandoc.1.html">mandoc</A>, which interfaces with the compiler libraries to format output for UNIX

output for UNIX terminals, XHTML, HTML, PostScript, and PDF. It is a <A CLASS="external"

terminals, XHTML, HTML, and PostScript. <SPAN CLASS="nm">mdocml</SPAN> is a <A CLASS="external"

HREF="http://bsd.lv/">BSD.lv</A> project.

</P>

Line 60

Line 59

<P>

<SPAN CLASS="nm">mdocml</SPAN> is architecture- and system-neutral, written in plain-old C. The most

current version is <SPAN CLASS="attn">@VERSION@</SPAN>, dated <SPAN class="attn">@VDATE@</SPAN>. A full

current version is <SPAN CLASS="attn">@VERSION@</SPAN>, dated <SPAN class="attn">@VDATE@</SPAN>.

<A HREF="ChangeLog.html">ChangeLog</A> (<A HREF="ChangeLog.txt">txt</A>) is written with each release.

</P>

<H2>

Line 69

Line 67

</H2>

<COL>

<TBODY>

<TR>

Line 93

Line 91

</H2>

<COL>

<TBODY>

<TR>

Line 132

Line 130

</H2>

<COL>

<TBODY>

<TR>

Line 156

Line 154

</P>

<COL>

<TBODY>

<TR>

<TD VALIGN="top"><A HREF="mandoc.1.html">mandoc(1)</A></TD>

man macro compiler library

format and display UNIX manuals

(<A HREF="man.3.txt">text</A> |

(<A HREF="mandoc.1.txt">text</A> |

<A HREF="man.3.pdf">pdf</A> |

<A HREF="mandoc.1.xhtml">xhtml</A> |

<A HREF="man.3.ps">postscript</A>)

<A HREF="mandoc.1.pdf">pdf</A> |

<A HREF="mandoc.1.ps">postscript</A>)

</SPAN>

</TD>

</TR>

<TR>

<TD VALIGN="top"><A HREF="mandoc.3.html">mandoc(3)</A></TD>

mandoc macro compiler library

(<A HREF="mandoc.3.txt">text</A> |

<A HREF="mandoc.3.xhtml">xhtml</A> |

<A HREF="mandoc.3.pdf">pdf</A> |

<A HREF="mandoc.3.ps">postscript</A>)

</SPAN>

</TD>

</TR>

<TR>

man language reference

(<A HREF="man.7.txt">text</A> |

<A HREF="man.7.xhtml">xhtml</A> |

<A HREF="man.7.pdf">pdf</A> |

<A HREF="man.7.ps">postscript</A>)

</SPAN>

</TD>

</TR>

<TR>

<TD VALIGN="top"><A HREF="mandoc.1.html">mandoc(1)</A></TD>

format and display UNIX manuals

eqn-mandoc language reference

(<A HREF="mandoc.1.txt">text</A> |

(<A HREF="eqn.7.txt">text</A> |

<A HREF="mandoc.1.pdf">pdf</A> |

<A HREF="eqn.7.xhtml">xhtml</A> |

<A HREF="mandoc.1.ps">postscript</A>)

<A HREF="eqn.7.pdf">pdf</A> |

<A HREF="eqn.7.ps">postscript</A>)

</SPAN>

</TD>

</TR>

Line 198

Line 211

mandoc special characters

(<A HREF="mandoc_char.7.txt">text</A> |

<A HREF="mandoc_char.7.xhtml">xhtml</A> |

<A HREF="mandoc_char.7.pdf">pdf</A> |

<A HREF="mandoc_char.7.ps">postscript</A>)

</SPAN>

</TD>

</TR>

<TR>

mdoc macro compiler library

(<A HREF="mdoc.3.txt">text</A> |

<A HREF="mdoc.3.pdf">pdf</A> |

<A HREF="mdoc.3.ps">postscript</A>)

</SPAN>

</TD>

</TR>

<TR>

mdoc language reference

(<A HREF="mdoc.7.txt">text</A> |

<A HREF="mdoc.7.xhtml">xhtml</A> |

<A HREF="mdoc.7.pdf">pdf</A> |

<A HREF="mdoc.7.ps">postscript</A>)

</SPAN>

</TD>

</TR>

<TR>

roff macro compiler library

roff-mandoc language reference

(<A HREF="roff.3.txt">text</A> |

(<A HREF="roff.7.txt">text</A> |

<A HREF="roff.3.pdf">pdf</A> |

<A HREF="roff.7.xhtml">xhtml</A> |

<A HREF="roff.3.ps">postscript</A>)

<A HREF="roff.7.pdf">pdf</A> |

<A HREF="roff.7.ps">postscript</A>)

</SPAN>

</TD>

</TR>

<TR>

roff-mandoc language reference

tbl-mandoc language reference

(<A HREF="roff.7.txt">text</A> |

(<A HREF="tbl.7.txt">text</A> |

<A HREF="roff.7.pdf">pdf</A> |

<A HREF="tbl.7.xhtml">xhtml</A> |

<A HREF="roff.7.ps">postscript</A>)

<A HREF="tbl.7.pdf">pdf</A> |

<A HREF="tbl.7.ps">postscript</A>)

</SPAN>

</TD>

</TR>

Line 263

Line 269

</H1>

<P>

Please use the mailing lists for bug-reports, patches, questions, etc. Beyond that, contact

Please use the mailing lists for bug-reports, patches, questions, etc. (these require

Kristaps at <A

subscription). Beyond that, contact Kristaps at <A

HREF="http://mailhide.recaptcha.net/d?k=01M6h_w7twDp58ZgH57eWC_w==&c=Q2DBUt401ePlSeupJFrq_Q=="

TITLE="Reveal this e-mail address">kris...</A>@bsd.lv.

</P>

<P>

You may also subscribe to several mailing lists (these require subscription, which is

moderated).

</P>

<COL>

<TBODY>

<TR>

Line 285

Line 286

</TD>

<TD>

bug-reports, general questions, and announcements

<SPAN STYLE="font-size: smaller;">(<A HREF="/archives/discuss">archive</A>)</SPAN>

<SPAN STYLE="font-size: smaller;">(<A HREF="/archives/discuss/summary.html">archive</A>)</SPAN>

</TD>

</TR>

<TR>

Line 295

Line 296

</TD>

<TD>

patches and system discussions

<SPAN STYLE="font-size: smaller;">(<A HREF="/archives/tech">archive</A>)</SPAN>

<SPAN STYLE="font-size: smaller;">(<A HREF="/archives/tech/summary.html">archive</A>)</SPAN>

</TD>

</TR>

<TR>

Line 305

Line 306

</TD>

<TD>

source commit messages

<SPAN STYLE="font-size: smaller;">(<A HREF="/archives/source">archive</A>)</SPAN>

<SPAN STYLE="font-size: smaller;">(<A HREF="/archives/source/summary.html">archive</A>)</SPAN>

</TD>

</TR>

</TBODY>

Line 319

Line 320

</H1>

<P>

<SPAN CLASS="date">27-07-2010</SPAN>:

<SPAN CLASS="date">07-01-2011</SPAN>:

version 1.10.5

version 1.10.9

</P>

<P>

Primarily a bug-fix and polish release, but including <SPAN CLASS="flag">-Tpdf</SPAN>

Many back-end fixes have been implemented: argument handling (quoting), <A

support in <A HREF="mandoc.1.html">mandoc</A> by way of <A CLASS="external"

HREF="man.7.html">man</A> improvements, error/warning classes, and many more.

HREF="http://netbsd-soc.sourceforge.net/projects/mandoc_ps/">Summer of Code</A>.

Highlights:

</P>

<UL>

<P>

<LI>fix <Q>Sm</Q> and <Q>Bd</Q> handling</LI>

Initial <A HREF="tbl.7.html">tbl</A> functionality (see the <Q>TS</Q>, <Q>TE</Q>, and

<LI>fix end-of-sentence handling for embedded sentences</LI>

<Q>T&</Q> macros in the <A HREF="roff.7.html#x5c265453">roff</A> manual) has been

<LI>polish <A HREF="man.7.html">man</A> documentation</LI>

merged from <A CLASS="external" HREF="http://tbl.bsd.lv">tbl.bsd.lv</A>. Output is

<LI>document all <A HREF="mdoc.7.html">mdoc</A> macros</LI>

still minimal, especially for <SPAN CLASS="flag">-Thtml</SPAN> and <SPAN

<LI>polish <A HREF="mandoc.1.html">mandoc</A> <SPAN CLASS="flag">-Tps</SPAN> output</LI>

CLASS="flag">-Txhtml</SPAN>, but manages to at least display data. This means that <A

<LI>lots of internal clean-ups in character escapes</LI>

HREF="mandoc.1.html">mandoc</A> now has built-in support for two troff preprocessors via

<LI>un-break literal contexts in <A HREF="man.7.html">man</A> documents</LI>

<DEL>libroff</DEL>: soelim and tbl.

<LI>improve <SPAN CLASS="flag">-Thtml</SPAN> output for <SPAN CLASS="flag">-man</SPAN></LI>

</P>

<LI>add <A HREF="mandoc.1.html">mandoc</A> <SPAN CLASS="flag">-Tpdf</SPAN> support</LI>

</UL>

</DIV>

<P>

<SPAN CLASS="date">12-07-2010</SPAN>:

<SPAN CLASS="date">24-12-2010</SPAN>:

version 1.10.4

version 1.10.8

</P>

<P>

Lots of features developed during both <A CLASS="external"

Significant improvements merged from <A CLASS="external"

HREF="http://netbsd-soc.sourceforge.net/projects/mandoc_ps/">Summer of Code</A> and the

HREF="http://www.openbsd.org">OpenBSD</A> downstream, including

<A CLASS="external" HREF="http://www.openbsd.org">OpenBSD</A> c2k10 hackathon:

</P>

<UL>

<LI>minimal <Q>ds</Q> <A HREF="roff.7.html">roff</A> symbols are supported</LI>

<LI>many new <A HREF="roff.7.html">roff</A> components,</LI>

<LI><Q>Bk</Q> <A HREF="mdoc.7.html">mdoc</A> support</LI>

<LI>in-line implementation of troff's soelim,</LI>

<LI>beautified SYNOPSIS section output</LI>

<LI>broken-block handling,</LI>

<LI>variable font-width and paper-size support in <A HREF="mandoc.1.html">mandoc</A>

<LI>overhauled error classifications, and</LI>

<SPAN CLASS="flag">-Tps</SPAN> output</LI>

<LI>cleaned up handling of error conditions.</LI>

<LI>acceptance of scope-block breakage in <A HREF="mdoc.7.html">mdoc</A></LI>

<LI>clarify error message status</LI>

<LI>many minor bug-fixes and formatting issues resolved</LI>

</UL>

</DIV>

<P>

<SPAN CLASS="date">19-06-2010</SPAN>:

Also overhauled the <SPAN CLASS="flag">-Thtml</SPAN> and <SPAN

version 1.10.2

CLASS="flag">-Txhtml</SPAN> output modes. They now display readable output in arbitrary

browsers, including text-based ones like <A CLASS="external"

HREF="http://lynx.isc.org">lynx</A>. See HTML and XHTML manuals in the <A

HREF="#documentation">DOCUMENTATION</A> section for examples. <SPAN

CLASS="attn">Attention: available style-sheet classes have been considerably

changed!</SPAN> See the <SPAN CLASS="file">example.style.css</SPAN> file for details.

Lastly, <DEL>libmdoc</DEL> and <DEL>libman</DEL> have been

cleaned up and reduced in size and complexity.

</P>

<P>

Small release featuring text-decoration in <SPAN CLASS="flag">-Tps</SPAN> output, a few

minor relaxations of errors, and some optimisations.

</P>

</DIV>

<P>

<SPAN CLASS="date">07-06-2010</SPAN>:

version 1.10.1

</P>

<P>

This primarily focusses on the <Q>Bl</Q> and <Q>It</Q> macros described in <A

HREF="mdoc.7.html">mdoc</A>. Multi-line column support is now fully compatible with

groff, as are implicit list entries for columns. Removed manuals.7 in favour of <A

CLASS="external" HREF="http://manpages.bsd.lv">http://manpages.bsd.lv</A>. The way we

handle the SYNOPSIS section (see the SYNOPSIS documentation in <A

HREF="mdoc.7.html#x4d414e55414cx20x535452554354555245">MANUAL STRUCTURE</A>) has also

been considerably simplified compared to groff's method. Furthermore, the <SPAN

CLASS="flag">-Owidth=width</SPAN> output option has been added to <SPAN

CLASS="flag">-Tascii</SPAN> (see <A HREF="mandoc.1.html">mandoc</A>). Lastly, initial

PostScript output has been added with the <SPAN CLASS="flag">-Tps</SPAN> option to <A

HREF="mandoc.1.html">mandoc</A>. It's brutally simple at the moment: fixed-font, with

no font decorations.

</P>

</DIV>

<P>

<SPAN CLASS="date">29-05-2010</SPAN>:

version 1.10.0

</P>

<P>

Release consisting of the results from the m2k10 hackathon and up-merge from OpenBSD.

This requires a significant note of thanks to Ingo Schwarze (OpenBSD) and Joerg

Sonnenberger (NetBSD) for their hard work, and again to Joerg for hosting m2k10.

Highlights (mostly cribbed from Ingo's m2k10 report) follow in no particular order:

</P>

<UL>

<LI>a <A HREF="roff.3.html">libroff</A> preprocessor in front of <A

HREF="mdoc.3.html">libmdoc</A> and <A HREF="man.3.html">libman</A> stripping out

<A HREF="roff.7.html">roff</A> instructions;</LI>

<LI>end-of-sentence (EOS) detection in free-form and macro lines;</LI>

<LI>correct handling of tab-separated columnar lists in <SPAN

CLASS="flag">-mdoc</SPAN>;</LI>

<LI>improved main calling routines to optionally use mmap() for better

performance;</LI>

<LI>cleaned up exiting when invoked as <SPAN CLASS="flag">-Tlint</SPAN> or over

multiple files with <SPAN CLASS="flag">-fign-errors</SPAN>;</LI>

<LI>error and warning message handling re-written to be unified for <A

HREF="roff.3.html">libroff</A>, <A HREF="mdoc.3.html">libmdoc</A>, and <A

HREF="man.3.html">libman</A>;</LI>

<LI>handling of badly-nested explicit-scoped macros;</LI>

<LI>improved free-form text parsing in <A HREF="man.3.html">libman</A> and <A

HREF="mdoc.3.html">libmdoc</A>;</LI>

<LI>significant GNU troff compatibility improvements in <SPAN

CLASS="flag">-Tascii</SPAN>, largely in terms of spacing;</LI>

<LI>a regression framework for making sure the many fragilities of GNU troff

aren't trampled in subsequent work;</LI>

<LI>support for <SPAN CLASS="flag">-Tascii</SPAN> breaking at hyphens

encountered in free-form text;</LI>

<LI>and many more minor fixes and improvements (no really, consult <A

HREF="http://mdocml.bsd.lv/cgi-bin/cvsweb/?cvsroot=mdocml">cvsweb</A> and see

for yourself!).</LI>

</UL>

</DIV>

<P>

See <A HREF="http://mdocml.bsd.lv/cgi-bin/cvsweb/index.sgml?cvsroot=mdocml">cvsweb</A> for

historical notes.

Line 439

Line 374

<TR>

<TD>

</DIV>

</TD>

</TR>

CVSweb