On Wed, Mar 07, 2012 at 03:49:26PM -0800, H. S. Teoh wrote:
> I wrote a whole bunch of documentation for a struct that I later decided to transplant inside another struct (because the two are closely linked), and now the former struct's docs have vanished. Is this expected behaviour?
[...]

Argh, nevermind what I wrote. In the course of moving the code I accidentally inserted another declaration between the struct and the ddoc comment.


T

-- 
Nearly all men can stand adversity, but if you want to test a man's character, give him power. -- Abraham Lincoln

On Wednesday, March 07, 2012 16:37:44 H. S. Teoh wrote:
> On Wed, Mar 07, 2012 at 03:49:26PM -0800, H. S. Teoh wrote:
> > I wrote a whole bunch of documentation for a struct that I later decided to transplant inside another struct (because the two are closely linked), and now the former struct's docs have vanished. Is this expected behaviour?
> 
> [...]
> 
> Argh, nevermind what I wrote. In the course of moving the code I accidentally inserted another declaration between the struct and the ddoc comment.

If it's nested inside of a function, then any docs on the struct shouldn't end up in the documentation. But documentation on structs or classes nested inside of other structs or classes should definitely show up.

- Jonathan M Davis