ddoc - documenting private variables

[Charles Hixson]

On 10/07/2012 09:46 AM, Adam D. Ruppe wrote:
> On Saturday, 6 October 2012 at 20:23:11 UTC, Charles Hixson wrote:
>> How does one generate documentation for private variables? ...
>> Other, I mean, than switching to DOxygen (which has it's own problems
>> with D).
>
> check this out from the announce group:
> http://forum.dlang.org/thread/k4sa0j$73k$1@digitalmars.com#post-k4sa0j:2473k:241:40digitalmars.com
>

When I went there, my first thought was "Who rejected this and why?"
When I look more carefully, it looks like my intended use (generation of 
documentation for D code that has nothing to do with the web) is at best 
pretty much of an after-thought.  And the documentation doesn't indicate 
that it would be suitable for someone with my skill level.  (I.e., it 
looks like you need to read the code to figure it out.)

FWIW, I have absolutely NO knowledge of JSON, except that it's something 
to do with web pages (well, and it's a language or possibly a library). 
  So having to go through JSON as an intermediate step to generating the 
documentation doesn't look desirable.

OTOH, I'm an old Fortran programmer that switched over to Python (after 
looking at lots of other choices) awhile ago, because I didn't like the 
way C was so free with the use of pointers, etc.  My facility with D 
isn't all that great, especially when you start talking about templates 
and mix-in templates.  It's quite possible that people with a different 
background would find this much more approachable than I do.