On Thursday, 23 January 2014 at 15:00:17 UTC, sg wrote:
On Thursday, 23 January 2014 at 14:25:41 UTC, Rikki Cattermole
wrote:
On Thursday, 23 January 2014 at 13:57:43 UTC, sg wrote:
Ddoc itself is provided as part of the D compiler. For usage
with D source code.
Following is from http://dlang.org/ddoc.html
Using Ddoc for other Documentation
Ddoc is primarily designed for use in producing documentation
from embedded comments. It can also, however, be used for
processing other general documentation. The reason for doing
this would be to take advantage of the macro capability of Ddoc
and the D code syntax highlighting capability.
If the .d source file starts with the string "Ddoc" then it is
treated as general purpose documentation, not as a D code
source file. ...
Much of the D documentation itself is generated this way,
including this page. Such documentation is marked at the bottom
as being generated by Ddoc.
Yes, but it requires the source file to have the extension of d
as listed in the quote you gave.
It may be possible to rig it to do what you want. But you'll
loose all the niceness e.g. function parameter grabbing.
This may be a good use case for an enhancement to the front end,
to provide what you want.
