=================================================================== RCS file: /cvs/mandoc/Attic/index.sgml,v retrieving revision 1.154.2.5 retrieving revision 1.154.2.12 diff -u -p -r1.154.2.5 -r1.154.2.12 --- mandoc/Attic/index.sgml 2013/09/28 12:31:53 1.154.2.5 +++ mandoc/Attic/index.sgml 2013/11/07 21:57:14 1.154.2.12 @@ -7,6 +7,7 @@

+ mdocml – UNIX manpage compiler, current version @VERSION@ (@VDATE@)

@@ -20,16 +21,10 @@

mdocml is a suite of tools compiling mdoc, the roff macro package of choice for BSD manual pages, and man, the predominant historical package for - UNIX manuals. The mission of mdocml is to deprecate groff, the GNU troff implementation, for displaying mdoc - pages whilst providing token support for man. + UNIX manuals. + It is small, ISO C, ISC-licensed, and quite fast.

- Why? groff amounts to over 5 MB of source code, most of which is C++ and GPL version 3. It runs slowly, produces - uncertain output, and varies in operation from system to system. mdocml strives to fix this (respectively small, C, ISC-licensed, fast and regular). -

mdocml consists of the libmandoc validating compiler and mandoc, which interfaces with the compiler library to format output for UNIX terminals (with support for wide-character locales), XHTML, HTML, PostScript, and PDF. @@ -38,9 +33,22 @@ mandocdb, for indexing manuals; and apropos, whatis, and man.cgi (via catman) for semantic search of manual content. - It is a BSD.lv project.

+ mdocml has predominantly been developed on OpenBSD + and is both an OpenBSD + and a BSD.lv project. + We strive to support all interested free operating systems, in particular + NetBSD, + DragonFly, + FreeBSD, + Minix 3, + and GNU/Linux, + as well as all systems running the pkgsrc portable package build system. + All of these projects have helped to make mdocml better, by providing feedback and advice, + bug reports, and patches. +

Disambiguation: mdocml is often referred to by its installed binary, mandoc.

@@ -71,7 +79,7 @@ DragonFly BSD - contrib/mdocml (1.12.1 sources) + contrib/mdocml (1.12.2 sources) lib/libmandoc usr.bin/mandoc (build system) @@ -86,7 +94,7 @@ FreeBSD 9.x, 8.x - ports/textproc/mdocml (1.12.1 port) + ports/textproc/mdocml (1.12.1 port) @@ -104,7 +112,7 @@ pkgsrc - textproc/mdocml (1.12.0 port) + textproc/mdocml (1.12.2 port) @@ -113,6 +121,12 @@ external/bsd/mdocml (1.10.9 sources and build system) + + Alpine Linux + + aports/main/mdocml (1.12.2 port) + +

@@ -225,6 +239,25 @@ +

+ Supplementary Information +

+ Practical UNIX Manuals: mdoc tutorial by Kristaps Dzonsons +
+ OpenBSD porting guide + chapter regarding manual pages +
+ Publications and media coverage + concerning mdocml and mandoc +
+ History of UNIX Manpages: a comprehensive overview by Kristaps Dzonsons +

Contact

@@ -272,7 +305,7 @@ News

- 23-09-2013: version 1.12.2 + 05-10-2013: version 1.12.2

The mdoc(7) to man(7) converter, @@ -315,7 +348,7 @@ a very small, very simplistic groff-versus-mandoc output comparison tool.

- 23-03-2011: version 1.12.1 + 23-03-2012: version 1.12.1

Significant work on apropos and mandocdb. These tools are @@ -338,16 +371,42 @@

Lastly, I'm no longer providing binaries, as nobody has asked for them.

- See cvsweb for - historical notes. -

+ History +

+ Release notes going back to release 1.9.15, February 18, 2010. + Briefly explaining the most important changes in each release in relatively easy terms. + Very many changes are not mentioned here. +
+ Development history going back to the beginning of the project, November 22, 2008. + One-line entries for important commits, releases, merges, hackathons and talks. + Makes it easy to find out who did what, and when, and when it became available where. + However, this is still incomplete, mentioning only a small fraction of all commits, + and to keep the size down, the individual entries are extremely terse and technical. + Feel free to look up more details and longer explanations about individual entries + in the ChangeLog or in CVS. +
+ CVS ChangeLog going back to the beginning of the project. + Very technical information of varying quality, strictly chronological. + All commits are mentioned, but some messages neglect to mention some changes. + Partly terse, partly detailed and verbose. In any case, the ChangeLog is very long - + more than 25,000 lines, more than 700 kB. +
+ CVS web interface, going back to the beginning of the project. + Source code, diffs and commit messages for each source file. The real thing. +