On 12/16/2015 10:13 AM, Adam D. Ruppe wrote:
And you know, there, I think we are still better off enhancing what we
have than throwing it out. Cross referencing for example, in the
compiler, means it can automatically emit some kind of link with the
full name of the symbol done with scope resolution.
I have a pretty cool idea on how to do cross referencing and other
global things simply.
All we need is that ddoc generates plaintext wrapped in a macro. For
example, consider the input:
====
This is a $(D ddoc) sentence with a lil $(B bold) in the mix.
====
Right now the generated output consists of the raw text interspersed
with the expansion of the macros. What we need is this:
====
$(DDOC_RAWTEXT This is a )$(D ddoc)$(DDOC_RAWTEXT sentence with a lil
)$(B bold)$(DDOC_RAWTEXT in the mix.)
====
Expansion would proceed normally. The default value is:
DDOC_RAWTEXT=$0
With this change to ddoc it becomes easy to define filters that
eliminate all text and tags except those of interest. For example,
generating a list of all URLs for verification purposes is trivial.
Cross-referencing, glossary, etc. etc. become easy to automated.
Another cool project!
Andrei
