[prev in list] [next in list] [prev in thread] [next in thread] 

List:       mandoc-discuss
Subject:    pod2mdoc-0.2 released
From:       Ingo Schwarze <schwarze () usta ! de>
Date:       2015-05-19 23:07:55
Message-ID: 20150519230754.GC3289 () athene ! usta ! de
[Download RAW message or body]

Hi,

i'm happy to announce that i just released pod2mdoc-0.2 here:

  http://mdocml.bsd.lv/pod2mdoc/

This is a major feature release:

 * SYNOPSIS preprocessor lines use Fd.
 * Names found in the SYNOPSIS are remembered using Marc Espie's
   ohash library (bundled for compatibility with operating systems
   lacking it); that information is used subsequently to mark up
   function names with Fn, function arguments with Fa, type names
   with Vt, preprocessor macros with Dv.
 * Foreign function names are marked up with Xr.
 * Whitespace handling has been improved in many respects (blank
   lines in literal displays; re-wrap text lines; new sentence, new
   line; better horizontal spacing; no more whitespace at the end
   of lines).
 * Improved handling of closing punctuation.
 * Escaping of quotes at the beginning of macro arguments. 

I tested the release on OpenBSD, Linux, and Solaris 11 (thanks
to the nice folks at OpenCSW).

The project is still considered experimental, and careful manual
postprocessing of the resulting mdoc(7) code is still required after
running the utility on a perlpod(1) document.  But the amount of
trivial and repetitive manual postprocessing needed has certainly
decreased since version 0.1.  I developed the new features while
starting the conversion of the LibreSSL libcrypto manuals.

Part of the changes are based on bug reports and feature requests
that Anthony Bentley@ sent in around the time of the OpenBSD g2k14
hackathon in Ljubljana while he performed the conversion of the
LibreSSL libssl manuals.  Thanks for those reports and for that
conversion!

Enjoy,
  Ingo
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv

[prev in list] [next in list] [prev in thread] [next in thread]