[Issue 13914] New: Symbol lookup in ddoc
via Digitalmars-d-bugs
digitalmars-d-bugs at puremagic.com
Mon Dec 29 18:12:55 PST 2014
https://issues.dlang.org/show_bug.cgi?id=13914
Issue ID: 13914
Summary: Symbol lookup in ddoc
Product: D
Version: D2
Hardware: x86_64
OS: Linux
Status: NEW
Severity: enhancement
Priority: P1
Component: DMD
Assignee: nobody at puremagic.com
Reporter: destructionator at gmail.com
So what's nice about ddoc is it understands the language. I think
it should know scoping too.
Let's forget about the syntax for a moment and think of a feature
I'd really like: automatic linkability to mentioned symbols.
module ddoc_test;
import module_with_baz;
void bar() {}
/// See also: $(DSYMBOL bar), $(DSYMBOL baz)
void foo() {}
I think it'd be great if it could recognize bar in there as a
symbol and actually look it up in the current scope. Then you can
define a macro to link it.
So it would translate it to $(DSYMBOL ddoc_test.bar bar) and
$(DSYMBOL module_with_baz.baz baz) and the rest of the code is
responsible for figuring out how to actually link to it.
The first argument it translates is the fully-qualified name
determined by scope lookup rules. The second argument is what the
user actually typed in there.
This would use the fact that ddoc is in the compiler to provide
something compelling that is hard to do in an external program.
Changing syntax is easy - dmd -D -X makes the json file which you
can parse and make your own doc displayer. Getting scope names is
hard though.
36 minutes ago
--
More information about the Digitalmars-d-bugs
mailing list