[gentoo-doc] proj/en/qa/asneeded.xml under doc or qa?

[Duncan]

I'm not sure if this is under doc or qa, but 

http://www.gentoo.org/proj/en/qa/asneeded.xml

could use a relatively minor but quite helpful usability tweak.

Code listing 1.1 is of course <pre>.  Line 57 (as delivered), the line 
with all those libs, ends up /very/ long for a single line.  Even at 
relatively small font sizes, it requires a window nearly 1024 px wide, 
and that's not even displaying the full ad column yet.  Of course, that 
forces the entire content to that width as well, so it's not just the 
single line at that width.  Gentoo can be commended for using "%" sized 
layout as the default, generally making page width relatively flexible, 
and normally code listings aren't long enough to be all /that/ much 
trouble (thanks to the doc team and others' hard work) but this one needs 
a little lovin', due to that one long line of code.

If the line could be split in half, so it displays on two lines, it would 
make viewing a bit easier in a narrower window.  Of course, it'll be 
split in most console windows, so splitting it for display on the page
shouldn't be a big problem.

(FWIW, I run 1600 width by default, but have my browser windows set to 
800 width by default, so I can view two windows side-by-side.  I can 
barely run 2048 width, for two by 1024 px windows, but the text gets 
blurry and the monitors only run 60 Hz at that, so it's not ideal.  One 
of these days I'll upgrade again, but until then, content columns that 
exceed 800 px are irritating.)

Or is a bug a better way to go at this?  I don't know how doc team works.

-- 
Duncan - List replies preferred.   No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master."  Richard Stallman

-- 
gentoo-doc@g.o mailing list