=================================================================== RCS file: /cvs/mandoc/Attic/index.sgml,v retrieving revision 1.143 retrieving revision 1.148 diff -u -p -r1.143 -r1.148 --- mandoc/Attic/index.sgml 2011/10/05 21:43:11 1.143 +++ mandoc/Attic/index.sgml 2011/11/23 10:26:37 1.148 @@ -41,7 +41,9 @@ 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 (both mandocdb and apropos are + still experimental). It is a BSD.lv project.

@@ -51,11 +53,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 @@ -107,6 +110,12 @@ CLASS="external">src/usr.bin/mandoc + + pkgsrc + + textproc/mdocml + +

@@ -122,13 +131,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 +151,16 @@ + mandoc(1) + + format and display UNIX manuals + (text | + xhtml | + pdf | + ps) + + + preconv(1) recode multibyte UNIX manuals @@ -283,7 +302,7 @@ News

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

This version features a new, work-in-progress mandoc output mode: -Tman. This mode @@ -292,12 +311,19 @@ 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. + Note that the calling syntax for apropos is likely to change as it settles down.

+ 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 @@ -321,21 +347,7 @@ HREF="/binaries/mdocml-win64.zip">mdocml-win64.zip and a Mac OS X universal binary is available at mdocml-macosx.zip.

-

- 24-07-2011: version 1.11.5 -

- Significant eqn improvements. mdocml can now parse arbitrary eqn input - (although few GNU extensions are accepted, nor is mixing low-level roff with eqn). See the eqn - manual for details. For the time being, equations are rendered as simple in-line text. The equation parser satisfies - the language specified in the Second - Edition User's Guide. -

-

- This is also the first release featuring a distributed Windows binary, available at /binaries/mdocml-win32.zip. -

-

See cvsweb for historical notes.

@@ -343,7 +355,7 @@ Copyright © 2008–2011 Kristaps Dzonsons, - $Date: 2011/10/05 21:43:11 $ + $Date: 2011/11/23 10:26:37 $