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.137 and 1.147

version 1.137, 2011/08/18 09:02:57

version 1.147, 2011/10/08 13:01:44

Line 39

mdocml consists of the <A HREF="mandoc.3.html">libmandoc</A> validating compiler and <A

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

support for wide-character locales), XHTML, HTML, PostScript, and PDF.

It also includes <A HREF="preconv.1.html">preconv</A>, for recoding multibyte manuals; and <A

It also includes <A HREF="preconv.1.html">preconv</A>, for recoding multibyte manuals;

HREF="mandocdb.8.html">mandocdb</A>, for indexing manuals.

<A HREF="demandoc.1.html">demandoc</A>, for emitting only text parts of manuals;

<A HREF="mandocdb.8.html">mandocdb</A>, for indexing manuals; and

<A HREF="apropos.1.html">apropos</A>, for semantic search of manual content (both mandocdb and apropos are

still experimental).

It is a <A CLASS="external" HREF="http://bsd.lv/">BSD.lv</A> project.

Line 50

Line 53

<A NAME="sources">Sources</A>

</H2>

mdocml is in plain-old ANSI C and should build and run on any modern system.

mdocml is in plain-old ANSI C and should build and run on any modern system; however, you'll

To build and install into /usr/local/, just run <CODE>make install</CODE>.

need <A HREF="http://www.oracle.com/technetwork/database/berkeleydb/overview/index.html">libdb</A> to build <A

Be aware: if you have an existing groff installation, this may overwrite its preconv binary.

HREF="apropos.1.html">apropos</A> and <A HREF="mandocdb.8.html">mandocdb</A> (this is installed by default on BSD UNIX

The <A HREF="mandocdb.8.html">mandocdb</A> utility is not yet linked to the build; please <A HREF="#contact">contact

systems — see the Makefile if you're running Linux). To build and install into /usr/local/, just

us</A> if you plan to use it.

run <CODE>make install</CODE>. Be careful: the preconv and apropos binary names are usually taken by

existing utilities.

<H2>

<A NAME="binaries">Binaries</A>

Line 121

Line 125

<COL>

<TBODY>

<TR>

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

search the manual page database

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

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

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

<A HREF="apropos.1.ps">ps</A>)

</TD>

</TR>

<TR>

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

emit only text of UNIX manuals

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

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

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

<A HREF="demandoc.1.ps">ps</A>)

</TD>

</TR>

<TR>

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

format and display UNIX manuals

Line 131

Line 155

</TD>

</TR>

<TR>

<TD VALIGN="top"><A HREF="mandocdb.8.html">mandocdb(8)</A></TD>

index UNIX manuals

(<A HREF="mandocdb.8.txt">text</A> |

<A HREF="mandocdb.8.xhtml">xhtml</A> |

<A HREF="mandocdb.8.pdf">pdf</A> |

<A HREF="mandocdb.8.ps">ps</A>)

</TD>

</TR>

<TR>

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

recode multibyte UNIX manuals

Line 220

Line 234

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

</TD>

</TR>

<TR>

<TD VALIGN="top"><A HREF="mandocdb.8.html">mandocdb(8)</A></TD>

index UNIX manuals

(<A HREF="mandocdb.8.txt">text</A> |

<A HREF="mandocdb.8.xhtml">xhtml</A> |

<A HREF="mandocdb.8.pdf">pdf</A> |

<A HREF="mandocdb.8.ps">ps</A>)

</TD>

</TR>

</TBODY>

</TABLE>

<H1>

<A NAME="contact">Contact</A>

</H1>

Use the mailing lists for bug-reports, patches, questions, etc. (these require subscription). Please check the

Use the mailing lists for bug-reports, patches, questions, etc. Please check the

<A HREF="http://mdocml.bsd.lv/cgi-bin/cvsweb/TODO?cvsroot=mdocml">TODO</A> for known issues

before posting. Beyond that, contact Kristaps at <A

before posting. All lists are subscription-only: send a blank e-mail to the listed address to subscribe. Beyond that,

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

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.

Line 243

Line 267

</TD>

<TD>

bug-reports, general questions, and announcements

(<A HREF="/archives/discuss/summary.html">archive</A>)

(<A HREF="/archives/discuss/">archive</A>)

</TD>

</TR>

<TR>

Line 253

Line 277

</TD>

<TD>

patches and system discussions

(<A HREF="/archives/tech/summary.html">archive</A>)

(<A HREF="/archives/tech/">archive</A>)

</TD>

</TR>

<TR>

Line 263

Line 287

</TD>

<TD>

source commit messages

(<A HREF="/archives/source/summary.html">archive</A>)

