DDoc and single declarations

Daniel Keep daniel.keep.lists at gmail.com
Sat Jun 10 09:30:55 PDT 2006


If I had to guess, I'd say it's because DDoc doesn't output comments for
things inside functions, or for import lines.  It's for documenting a
module's interface, not its implementation details.

Think of it like this: if you write a library and document it with DDoc,
users of your library probably don't care that your PrintMe method has
an int called i used in the implementation: they just want to know what
the function itself does.

At least, I think that's why it isn't showing up.  I could always be
wrong :)

	-- Daniel

-- 
Unlike Knuth, I have neither proven or tried the above; it may not even
make sense.

v2sw5+8Yhw5ln4+5pr6OFPma8u6+7Lw4Tm6+7l6+7D
i28a2Xs3MSr2e4/6+7t4TNSMb6HTOp5en5g6RAHCP  http://hackerkey.com/



More information about the Digitalmars-d-learn mailing list