RFC: line numbered programlisting in HTML docs
Gábor Kövesdán
gabor at kovesdan.org
Tue Jan 21 14:00:41 UTC 2014
Hi,
in the pdf version of the documentation we have rendered line wrap
indicators that show the reader when a long line has been wrapped into
multiple lines so that it can be rendered. In the HTML version we have
scrollable programlistings, which is not so smart since you may need to
scroll to read all of the code, which is not comfortable. Using line
wrap indicators in HTML is only possible with an ugly CSS trick but if
we number the lines, which in turn is quite easy, it becomes obvious
when a long line is wrapped. This is what I propose for programlisting
and screen elements. Also, line numbering is a useful feature in itself.
Demo: http://kovesdan.org/doc/proglist.html
Patch: http://kovesdan.org/patches/programlisting.diff
Any objection to this change?
Thanks,
Gabor
More information about the freebsd-doc
mailing list