add line breaks to html docs to make them grep-friendly

Bug #54947 reported by Chris Pimlott on 2006-08-02
2
Affects Status Importance Assigned to Milestone
samba (Ubuntu)
Wishlist
Unassigned

Bug Description

Binary package hint: samba-doc

Some of the html docs in htmldocs have extremely long lines (1000+) that make them very grep-unfriendly. They should have added line breaks in order to reduce the line lengths.

Some of these appear to be automatically generated files, like the indices ix01.html. The generating program could be modified to add line breaks. For other files, the html could be run through tidy before release.

I understand that these documents are primarily intended to be viewed in a web browser, but it wouldn't hurt anything to make them a bit more directly readable.

You can find longest line per file by running:
"find /usr/share/doc/samba-doc/htmldocs/ -name \*.html -exec wc -L {} \; 2> /dev/null | sort -nr"

Here's the top 10:
200689 htmldocs/Samba3-ByExample/ix01.html
137152 htmldocs/Samba3-HOWTO/ix01.html
47725 htmldocs/Samba3-HOWTO/index.html
32938 htmldocs/Samba3-HOWTO/optional.html
24247 htmldocs/Samba3-ByExample/index.html
21400 htmldocs/Samba3-ByExample/2000users.html
19950 htmldocs/Samba3-ByExample/nw4migration.html
14875 htmldocs/Samba3-ByExample/happy.html
13911 htmldocs/Samba3-ByExample/Big500users.html
12728 htmldocs/Samba3-Developers-Guide/index.html

Mathias Gug (mathiaz) on 2007-07-19
Changed in samba:
importance: Undecided → Wishlist
status: New → Triaged
To post a comment you must log in.
This report contains Public information  Edit
Everyone can see this information.

Other bug subscribers