Switch on the `TS' documentation in roff.7. As per off-line discussion,

[mandoc.git] / index.sgml

diff --git a/index.sgml b/index.sgml
index fdbf833c3ea439424a23e3bdf7a4985b70d88b0c..83e2b18eabc596fc56ab9306eff4e002483a65a2 100644 (file)
--- a/index.sgml
+++ b/index.sgml
@@ -42,7 +42,7 @@
                                        <SPAN CLASS="nm">mdocml</SPAN> consists of the <A HREF="mdoc.3.html">libmdoc</A>, <A
                                        HREF="man.3.html">libman</A>, and <A HREF="roff.3.html">libroff</A> validating compilers; and <A
                                        HREF="mandoc.1.html">mandoc</A>, which interfaces with the compiler libraries to format output for UNIX
                                        <SPAN CLASS="nm">mdocml</SPAN> consists of the <A HREF="mdoc.3.html">libmdoc</A>, <A
                                        HREF="man.3.html">libman</A>, and <A HREF="roff.3.html">libroff</A> validating compilers; and <A
                                        HREF="mandoc.1.html">mandoc</A>, which interfaces with the compiler libraries to format output for UNIX

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

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


@@ -69,7 +69,7 @@
                                        </H2>
 
                                        <TABLE WIDTH="100%" SUMMARY="Current Sources">
                                        </H2>
 
                                        <TABLE WIDTH="100%" SUMMARY="Current Sources">

-                                       <COL WIDTH="200">
+                                       <COL WIDTH="175">

                                        <COL>
                                        <TBODY>
                                                <TR>
                                        <COL>
                                        <TBODY>
                                                <TR>


@@ -93,7 +93,7 @@
                                        </H2>
 
                                        <TABLE WIDTH="100%" SUMMARY="Downstream Sources">
                                        </H2>
 
                                        <TABLE WIDTH="100%" SUMMARY="Downstream Sources">

-                                       <COL WIDTH="200">
+                                       <COL WIDTH="175">

                                        <COL>
                                        <TBODY>
                                                <TR>
                                        <COL>
                                        <TBODY>
                                                <TR>


@@ -132,7 +132,7 @@
                                        </H2>
 
                                        <TABLE WIDTH="100%" SUMMARY="Archived Sources">
                                        </H2>
 
                                        <TABLE WIDTH="100%" SUMMARY="Archived Sources">

-                                       <COL WIDTH="200">
+                                       <COL WIDTH="175">

                                        <COL>
                                        <TBODY>
                                                <TR>
                                        <COL>
                                        <TBODY>
                                                <TR>


@@ -156,7 +156,7 @@
                                        </P>
 
                                        <TABLE WIDTH="100%" SUMMARY="Documentation">
                                        </P>
 
                                        <TABLE WIDTH="100%" SUMMARY="Documentation">

-                                       <COL WIDTH="200">
+                                       <COL WIDTH="175">

                                        <COL>
                                        <TBODY>
                                                <TR>
                                        <COL>
                                        <TBODY>
                                                <TR>


@@ -164,7 +164,10 @@
                                                        <TD VALIGN="top">
                                                                man macro compiler library
                                                                <SPAN STYLE="font-size: smaller;">
                                                        <TD VALIGN="top">
                                                                man macro compiler library
                                                                <SPAN STYLE="font-size: smaller;">

-                                                                       (<A HREF="man.3.txt">text</A> | <A HREF="man.3.ps">postscript</A>)
+                                                                       (<A HREF="man.3.txt">text</A> | 
+                                                                       <A HREF="man.3.xhtml">xhtml</A> |
+                                                                       <A HREF="man.3.pdf">pdf</A> |
+                                                                       <A HREF="man.3.ps">postscript</A>)

                                                                </SPAN>
                                                        </TD>
                                                </TR>
                                                                </SPAN>
                                                        </TD>
                                                </TR>


@@ -173,7 +176,10 @@
                                                        <TD VALIGN="top">
                                                                man language reference
                                                                <SPAN STYLE="font-size: smaller;">
                                                        <TD VALIGN="top">
                                                                man language reference
                                                                <SPAN STYLE="font-size: smaller;">

-                                                                       (<A HREF="man.7.txt">text</A> | <A HREF="man.7.ps">postscript</A>)
+                                                                       (<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>
                                                                </SPAN>
                                                        </TD>
                                                </TR>


@@ -182,7 +188,10 @@
                                                        <TD VALIGN="top">
                                                                format and display UNIX manuals
                                                                <SPAN STYLE="font-size: smaller;">
                                                        <TD VALIGN="top">
                                                                format and display UNIX manuals
                                                                <SPAN STYLE="font-size: smaller;">

-                                                                       (<A HREF="mandoc.1.txt">text</A> | <A HREF="mandoc.1.ps">postscript</A>)
+                                                                       (<A HREF="mandoc.1.txt">text</A> | 
+                                                                       <A HREF="mandoc.1.xhtml">xhtml</A> |
+                                                                       <A HREF="mandoc.1.pdf">pdf</A> |
+                                                                       <A HREF="mandoc.1.ps">postscript</A>)

                                                                </SPAN>
                                                        </TD>
                                                </TR>
                                                                </SPAN>
                                                        </TD>
                                                </TR>


@@ -191,8 +200,10 @@
                                                        <TD VALIGN="top">
                                                                mandoc special characters
                                                                <SPAN STYLE="font-size: smaller;">
                                                        <TD VALIGN="top">
                                                                mandoc special characters
                                                                <SPAN STYLE="font-size: smaller;">

-                                                                       (<A HREF="mandoc_char.7.txt">text</A> | <A
-                                                                       HREF="mandoc_char.7.ps">postscript</A>)
+                                                                       (<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>
                                                                </SPAN>
                                                        </TD>
                                                </TR>


@@ -201,7 +212,10 @@
                                                        <TD VALIGN="top">
                                                                mdoc macro compiler library
                                                                <SPAN STYLE="font-size: smaller;">
                                                        <TD VALIGN="top">
                                                                mdoc macro compiler library
                                                                <SPAN STYLE="font-size: smaller;">

-                                                                       (<A HREF="mdoc.3.txt">text</A> | <A HREF="mdoc.3.ps">postscript</A>)
+                                                                       (<A HREF="mdoc.3.txt">text</A> | 
+                                                                       <A HREF="mdoc.3.xhtml">xhtml</A> |
+                                                                       <A HREF="mdoc.3.pdf">pdf</A> |
+                                                                       <A HREF="mdoc.3.ps">postscript</A>)

                                                                </SPAN>
                                                        </TD>
                                                </TR>
                                                                </SPAN>
                                                        </TD>
                                                </TR>


@@ -210,7 +224,10 @@
                                                        <TD VALIGN="top">
                                                                mdoc language reference
                                                                <SPAN STYLE="font-size: smaller;">
                                                        <TD VALIGN="top">
                                                                mdoc language reference
                                                                <SPAN STYLE="font-size: smaller;">

-                                                                       (<A HREF="mdoc.7.txt">text</A> | <A HREF="mdoc.7.ps">postscript</A>)
+                                                                       (<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>
                                                                </SPAN>
                                                        </TD>
                                                </TR>


@@ -219,7 +236,10 @@
                                                        <TD VALIGN="top">
                                                                roff macro compiler library
                                                                <SPAN STYLE="font-size: smaller;">
                                                        <TD VALIGN="top">
                                                                roff macro compiler library
                                                                <SPAN STYLE="font-size: smaller;">

-                                                                       (<A HREF="roff.3.txt">text</A> | <A HREF="roff.3.ps">postscript</A>)
+                                                                       (<A HREF="roff.3.txt">text</A> | 
+                                                                       <A HREF="roff.3.xhtml">xhtml</A> |
+                                                                       <A HREF="roff.3.pdf">pdf</A> |
+                                                                       <A HREF="roff.3.ps">postscript</A>)

                                                                </SPAN>
                                                        </TD>
                                                </TR>
                                                                </SPAN>
                                                        </TD>
                                                </TR>


@@ -228,7 +248,10 @@
                                                        <TD VALIGN="top">
                                                                roff-mandoc language reference
                                                                <SPAN STYLE="font-size: smaller;">
                                                        <TD VALIGN="top">
                                                                roff-mandoc language reference
                                                                <SPAN STYLE="font-size: smaller;">

-                                                                       (<A HREF="roff.7.txt">text</A> | <A HREF="roff.7.ps">postscript</A>)
+                                                                       (<A HREF="roff.7.txt">text</A> | 
+                                                                       <A HREF="roff.7.xhtml">xhtml</A> |
+                                                                       <A HREF="roff.7.pdf">pdf</A> |
+                                                                       <A HREF="roff.7.ps">postscript</A>)

                                                                </SPAN>
                                                        </TD>
                                                </TR>
                                                                </SPAN>
                                                        </TD>
                                                </TR>


@@ -256,12 +279,11 @@
 
                                        <P>
                                                You may also subscribe to several mailing lists (these require subscription, which is
 
                                        <P>
                                                You may also subscribe to several mailing lists (these require subscription, which is

-                                               moderated).  An archive is not yet available on-line, although you may request one once
-                                               subscribed.
+                                               moderated).

                                        </P>
 
                                        <TABLE WIDTH="100%" SUMMARY="Mailing Lists">
                                        </P>
 
                                        <TABLE WIDTH="100%" SUMMARY="Mailing Lists">

-                                               <COL WIDTH="200">
+                                               <COL WIDTH="175">

                                                <COL>
                                                <TBODY>
                                                        <TR>
                                                <COL>
                                                <TBODY>
                                                        <TR>


@@ -269,21 +291,30 @@
                                                                        disc<A CLASS="external" TITLE="Reveal this e-mail address"
                                                                        HREF="http://www.google.com/recaptcha/mailhide/d?k=01KQ80PFH5n3BBNpF5Gs4sRg==&amp;c=EV1QytpQqTHSItc2IXvZyocgYLPnG5K0JKw_gwMC9yc=">...</A>@mdocml.bsd.lv
                                                                </TD>
                                                                        disc<A CLASS="external" TITLE="Reveal this e-mail address"
                                                                        HREF="http://www.google.com/recaptcha/mailhide/d?k=01KQ80PFH5n3BBNpF5Gs4sRg==&amp;c=EV1QytpQqTHSItc2IXvZyocgYLPnG5K0JKw_gwMC9yc=">...</A>@mdocml.bsd.lv
                                                                </TD>

-                                                               <TD>bug-reports, general questions, and announcements</TD>
+                                                               <TD>
+                                                                       bug-reports, general questions, and announcements 
+                                                                       <SPAN STYLE="font-size: smaller;">(<A HREF="/archives/discuss/summary.html">archive</A>)</SPAN>
+                                                               </TD>

                                                        </TR>
                                                        <TR>
                                                                <TD>
                                                                        tec<A CLASS="external" TITLE="Reveal this e-mail address"
                                                                        HREF="http://www.google.com/recaptcha/mailhide/d?k=01qDX_iV0RlUOarEvb6mR28g==&amp;c=gRXsTjza0NNCFPaYu-Taj2tF0pmYZSc90EZkFkhkxgo=">...</A>@mdocml.bsd.lv
                                                                </TD>
                                                        </TR>
                                                        <TR>
                                                                <TD>
                                                                        tec<A CLASS="external" TITLE="Reveal this e-mail address"
                                                                        HREF="http://www.google.com/recaptcha/mailhide/d?k=01qDX_iV0RlUOarEvb6mR28g==&amp;c=gRXsTjza0NNCFPaYu-Taj2tF0pmYZSc90EZkFkhkxgo=">...</A>@mdocml.bsd.lv
                                                                </TD>

-                                                               <TD>patches and system discussions</TD>
+                                                               <TD>
+                                                                       patches and system discussions 
+                                                                       <SPAN STYLE="font-size: smaller;">(<A HREF="/archives/tech/summary.html">archive</A>)</SPAN>
+                                                               </TD>

                                                        </TR>
                                                        <TR>
                                                                <TD>
                                                                        sou<A CLASS="external" TITLE="Reveal this e-mail address"
                                                                        HREF="http://www.google.com/recaptcha/mailhide/d?k=01prQrAZhhl2EbIwVcRfABsQ==&amp;c=KtTW4Yic9xk-8g40KzJoca4fR3MYXv28g8NC6OQV-T8=">...</A>@mdocml.bsd.lv
                                                                </TD>
                                                        </TR>
                                                        <TR>
                                                                <TD>
                                                                        sou<A CLASS="external" TITLE="Reveal this e-mail address"
                                                                        HREF="http://www.google.com/recaptcha/mailhide/d?k=01prQrAZhhl2EbIwVcRfABsQ==&amp;c=KtTW4Yic9xk-8g40KzJoca4fR3MYXv28g8NC6OQV-T8=">...</A>@mdocml.bsd.lv
                                                                </TD>

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

                                                        </TR>
                                                </TBODY>
                                        </TABLE>
                                                        </TR>
                                                </TBODY>
                                        </TABLE>


@@ -296,22 +327,68 @@
                                        </H1>
                                        <DIV CLASS="news">
                                                <P>
                                        </H1>
                                        <DIV CLASS="news">
                                                <P>

-                                                       <SPAN CLASS="date">XX-07-2010</SPAN>:
+                                                       <SPAN CLASS="date">24-12-2010</SPAN>:
+                                                       version 1.10.8
+                                               </P>
+                                               <P>
+                                                       Significant improvements merged from <A CLASS="external"
+                                                       HREF="http://www.openbsd.org">OpenBSD</A> downstream, including
+                                               </P>
+                                               <UL>
+                                                       <LI>many new <A HREF="roff.7.html">roff</A> components,</LI>
+                                                       <LI>in-line implementation of troff's soelim,</LI>
+                                                       <LI>broken-block handling,</LI>
+                                                       <LI>overhauled error classifications, and</LI>
+                                                       <LI>cleaned up handling of error conditions.</LI>
+                                               </UL>
+                                               <P>
+                                                       Also overhauled the <SPAN CLASS="flag">-Thtml</SPAN> and <SPAN
+                                                       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, <A HREF="mdoc.3.html">libmdoc</A> and <A HREF="man.3.html">libman</A> have been
+                                                       cleaned up and reduced in size and complexity.
+                                               </P>
+                                       </DIV>
+                                       <DIV CLASS="news">
+                                               <P>
+                                                       <SPAN CLASS="date">27-09-2010</SPAN>:
+                                                       version 1.10.6
+                                               </P>
+                                               <P>
+                                                       Calling conventions for <A HREF="mandoc.1.html">mandoc</A> have changed: <SPAN
+                                                       CLASS="flag">-W</SPAN> improved and <SPAN CLASS="flag">-f</SPAN> deprecated.  Non-ASCII
+                                                       characters are also now uniformly discarded.  Lots of documentation improvements.  Many
+                                                       incremental fixes accomodating for groff's more interesting productions.  Lastly, <A
+                                                       HREF="http://perldoc.perl.org/pod2man.html" CLASS="external">pod2man</A> preambles are
+                                                       now fully accepted after some considerable <A HREF="roff.7.html">roff</A> and special
+                                                       character support.
+                                               </P>
+                                       </DIV>
+                                       <DIV CLASS="news">
+                                               <P>
+                                                       <SPAN CLASS="date">27-07-2010</SPAN>:

                                                        version 1.10.5
                                                </P>
                                                <P>
                                                        version 1.10.5
                                                </P>
                                                <P>

-                                                       Purely a bug-fix and polish release.  Highlights:
+                                                       Primarily a bug-fix and polish release, but including <SPAN CLASS="flag">-Tpdf</SPAN>
+                                                       support in <A HREF="mandoc.1.html">mandoc</A> by way of <A CLASS="external"
+                                                       HREF="http://netbsd-soc.sourceforge.net/projects/mandoc_ps/">Summer of Code</A>.
+                                                       Highlights:

                                                </P>
                                                <UL>
                                                </P>
                                                <UL>

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

                                                        <LI>fix end-of-sentence handling for embedded sentences</LI>
                                                        <LI>polish <A HREF="man.7.html">man</A> documentation</LI>
                                                        <LI>document all <A HREF="mdoc.7.html">mdoc</A> macros</LI>
                                                        <LI>fix end-of-sentence handling for embedded sentences</LI>
                                                        <LI>polish <A HREF="man.7.html">man</A> documentation</LI>
                                                        <LI>document all <A HREF="mdoc.7.html">mdoc</A> macros</LI>

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

                                                        <LI>lots of internal clean-ups in character escapes</LI>
                                                        <LI>un-break literal contexts in <A HREF="man.7.html">man</A> documents</LI>
                                                        <LI>lots of internal clean-ups in character escapes</LI>
                                                        <LI>un-break literal contexts in <A HREF="man.7.html">man</A> documents</LI>

-                                                       <LI>improve -Thtml output for -man</LI>
-                                                       <LI>add <A HREF="mandoc.1.html">mandoc</A> -Tpdf support</LI>
+                                                       <LI>improve <SPAN CLASS="flag">-Thtml</SPAN> output for <SPAN CLASS="flag">-man</SPAN></LI>
+                                                       <LI>add <A HREF="mandoc.1.html">mandoc</A> <SPAN CLASS="flag">-Tpdf</SPAN> support</LI>

                                                </UL>
                                        </DIV>
                                        <DIV CLASS="news">
                                                </UL>
                                        </DIV>
                                        <DIV CLASS="news">


@@ -329,7 +406,7 @@
                                                        <LI><Q>Bk</Q> <A HREF="mdoc.7.html">mdoc</A> support</LI>
                                                        <LI>beautified SYNOPSIS section output</LI>
                                                        <LI>variable font-width and paper-size support in <A HREF="mandoc.1.html">mandoc</A>
                                                        <LI><Q>Bk</Q> <A HREF="mdoc.7.html">mdoc</A> support</LI>
                                                        <LI>beautified SYNOPSIS section output</LI>
                                                        <LI>variable font-width and paper-size support in <A HREF="mandoc.1.html">mandoc</A>

-                                                               -Tps output</LI>
+                                                               <SPAN CLASS="flag">-Tps</SPAN> output</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>
                                                        <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>


@@ -413,7 +490,7 @@
                        <TR>
                                <TD>
                                        <DIV CLASS="foot">
                        <TR>
                                <TD>
                                        <DIV CLASS="foot">

-                                               Copyright &#169; 2008&#8211;2010 Kristaps Dzonsons, $Date: 2010/07/26 10:00:15 $
+                                               Copyright &#169; 2008&#8211;2010 Kristaps Dzonsons, $Date: 2010/12/24 14:14:00 $

                                        </DIV>
                                </TD>
                        </TR>
                                        </DIV>
                                </TD>
                        </TR>