[rust-dev] rustdoc_ng and normalization of documentation

2013-07-15 Thread Jordi Boggiano
Heya, I have been planning/scheming a new doc web frontend to go with cmr's rustdoc_ng and in the process I ran into the question of normalization and structuring of the documentation blocks. If we take the net::tcp::accept function for example [1], it has fairly extensive documentation but the

Re: [rust-dev] rustdoc_ng and normalization of documentation

2013-07-15 Thread Corey Richardson
On Mon, Jul 15, 2013 at 9:03 AM, Jordi Boggiano j.boggi...@seld.be wrote: [snip] - Full reorganization of the doc blocks with special tags/annotations à la javadoc [2], I am not a particular fan of that but for special things it does serve it's purpose and has the advantage of being somewhat

Re: [rust-dev] rustdoc_ng and normalization of documentation

2013-07-15 Thread Jordi Boggiano
On 15.07.2013 15:07, Corey Richardson wrote: On Mon, Jul 15, 2013 at 9:03 AM, Jordi Boggiano j.boggi...@seld.be wrote: [snip] - Full reorganization of the doc blocks with special tags/annotations à la javadoc [2], I am not a particular fan of that but for special things it does serve it's