=================================================================== RCS file: /cvs/mandoc/Attic/index.sgml,v retrieving revision 1.73 retrieving revision 1.74 diff -u -p -r1.73 -r1.74 --- mandoc/Attic/index.sgml 2010/05/25 12:44:53 1.73 +++ mandoc/Attic/index.sgml 2010/05/25 23:02:32 1.74 @@ -38,14 +38,15 @@

- The core of mdocml is composed of the libmdoc and libman - validating compiler libraries. Both are simple, fast libraries operating on memory buffers, so they may - be used for a variety of front-ends (terminal-based, CGI and so on). The primary front-end is - mandoc, which formats manuals for display on the terminal. + The core of mdocml is composed of the libmdoc, libman, and libroff validating compiler libraries. All + are simple, fast libraries operating on memory buffers, so they may be used for a variety of front-ends + (terminal-based, CGI and so on). The front-end is mandoc, which formats + manuals for display.

- The mdocml utility is a BSD.lv + The mdocml suite is a BSD.lv Project member.

@@ -57,9 +58,9 @@

- Sources correctly build and install on DragonFly BSD, FreeBSD, OpenBSD, NetBSD, and GNU/Linux operating - systems, tested variously on i386, AMD64, alpha, and others. The most current version is @VERSION@, dated @VDATE@. A full @VERSION@, dated @VDATE@. A full ChangeLog (txt) is written with each release.

@@ -81,7 +82,7 @@ Online source - cvsweb + cvsweb @@ -159,6 +160,14 @@ + man(3) (text) + man macro compiler library + + + man(7) (text) + man language reference + + mandoc(1) (text) format and display UNIX manuals @@ -167,14 +176,6 @@ mandoc special characters - mdoc(7) (text) - mdoc language reference - - - man(7) (text) - man language reference - - manuals(7) (text) a guide to writing UNIX manuals @@ -183,12 +184,16 @@ mdoc macro compiler library - man(3) (text) - man macro compiler library + mdoc(7) (text) + mdoc language reference + roff(3) (text) + roff macro compiler library + + roff(7) (text) - roff language reference + roff-mandoc language reference @@ -209,7 +214,7 @@

You may also subscribe to several mailing lists (these require subscription, which is moderated). An - archive is not yet available. + archive is not yet available on-line, although you may request one once subscribed.

@@ -253,13 +258,40 @@ @@ -272,6 +304,7 @@ end-of-sentence, end-of-line rule. This is a stable roll-back point before the mandoc hackathon in Rostock! Version: 1.9.25. + @@ -305,65 +338,14 @@ - + - - - - - - - - - - - - - - - - - - - -
xx-05-2010 - Day 1 of Rostock hackathon: proper handling of quotations in tab-separated - column lists, finished patching of SYNOPSIS breaking (1.9.25), fixed pre-comment - white-space stripping, added end-of-sentence spacing to black partial-implicit - macros, relaxed column warnings, relaxed acceptence of bad standards arguments, - significant documentation of lists in mdoc(7). - Version: 1.9.26. - + Release consisting of the results from the m2k10 hackathon and up-merge from + OpenBSD. This requires a significant note of thanks to Ingo Schwarze (OpenBSD) + and Joerg Sonnenberger (NetBSD) for their hard work, and again to Joerg for + hosting m2k10. Highlights (mostly cribbed from Ingo's m2k10 report) follow in + no particular order: +
    +
  • a libroff preprocessor in front of libmdoc and libman stripping out + roff instructions;
    • +
  • end-of-sentence (EOS) detection in free-form and macro lines;
    • +
  • correct handling of tab-separated columnar lists in -mdoc;
    • +
  • improved main calling routines to optionally use mmap() for better + performance;
    • +
  • cleaned up exiting when invoked as -Tlint or over + multiple files with -fign-errors;
    • +
  • error and warning message handling re-written to be unified for libroff, libmdoc, and libman;
    • +
  • handling of badly-nested explicit-scoped macros;
    • +
  • improved free-form text parsing in libman and libmdoc;
    • +
  • significant GNU troff compatibility improvements in -Tascii, largely in terms of spacing;
    • +
  • a regression framework for making sure the many fragilities of GNU troff + aren't trampled in subsequent work;
    • +
  • support for -Tascii breaking at hyphens + encountered in free-form text;
    • +
  • and many more minor fixes and improvements (no really, consult cvsweb and see + for yourself!).
    • +
+ Version: 1.10.0. +
13-05-2010
09-05-2010
31-03-2010 - Version 1.9.22: adjusted merge of the significant work - by Ingo Schwarze in getting Xo blocks (block full implicit, e.g., - It for non-columnar lists) to work properly. This isn't enabled by - default: you must specify -DUGLY as a compiler flag - (see the Makefile for details). + See + cvsweb + for historical notes.
30-03-2010 - Version 1.9.20: more efforts to get roff instructions - in -man documents under control. Note that roff instructions embedded in - line-scoped, next-line macros (e.g. B) are not supported. Leading - punctuation for -mdoc macros, such as Fl ( ( a, are now correctly - handled. -
27-03-2010 - Version 1.9.18: many fixes (largely pertaining to - scope) and improvements (e.g., handling of apostrophe-control macros, which - fixes the strange BR seen in some macro output) to handling roff - instructions in -man documents. -
25-03-2010 - Version 1.9.17 highlights: accept perlpod standard preamble. - Also accept (and discard) de, dei, am, ami, and - ig roff macro blocks. -
22-03-2010 - Version 1.9.16 highlights: inspired by patches and bug - reports by Ingo Schwarze, allowed -man to accept - non-printing elements to be nested within next-line scopes, such as br - within B or TH, which is valid roff. Longsoon architecture also - noted and Makefile cleaned up. -
18-02-2010 - Moved to our new BSD.lv home. - Version 1.9.15 highlights: XHTML is now an acceptable - output mode for mandoc(1); Xr made more - compatible with groff; Vt fixed when invoked in SYNOPSIS; \\ - escape removed; end-of-line white-space detected for all lines; subtle bug - fixed in list display for some modes; compatibility layer checked in for - compilation in diverse UNIX systems; and column lengths handled correctly. -
@@ -371,7 +353,7 @@
- Copyright © 2008–2010 Kristaps Dzonsons, $Date: 2010/05/25 12:44:53 $ + Copyright © 2008–2010 Kristaps Dzonsons, $Date: 2010/05/25 23:02:32 $