DDoc and logically structured HTML
Stewart Gordon
smjg_1998 at yahoo.com
Sun Mar 11 17:40:15 PDT 2012
On 11/03/2012 22:30, Ary Manzana wrote:
<snip>
> Give me an example of a macro you'd use in your documentation, that's not: bold, italic,
> underlined, lists, tables, links, named sections, code blocks and images.
<snip>
Emphasis possibly. Inline code snippets. Possibly sample input/output.
But even if you do come up with a list of things that have a genuine use case that you
think is exhaustive, someone'll sooner or later come up with another one that isn't on
your list.
Moreover, macros aren't just to provide access to the features of the target documentation
format. They're also used to enable specific uses of these features to be written in the
source more nicely. For example, I've just found myself setting one up for links to
issues on Bugzilla.
Stewart.
More information about the Digitalmars-d
mailing list