[dox] Text describing Sections in Documentation Generator page needs improvement

2013-08-16 Thread Andre Artus
The text describing Sections in Documentation Generator page (http://dlang.org/ddoc.html) needs improvement. It reads: Sections The document comment is a series of Sections. A Section is a name that is the first non-blank character on a line immediately followed by a ':'. This name forms th

Re: [dox] Text describing Sections in Documentation Generator page needs improvement

2013-08-23 Thread H. S. Teoh
Sorry for the late reply, it's kinda hard keeping up with this high-volume mailing list. :) On Sat, Aug 17, 2013 at 12:08:06AM +0200, Andre Artus wrote: > The text describing Sections in Documentation Generator page > (http://dlang.org/ddoc.html) needs improvement. > > It reads: > > >Sections >

Re: [dox] Text describing Sections in Documentation Generator page needs improvement

2013-08-24 Thread Andre Artus
On Friday, 23 August 2013 at 21:41:01 UTC, H. S. Teoh wrote: Sorry for the late reply, it's kinda hard keeping up with this high-volume mailing list. :) Tell me about it :) On Sat, Aug 17, 2013 at 12:08:06AM +0200, Andre Artus wrote: The text describing Sections in Documentation Generator pa

Re: [dox] Text describing Sections in Documentation Generator page needs improvement

2013-08-24 Thread Andre Artus
I have been racking my brain to find a suitable replacement for the section description, I would appreciate your critique. "A section is a block of text that is processed by the document generator. There are only two unlabeled sections, summary and description, all other sections are identifie

Re: [dox] Text describing Sections in Documentation Generator page needs improvement

2013-08-25 Thread H. S. Teoh
On Sun, Aug 25, 2013 at 04:27:18AM +0200, Andre Artus wrote: > On Friday, 23 August 2013 at 21:41:01 UTC, H. S. Teoh wrote: [...] > >On Sat, Aug 17, 2013 at 12:08:06AM +0200, Andre Artus wrote: > >>The text describing Sections in Documentation Generator page > >>(http://dlang.org/ddoc.html) needs i