On Sat, 04 Jul 2009 12:35:38 -0400, Ary Borenszweig
wrote:
1. (minor problem) Why isn't this appearing in the documentation?
Probably not documented (ddoc and dil only document when it sees the
document tag, e.g. /*** or ///)
2. (major problem) How do you expect users to use your code i
On 7/4/09 6:35 PM, Ary Borenszweig wrote:
I've seen both Tango and phobos documentation and it's really hard to
navigate. Consider this:
class HttpPost {
void[] write(Pump pump)
}
Pump has no link on it. I can't tell what Pump is. I can see the source
code (in the web page) invokes super.writ
Ary Borenszweig wrote:
4. Is there a tool to generate documentation with cross-references?
dmd probably can do this, again I've never done it so don't know.
No, it doesn't. I think it doesn't because semantic analysis isn't run
when generating docs.
Might be a good idea for a feature reque
Robert Clipsham escribió:
Ary Borenszweig wrote:
I've seen both Tango and phobos documentation and it's really hard to
navigate. Consider this:
class HttpPost {
void[] write(Pump pump)
}
Pump has no link on it. I can't tell what Pump is. I can see the
source code (in the web page) invoke
Ary Borenszweig wrote:
I've seen both Tango and phobos documentation and it's really hard to
navigate. Consider this:
class HttpPost {
void[] write(Pump pump)
}
Pump has no link on it. I can't tell what Pump is. I can see the source
code (in the web page) invokes super.write(pump), or som