(<A HREF="/archives/source/">archive</A>)

</TD>

</TR>

</TBODY>

Line 272

Line 296

</H1>

16-08-2011: version 1.11.6

08-10-2011: version 1.12.0

Handling of tr macro in <A HREF="roff.7.html">roff</A> implemented. This makes Perl documentation much more

This version features a new, work-in-progress <A HREF="mandoc.1.html">mandoc</A> output mode: -Tman. This mode

readable. Hyphenation is also now enabled in <A HREF="man.7.html">man</A> format documents. Many other general

allows a system maintainer to distribute <A HREF="man.7.html">man</A> media for older systems that may not natively

improvements have been implemented. Furthermore, a 64-bit Windows binary is now available at <A

support <A HREF="mdoc.7.html">mdoc</A>, such as old Solaris systems.

HREF="/binaries/mdocml-win64.zip">mdocml-win64.zip</A> and a Mac OS X universal binary is available at <A

The -Ofragment option was added to <A HREF="mandoc.1.html">mandoc</A>'s -Thtml and -Txhtml modes.

HREF="/binaries/mdocml-macosx.zip">mdocml-macosx.zip</A>.

24-07-2011: version 1.11.5

While adding features, an <A HREF="apropos.1.html">apropos</A> utility has been merged from the mandoc-tools sandbox.

This interfaces with <A HREF="mandocdb.8.html">mandocdb</A> for semantic search of manual content. <A

HREF="apropos.1.html">apropos</A> is different from the traditional apropos primarily in allowing keyword search

(such as for functions, utilities, etc.) and regular expressions.

Note that the calling syntax for apropos is likely to change as it settles down.

Significant <A HREF="eqn.7.html">eqn</A> improvements. mdocml can now parse arbitrary eqn input

In documentation news, the <A HREF="mdoc.7.html">mdoc</A> and <A HREF="man.7.html">man</A> manuals have been made

(although few GNU extensions are accepted, nor is mixing low-level roff with eqn). See the <A HREF="eqn.7.html">eqn</A>

considerably more readable by adding MACRO OVERVIEW sections, by moving the gory details of the LANGUAGE

manual for details. For the time being, equations are rendered as simple in-line text. The equation parser satisfies

SYNTAX to the <A HREF="roff.7.html">roff</A> manual, and by moving the very technical MACRO SYNTAX sections

the language specified in the <A CLASS="external" HREF="http://www.kohala.com/start/troff/v7man/eqn/eqn2e.ps">Second

down to the bottom of the page.

Edition User's Guide</A>.

This is also the first release featuring a distributed Windows binary, available at <A

Furthermore, for <A HREF="tbl.7.html">tbl</A>, the -Tascii mode horizontal spacing of tables was rewritten

HREF="/binaries/mdocml-win32.zip">/binaries/mdocml-win32.zip</A>.

completely. It is now compatible with <A HREF="http://www.gnu.org/software/groff/" CLASS="external">groff</A>, both

with and without frames and rulers. Nesting of indented blocks is now supported in <A HREF="man.7.html">man</A>, and

several bugs were fixed regarding indentation and alignment. The page headers in <A HREF="mdoc.7.html">mdoc</A> are now

nicer for very long titles.

12-07-2011: version 1.11.4

02-09-2011: version 1.11.7

Bug-fixes and clean-ups across all systems, especially in <INS><A HREF="mandocdb.8.html">mandocdb</A></INS> <DEL>makewhatis</DEL> (note: still not

Added <A HREF="demandoc.1.html">demandoc</A> utility for stripping away macros and escapes. This replaces the

connected to the general build and must be compiled with <INS><CODE>make mandocdb</CODE></INS> <DEL><CODE>make makewhatis</CODE></DEL>) and the <A

historical <CODE>deroff</CODE> utility. Also improved the <A HREF="mdoc.7.html">mdoc</A> and <A HREF="man.7.html">man</A> manuals.

HREF="man.7.html">man</A> parser. This release was significantly assisted by participants in <A CLASS="external"

HREF="http://www.openbsd.org">OpenBSD</A>'s c2k11. Thanks!

16-08-2011: version 1.11.6

Handling of tr macro in <A HREF="roff.7.html">roff</A> implemented. This makes Perl documentation much more

readable. Hyphenation is also now enabled in <A HREF="man.7.html">man</A> format documents. Many other general

improvements have been implemented. Furthermore, a 64-bit Windows binary is now available at <A

HREF="/binaries/mdocml-win64.zip">mdocml-win64.zip</A> and a Mac OS X universal binary is available at <A

HREF="/binaries/mdocml-macosx.zip">mdocml-macosx.zip</A>.

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

CVSweb