On 2015-12-16 21:59, Andrei Alexandrescu wrote:
If some of these are unnecessary, they can be easily fixed. There's no
problem with breaking other people's code etc.
Which would you eliminate?
A sane doc generation system would need at most two
macros/syntaxes/functions to create links. One macro accepting a symbol
name (fully qualified or not) used for cross-referencing and one macro
used for page and external links, accepting a relative or an absolute URL.
It's also possible to manged without any of these at all. The doc tool
could automatically do cross-referencing and detect URL's.
--
/Jacob Carlborg
