Alec Clews talk 'Using "old skool" Free tools to easily publish API
documentation' from LCA 2018 may be of interest.
https://github.com/alecthegeek/doc-api-old-skool  - he reprised it at
the last LUV meeting.

Basically he is using pandoc, graphviz, plantuml, make & m4 to
generate documentation, updating interface information from the
application source.
Using m4 in his style could give you conditional inclusion without much work.

On Mon, Apr 9, 2018 at 8:36 AM, Jason White via luv-main
<luv-main@luv.asn.au> wrote:
> As a further note to this discussion, AsciiDoc also appears to be interesting,
> in that it supports conditionals as well as conversion to a variety of
> formats. The AsciiDoctor implementation seems to be the most current and
> feature rich.
>
> _______________________________________________
> luv-main mailing list
> luv-main@luv.asn.au
> https://lists.luv.asn.au/cgi-bin/mailman/listinfo/luv-main
_______________________________________________
luv-main mailing list
luv-main@luv.asn.au
https://lists.luv.asn.au/cgi-bin/mailman/listinfo/luv-main

Reply via email to