Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 113796 - documentation "installing GRUB" grub.conf for genkernel users real_root is truncated
Summary: documentation "installing GRUB" grub.conf for genkernel users real_root is tr...
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Handbook (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Xavier Neys (RETIRED)
URL: http://www.gentoo.org/doc/en/handbook...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-11-28 07:37 UTC by john ryan
Modified: 2008-09-11 09:03 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description john ryan 2005-11-28 07:37:20 UTC
My page print margins are 10mm left and right, 15mm top and bottom on A4 paper.

I have printed the Linux Handbook in its entirety. At approximately page 41 of 
91, section "installing GRUB", code listing 4: grub.conf for genkernel users, 
the line

kernel /boot/kernel-genkernel-x86-2.6.12-gentoo-r10 root=/dev/ram0 
init=/linuxrc ramdisk=8192 real_root=/dev/hda3 udev

is truncated.

My print-out shows:

kernel /boot/kernel-genkernel-x86-2.6.12-gentoo-r10 root=/dev/ram0 
init=/linuxrc ramdisk=8192 real_root

Is this a browser bug or an error in the html code? This line is probably one 
of the longest in the handbook.

Reproducible: Always
Steps to Reproduce:
1.
2.
3.
Comment 1 Xavier Neys (RETIRED) gentoo-dev 2005-11-29 08:08:16 UTC
(In reply to comment #0)
> Is this a browser bug 

I think so. FYI, Mozilla (1.5) clips, Opera (8.51) wraps.
Comment 2 john ryan 2005-11-30 05:07:22 UTC
Technically it might be a bug in IE6.

However, the bug affects gentoo users trying to follow the handbook, many of 
whom like myself are new to linux and follow the handbook without any real 
understanding of what might be missing.
Moreover, the on-screen message after the section 7.d, code listing 17,command:
# genkernel all 

finishes by saying:
(1) Required kernel paramaters real_root=/dev/$ROOT where $ROOT is device node 
for your root partition as the one specified in /etc/fstab [very clear]
(2) If you require Genkernels detection features, you must tell the bootloader 
to use the provided INITRAMFS file. [very clear]
(3) Otherwise sustitute the root argument for the real_root if you are not 
planning to use the initrd [confusing, does this mean I set the required 
kernel parameter real_root=root, or set the required kernel parameter 
root=/dev/$ROOT   ]

If it is possible to change the html of the handbook, OR to flag that there 
may be an issue with long lines of text, then it should be done
Comment 3 Xavier Neys (RETIRED) gentoo-dev 2005-12-09 03:34:22 UTC
Reopening, maybe temporary.

(In reply to comment #2)
> If it is possible to change the html of the handbook, OR to flag that there 
> may be an issue with long lines of text, then it should be done

That can't be done because there is no way of knowing when a line is too long.
Many factors define the max length: paper format, orientation, zooming factor,
minimum font size...

I tried to specify a smaller font size on long code samples at
http://gentoo.neysx.org/doc/en/handbook/handbook-x86.xml?part=1&chap=10

Be aware though that your browser's behaviour & setting play a big part.
For instances, firefox will not allow the font size to go below the specified
minimum font size in your preferences, and it uses the same minimum size for the
screen and the printer (pretty daft IMO). If you check the 'shrink to fit'
options, firefox will then scale down everything to fit on the page.
In other words, if you have a large minimum font, everything will be scaled down
and become tiny, but if you allow a small minimum font size, then only the long
code samples will use smaller fonts when printed.

Please let me know if my trick helps so that I can reassign to the guys who work
on wwwredesign.gentoo.org, or just close this bug again.

Hth
Comment 4 Jakub Moc (RETIRED) gentoo-dev 2006-03-15 02:34:49 UTC
User response needed wrt comment #3.
Comment 5 Xavier Neys (RETIRED) gentoo-dev 2006-03-16 06:28:51 UTC
Something similar to my experiment might be done about this
No need to close it
Comment 6 Xavier Neys (RETIRED) gentoo-dev 2006-04-03 09:08:27 UTC
Curtis, how about adding style="wide" and/or style="verywide" to (very) wide <pre>s and style them with smaller fonts?

curl -s 'gentoo.neysx.org/doc/en/handbook/handbook-x86.xml?part=1&chap=10' |grep '<pre '|sed 's/.*\(<pre.*\)/\1/'
Comment 7 Jakub Moc (RETIRED) gentoo-dev 2007-07-07 16:46:12 UTC
Hmmm....
Comment 8 Robin Johnson archtester Gentoo Infrastructure gentoo-dev Security 2007-12-27 01:07:16 UTC
docs: do we still need this bug?
Comment 9 nm (RETIRED) gentoo-dev 2008-09-11 09:03:08 UTC
(In reply to comment #8)
> docs: do we still need this bug?
> 

I don't believe so. I've since removed the outdated "udev" kernel option from the boot line, so it won't show up anyway. That was the only thing getting cut off, so...

closing.