ldoc
ldoc copied to clipboard
Functions with long names and many parameters break function table
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.
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.
I simply edited it right in the browser in the DOM tree using Chrome's "Inspect element" feature and it looked ok :-)
Cool, we'll do a release tomorrow. I'm very keen to get LDoc out and paddling happily among the sharks!
Does this mean you'll postpone the fix until the release is done? Or that you'll get it in for the release
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.
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.
Works!
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...
Should I close this issue? Or do you want to keep it open until a fix is added for wrap=false configurations?