Default to multiline parameters in function/method synopsis

[Wes0617]

(unless the func takes 0 args)

Leaves a lot of "not good looking empty space" on the right, on larger resolutions, but it's way more comfortable to read. Methods within class synopsis (eg the methods listed here http://php.net/manual/en/class.intltimezone.php) may continue to stay on one line each.

[morrisonlevi]

If we use the right markup I think we can perhaps do this dynamically in the browser based on browser width. This could be a really nice enhancement. Good idea.

It might need JavaScript to really work nicely; however this is exactly the sort of thing I don't mind using JavaScript for.

[Wes0617]

with proper markup we don't even need javascript, just plain css
edit: perhaps js will be needed, but not a lot of it.

[morrisonlevi]

I think it would need JavaScript to properly do the wrapping because of two reasons:

• Each parameter section is indented only if it wraps
• If it wraps then all parameter sections should wrap

[kelunik]

@Netmosfera Please only for very long lines, not for all. For a small parameter list, it's harder to read that way.

[Sobak]

-1 from me, sorry. I agree with @kelunik - that's actually makes it harder to read.

[Wes0617]

okay, so only for lines that wrap?