Date: Sat, 9 Apr 2011 16:43:30 +0000 Subject: Tidy up www page: remove all sorts of DIV crap, superfluous CSS, in-line STYLE attributes, and so on. Now renders nicely in lynx. --- index.css | 51 ++--- index.sgml | 724 +++++++++++++++++++++++++++++-------------------------------- 2 files changed, 363 insertions(+), 412 deletions(-) diff --git a/index.css b/index.css index d8d0b2d8..92bb281f 100644 --- a/index.css +++ b/index.css @@ -1,25 +1,31 @@ +html { min-width: 40em; + max-width: 60em; + width: 60%; + margin-left: 4em; } + body { color: #333333; + text-align: justify; font-size: 0.93em; - font-family: Times, sans-serif; } + font-family: Times, serif; } + +h1, h2 { font-size: inherit; } -table.frame { max-width: 800px; - padding-right: 2em; - padding-left: 1em; } +h1 { margin-left: -3.0em; } -table { padding-left: 40px; } +h2 { margin-left: -1.5em; } -p { padding-left: 40px; - text-align: justify; } +p.head, p.foot { margin-left: -3.0em; + text-align: right; } -h1 { font-weight: bold; - font-size: small; - font-family: Verdana, Tahoma, Arial, sans-serif; } +p.head { border-bottom: 1px solid #dddddd; + padding-bottom: 0.2em; } -h2 { font-weight: bold; - font-size: small; - padding-left: 20px; - margin-bottom: 0px; - font-family: Verdana, Tahoma, Arial, sans-serif; } +p.foot { border-top: 1px solid #dddddd; + padding-top: 0.2em; + font-size: smaller; } + +p.news { color: #000000; + margin-left: -0.5em; } span.nm { font-weight: bold; } @@ -29,20 +35,7 @@ span.attn { color: #000000; font-weight: bold; } span.flag { font-weight: bold; } -div.head { border-bottom: 1px solid #dddddd; - padding-bottom: 5px; - text-align: right; } - -div.foot { border-top: 1px solid #dddddd; - padding-top: 5px; - font-size: smaller; - text-align: right; } +a { text-decoration: none; } a.external { background: transparent url(external.png) center right no-repeat; padding-right: 12px; } - -span.date { color: #000000; } - -div.news { margin-bottom: 2em; } - -div.news ul { margin-left: 4em; } diff --git a/index.sgml b/index.sgml index 6d4ed778..e5482ec3 100644 --- a/index.sgml +++ b/index.sgml @@ -2,408 +2,366 @@ - mdocml | mdoc macro compiler - - - - - - - - - - - - - - - - - - - - - - - - - -

- mdocml – mdoc macro compiler -

- DESCRIPTION -

+ mdocml – mdoc macro compiler +

- 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. -

+ DESCRIPTION +

- Why? groff amounts to over 5 MB of source code, most of which is C++ and all of which is GPL. 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 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. +

- mdocml consists of the libmandoc validating - compiler and mandoc, which interfaces with the compiler library to format - output for UNIX terminals, XHTML, HTML, PostScript, and PDF. It is a BSD.lv project. -

+ Why? groff amounts to over 5 MB of source code, most of which is C++ and all of which is GPL. 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). +

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

- SOURCES -

+ mdocml consists of the libmandoc validating compiler and mandoc, which interfaces with the compiler library to format output for UNIX terminals, XHTML, + HTML, PostScript, and PDF. It is a BSD.lv project. +

- mdocml is in plain-old ANSI C and should build and run on any UNIX system. - The most current version is @VERSION@, dated @VDATE@. -

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

- Current -

+ SOURCES +

- - - - - - - - - - - - - -

Source archive	- /snapshots/mdocml.tar.gz - (md5) -
Online source	- cvsweb -

+ mdocml is in plain-old ANSI C and should build and run on any UNIX system. The most current + version is @VERSION@, dated @VDATE@. +

- Downstream -

+ Current +

- - - - - - - - - - - - - - - - - - - - - -

DragonFly BSD	- usr.bin/mandoc -
FreeBSD	- ports/textproc/mdocml -
NetBSD	- src/external/bsd/mdocml -
OpenBSD	- src/usr.bin/mandoc -

+ + + + + + + + + + + + + +

Source archive	+ /snapshots/mdocml.tar.gz + (md5) +
Online source	+ cvsweb +

- Historical -

+ Downstream +

- - - - - - - - - -

Source archive

- /snapshots/ -

- DOCUMENTATION -

+ + + + + + + + + + + + + + + + + + + + + +

DragonFly BSD	+ usr.bin/mandoc +
FreeBSD	+ ports/textproc/mdocml +
NetBSD	+ src/external/bsd/mdocml +
OpenBSD	+ src/usr.bin/mandoc +

- These manuals are generated automatically and refer to the current snapshot. -

+ Historical +

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

mandoc(1)	- format and display UNIX manuals - - (text \| - xhtml \| - pdf \| - postscript) - -
mandoc(3)	- mandoc macro compiler library - - (text \| - xhtml \| - pdf \| - postscript) - -
man(7)	- man language reference - - (text \| - xhtml \| - pdf \| - postscript) - -
eqn(7)	- eqn-mandoc language reference - - (text \| - xhtml \| - pdf \| - postscript) - -
mandoc_char(7)	- mandoc special characters - - (text \| - xhtml \| - pdf \| - postscript) - -
mdoc(7)	- mdoc language reference - - (text \| - xhtml \| - pdf \| - postscript) - -
roff(7)	- roff-mandoc language reference - - (text \| - xhtml \| - pdf \| - postscript) - -
tbl(7)	- tbl-mandoc language reference - - (text \| - xhtml \| - pdf \| - postscript) - -

