ldoc icon indicating copy to clipboard operation
ldoc copied to clipboard

Functions with long names and many parameters break function table

Open ghost opened this issue 12 years ago • 9 comments
trafficstars

Functions with long names and many parameters break function tables.

Since I just added a few new functions with even longer names and even more parameters, it got pretty bad right now :-P a fix would be nice.

I recommend simply changing <td .... nowrap> to <td ....> which will allow the function names & parameters to wrap into multiple lines. This will allow the table to fit into the horizontal space again, and excessively long function names & parameter lists will be usefully line-wrapped.

ghost avatar Feb 12 '13 14:02 ghost

Yes, it really does seem the best fit. BTW, if you edit the CSS like this does things look better?

I can't see any downside to this change, really.

stevedonovan avatar Feb 12 '13 14:02 stevedonovan

I simply edited it right in the browser in the DOM tree using Chrome's "Inspect element" feature and it looked ok :-)

ghost avatar Feb 12 '13 15:02 ghost

Cool, we'll do a release tomorrow. I'm very keen to get LDoc out and paddling happily among the sharks!

stevedonovan avatar Feb 12 '13 15:02 stevedonovan

Does this mean you'll postpone the fix until the release is done? Or that you'll get it in for the release

ghost avatar Feb 12 '13 16:02 ghost

No, I mean I'll do a interim release tomorrow with the fix, and hope for something I can freeze in a week or two.

stevedonovan avatar Feb 12 '13 17:02 stevedonovan

What I've done with 1.3.4 (latest push) is let the user decide; yet another flag! If you put wrap=true in your config.ld then it will not put out those nasty 'nowrap' attributes. I haven't thought of an 'ideal' solution yet, but at least you will no longer have a dog's breakfast, as they say in England.

stevedonovan avatar Feb 13 '13 12:02 stevedonovan

Works!

ghost avatar Feb 13 '13 13:02 ghost

Much better! Cool, we can think of a more elegant way to do this later.

An issue that bothers me is when one uses sections:

http://stevedonovan.github.com/winapi/api.html

Those table columns of unequal width are irritating me...

stevedonovan avatar Feb 13 '13 13:02 stevedonovan

Should I close this issue? Or do you want to keep it open until a fix is added for wrap=false configurations?

ghost avatar Apr 21 '13 19:04 ghost