Ddoc: no docs generated for nested structs?
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? T -- I am a consultant. My job is to make your job redundant. -- Mr Tom
Re: Ddoc: no docs generated for nested structs?
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
Re: Ddoc: no docs generated for nested structs?
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
