Just wanna follow up.
Thanks for the replies everyone. Helped a lot!
***
Hmm, this might be out of line, but I can't help myself. I got an
idea. I guess a nice feature would be something like a built-in
clean representation of macro arguments, so that you could define
LINK as
LINK
Hello!
Just trying out the built-in ddoc, and it's great!
But is there any way to link to other packages/modules, without
adding "_" everywhere? Consider:
// mylib/package.d
/**
* Also see $(LINK mylib.image.pixel.html)
*/
module mylib;
...
This will generate a
On Tuesday, 1 December 2015 at 15:15:50 UTC, kraybit wrote:
But is there any way to link to other packages/modules, without
adding "_" everywhere? Consider:
sort of. You could define a custom macro
DDOC_PSYMBOL=$0
I think anyway... to make it just emit the original text without
the tag.
On 01.12.2015 16:15, kraybit wrote:
/**
* Also see $(LINK mylib.image.pixel.html)
*/
module mylib;
...
This will generate a link, but the href will be
"mylib.image.pixel.html", which won't work in my browser at least
(Chromium). This can be fixed with:
$(LINK
On Tuesday, 1 December 2015 at 15:32:56 UTC, Adam D. Ruppe wrote:
On Tuesday, 1 December 2015 at 15:15:50 UTC, kraybit wrote:
But is there any way to link to other packages/modules,
without adding "_" everywhere? Consider:
sort of. You could define a custom macro
DDOC_PSYMBOL=$0
I think
On Tuesday, 1 December 2015 at 15:33:59 UTC, anonymous wrote:
On 01.12.2015 16:15, kraybit wrote:
/**
* Also see $(LINK mylib.image.pixel.html)
*/
module mylib;
...
This will generate a link, but the href will be
"mylib.image.pixel.html", which won't work in my
On Tuesday, 1 December 2015 at 15:52:04 UTC, kraybit wrote:
Hm, I see, so it's contextual? Would 'pixel' then be emphasized
if I'm in the documentation of void pixel()?
Yes. It underlines whatever the currently documented symbol is.
So at the top level, it is the module/package name. On a
On 01.12.2015 16:52, kraybit wrote:
Hm, I see, so it's contextual? Would 'pixel' then be emphasized if I'm
in the documentation of void pixel()?
Yes and yes.
I just get the feeling I need to think before using LINK. I'd like to
not think, too much.
It's a clever feature for sure. Maybe