new documentation format for std.algorithm

[Andrei Alexandrescu]

On 2/2/11 1:41 PM, Denis Koroskin wrote:
> On Wed, 02 Feb 2011 19:00:20 +0300, Andrei Alexandrescu
> <SeeWebsiteForEmail at erdani.org> wrote:
>
>> On 2/2/11 7:07 AM, spir wrote:
>>> On 02/02/2011 09:45 AM, Andrei Alexandrescu wrote:
>>>> Following ideas and advice from this newsgroup, I have a draft at
>>>>
>>>> http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html
>>>>
>>>>
>>>> There are two tables, one with just the names and the other with names
>>>> and a
>>>> brief description. Let me know of any feedback. Thanks!
>>>>
>>>>
>>>> Andrei
>>>
>>> To avoid the descriptive table taking to much width, as evoked, remove
>>> the category column by:
>>> * Putting category names as "inter-lines" (dunno how to code that in
>>> html, but there's certainly a way to do it).
>>> * Making one table per category (simpler and nicer?).
>>>
>>> Denis
>>
>> Probably one table per category would make for too many tables. How
>> about the separating rows in
>> http://d-programming-language.org/cutting-edge/phobos/std_container.html?
>>
>> Andrei
>
> FWIW, in Opera there is also a huge gap (about 1000 pixels in height)
> between the table and its summary
> (http://habreffect.ru/files/940/18dbd8cbb/bug.png). It is most like
> Opera specific, but I'm not sure.
>
> That gap is coming from lots of empty paragraphs (<p></p>) in between
> table rows:
>
> <tr> ... </tr> <p></p> <tr> ... </tr>
>
> I think it won't hurt to remove those as unnecessary.

Yah, that needs fixing. Unfortunately it makes a mess of the source as 
the empty line in between rows made it easy for me to follow and easy 
for emacs to wrap rows properly (at 80 columns, heh).

Andrei