+ + + + + + + + + +

Source archive

+ /snapshots/ +

- See Writing UNIX Manual Pages for a general - introduction to manpages and mdoc. -

- CONTACT -

+ DOCUMENTATION +

- Use the mailing lists for bug-reports, patches, questions, etc. (these require - subscription). - Please check the - TODO for known issues - before posting. - Beyond that, contact Kristaps at kris...@bsd.lv. -

+ These manuals are generated automatically and refer to the current snapshot. +

- - - - - - - - - - - - - - - - - -

- disc...@mdocml.bsd.lv -	- bug-reports, general questions, and announcements - (archive) -
- tec...@mdocml.bsd.lv -	- patches and system discussions - (archive) -
- sou...@mdocml.bsd.lv -	- source commit messages - (archive) -

- NEWS -

- 04-04-2011: - version 1.11.1 -

- The earlier libroff, libmdoc, and libman soup have been merged into - a single library, libmandoc, which manages all aspects of - parsing real manuals (from line-handling to tbl parsing). -

- Beyond this structural change, initial eqn functionality is in - place. For the time being, this is limited to the recognition of equation blocks; - future version of mdocml will expand upon this framework. -

- As usual, many general fixes and improvements have also occured. In particular, a great - deal of redundancy and superfluous code has been removed with the merging of the backend - libraries. -

- 07-01-2011: - version 1.10.9 -

- Many back-end fixes have been implemented: argument handling (quoting), man improvements, error/warning classes, and many more. -

- Initial tbl functionality (see the TS, TE, and - T& macros in the roff manual) has been - merged from tbl.bsd.lv. Output is - still minimal, especially for -Thtml and -Txhtml, but manages to at least display data. This means that mandoc now has built-in support for two troff preprocessors via - ~~libroff~~: soelim and tbl. -

- 24-12-2010: - version 1.10.8 -

- Significant improvements merged from OpenBSD downstream, including -

many new roff components,
in-line implementation of troff's soelim,
broken-block handling,
overhauled error classifications, and
cleaned up handling of error conditions.

- Also overhauled the -Thtml and -Txhtml output modes. They now display readable output in arbitrary - browsers, including text-based ones like lynx. See HTML and XHTML manuals in the DOCUMENTATION section for examples. Attention: available style-sheet classes have been considerably - changed! See the example.style.css file for details. - Lastly, ~~libmdoc~~ and ~~libman~~ have been - cleaned up and reduced in size and complexity. -

- See cvsweb for - historical notes. -

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

mandoc(1)	+ format and display UNIX manuals + + (text \| + xhtml \| + pdf \| + postscript) + +
mandoc(3)	+ mandoc macro compiler library + + (text \| + xhtml \| + pdf \| + postscript) + +
man(7)	+ man language reference + + (text \| + xhtml \| + pdf \| + postscript) + +
eqn(7)	+ eqn-mandoc language reference + + (text \| + xhtml \| + pdf \| + postscript) + +
mandoc_char(7)	+ mandoc special characters + + (text \| + xhtml \| + pdf \| + postscript) + +
mdoc(7)	+ mdoc language reference + + (text \| + xhtml \| + pdf \| + postscript) + +
roff(7)	+ roff-mandoc language reference + + (text \| + xhtml \| + pdf \| + postscript) + +
tbl(7)	+ tbl-mandoc language reference + + (text \| + xhtml \| + pdf \| + postscript) + +

+ +

+ CONTACT +

+ +

+ Use the mailing lists for bug-reports, patches, questions, etc. (these require subscription). Please check the + TODO for known issues + before posting. Beyond that, contact Kristaps at kris...@bsd.lv. +

+ + + + + + + + + + + + + + + + + + +

+ disc...@mdocml.bsd.lv +	+ bug-reports, general questions, and announcements + (archive) +
+ tec...@mdocml.bsd.lv +	+ patches and system discussions + (archive) +
+ sou...@mdocml.bsd.lv +	+ source commit messages + (archive) +

+ +

+ NEWS +

+ +

+ 04-04-2011: version 1.11.1 +

+ The earlier libroff, libmdoc, and libman soup have been merged into + a single library, libmandoc, which manages all aspects of + parsing real manuals (from line-handling to tbl parsing). +

+ Beyond this structural change, initial eqn functionality is in + place. For the time being, this is limited to the recognition of equation blocks; + future version of mdocml will expand upon this framework. +

+ As usual, many general fixes and improvements have also occured. In particular, a great + deal of redundancy and superfluous code has been removed with the merging of the backend + libraries. +

+ +

+ 07-01-2011: version 1.10.9 +

+ Many back-end fixes have been implemented: argument handling (quoting), man improvements, error/warning classes, and many more. +

+ Initial tbl functionality (see the TS, TE, and + T& macros in the roff manual) has been + merged from tbl.bsd.lv. Output is + still minimal, especially for -Thtml and -Txhtml, but manages to at least display data. This means that mandoc now has built-in support for two troff preprocessors via + ~~libroff~~: soelim and tbl. +

+ +

+ 24-12-2010: version 1.10.8 +

+ Significant improvements merged from OpenBSD downstream, including +

many new roff components,
in-line implementation of troff's soelim,
broken-block handling,
overhauled error classifications, and
cleaned up handling of error conditions.

+ Also overhauled the -Thtml and -Txhtml output modes. They now display readable output in arbitrary + browsers, including text-based ones like lynx. See HTML and XHTML manuals in the DOCUMENTATION section for examples. Attention: available style-sheet classes have been considerably + changed! See the example.style.css file for details. + Lastly, ~~libmdoc~~ and ~~libman~~ have been + cleaned up and reduced in size and complexity. +

+ +

+ See cvsweb for + historical notes. +

+ +

-- cgit