=================================================================== RCS file: /cvs/mandoc/Attic/index.sgml,v retrieving revision 1.142 retrieving revision 1.146 diff -u -p -r1.142 -r1.146 --- mandoc/Attic/index.sgml 2011/10/02 18:37:25 1.142 +++ mandoc/Attic/index.sgml 2011/10/08 12:21:57 1.146 @@ -41,7 +41,8 @@ support for wide-character locales), XHTML, HTML, PostScript, and PDF. It also includes preconv, for recoding multibyte manuals; demandoc, for emitting only text parts of manuals; - and mandocdb, for indexing manuals. + mandocdb, for indexing manuals; and + apropos, for semantic search of manual content. It is a BSD.lv project.

@@ -51,11 +52,12 @@ Sources

- mdocml is in plain-old ANSI C and should build and run on any modern system. - To build and install into /usr/local/, just run make install. - Be aware: if you have an existing groff installation, this may overwrite its preconv binary. - The mandocdb utility is not yet linked to the build; please contact - us if you plan to use it. + mdocml is in plain-old ANSI C and should build and run on any modern system; however, you'll + need libdb to build apropos and mandocdb (this is installed by default on BSD UNIX + systems — see the Makefile if you're running Linux). To build and install into /usr/local/, just + run make install. Be careful: the preconv and apropos binary names are usually taken by + existing utilities.

Binaries @@ -122,13 +124,13 @@ - mandoc(1) + apropos(1) - format and display UNIX manuals - (text | - xhtml | - pdf | - ps) + search the manual page database + (text | + xhtml | + pdf | + ps) @@ -142,6 +144,16 @@ + mandoc(1) + + format and display UNIX manuals + (text | + xhtml | + pdf | + ps) + + + preconv(1) recode multibyte UNIX manuals @@ -283,20 +295,27 @@ News

- xx-xx-2011: version 1.11.8 + 08-10-2011: version 1.12.0

- This version features a new, work-in-progress output mode: -Tman. This mode allows a system maintainer to - distribute man media for older systems that may not natively support mdoc, such as old Solaris systems. + This version features a new, work-in-progress mandoc output mode: -Tman. This mode + allows a system maintainer to distribute man media for older systems that may not natively + support mdoc, such as old Solaris systems. + The -Ofragment option was added to mandoc's -Thtml and -Txhtml modes.

- The mdoc and man manuals have been made considerably more readable by - adding MACRO OVERVIEW sections, by moving the gory details of the LANGUAGE SYNTAX to the roff manual, and by moving the very technical MACRO SYNTAX sections down to the bottom of - the page. + While adding features, an apropos utility has been merged from the mandoc-tools sandbox. + This interfaces with mandocdb for semantic search of manual content. apropos is different from the traditional apropos primarily in allowing keyword search + (such as for functions, utilities, etc.) and regular expressions.

+ In documentation news, the mdoc and man manuals have been made + considerably more readable by adding MACRO OVERVIEW sections, by moving the gory details of the LANGUAGE + SYNTAX to the roff manual, and by moving the very technical MACRO SYNTAX sections + down to the bottom of the page. +

+

Furthermore, for tbl, the -Tascii mode horizontal spacing of tables was rewritten completely. It is now compatible with groff, both with and without frames and rulers. Nesting of indented blocks is now supported in man, and @@ -342,7 +361,7 @@ Copyright © 2008–2011 Kristaps Dzonsons, - $Date: 2011/10/02 18:37:25 $ + $Date: 2011/10/08 12:21:57 $