discuss@mandoc.bsd.lv
 help / color / mirror / Atom feed
* texi2mdoc
@ 2015-02-23 15:31 Kristaps Dzonsons
  2015-02-23 16:56 ` texi2mdoc Svyatoslav Mishyn
  0 siblings, 1 reply; 8+ messages in thread
From: Kristaps Dzonsons @ 2015-02-23 15:31 UTC (permalink / raw)
  To: discuss

Hi folks!

In case any of you work with (or need to deal with) Texinfo manuals, you 
may be interested in a new sub-project of mdocml.bsd.lv, texi2mdoc.

   http://mdocml.bsd.lv/texi2mdoc

In brief, I started this because if there's anything more I dislike 
using than a browser for documentation, it's info(1).  With texi2mdoc, 
not only can I easily format these pages in a familiar way, the contents 
can also be sucked into mdocml's apropos.

In general, texinfo tries to handle anything you can give it, only 
exiting if things really go wrong.  In fact, the only thing it exits on 
in the significant real-world corpus of manuals I can find (GNU, GSL, 
TeXlive, etc.) is an instance of a multiline table cell.  I format 
tables using TS/TE, so I'm not sure how to handle this yet.

(There's also one or two absolute paths in included files, all of which 
seem to be generated at configure time.)

Of course there's work to be done.  For instance, some of the accent 
marks seem unsupported right now, and there are still commands that I'm 
not properly ignoring.  And some that I'm ignoring that I shouldn't, 
like footnotes and so on.  The code is pretty straightforward to work 
with and add to... just sayin'...

Anyway, it is a start, and quite usable.

The generated mdoc(7) will still emit lots of warnings, 99% of which are 
due to superfluous .Pp's.  I think that'll be a small fix to edge in, 
though.

Best,

Kristaps
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv

^ permalink raw reply	[flat|nested] 8+ messages in thread

end of thread, other threads:[~2015-02-25 19:50 UTC | newest]

Thread overview: 8+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2015-02-23 15:31 texi2mdoc Kristaps Dzonsons
2015-02-23 16:56 ` texi2mdoc Svyatoslav Mishyn
2015-02-23 17:31   ` texi2mdoc Kristaps Dzonsons
2015-02-23 18:13     ` texi2mdoc Ingo Schwarze
2015-02-23 18:17     ` texi2mdoc Svyatoslav Mishyn
2015-02-25 15:17       ` texi2mdoc Kristaps Dzonsons
2015-02-25 17:23         ` texi2mdoc Svyatoslav Mishyn
2015-02-25 19:50           ` texi2mdoc Kristaps Dzonsons

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).