Description of problem:
In various parts of the RHEL5.2 deployment guide, example configuration files
are displayed (in a yellow box) with all the text compressed to a single line.
This is misleading, confusing and just wrong.
Version-Release number of selected component (if applicable):
- Look at the Deployment Guide
Steps to Reproduce:
1. Visit, e.g.
2. Observe configuration files butchered to a single line
- Entire configuration file mashed to a single line
- Config file listed with proper newlines. One example can be found at
- This probably applies to many other parts of the deployment guide; here I've
only listed the three which I stumbled across.
Mike: customers are copying some of these and saving them, resulting in broken
Did anything come of the discussion last year about resolving all of these?
Also exists on RHEL5.1 guide
and RHEL5 GA
Reference to the problem on 5.1
I have committed changes to resolve /s2-networkscripts-interfaces-chan.html
(Channel Bonding Interfaces).
This issue seems to occur if command tags are in screen tags:
A specific occurrence of the same problem found in the Installation Guide.
*** Bug 514410 has been marked as a duplicate of this bug. ***
*** Bug 518203 has been marked as a duplicate of this bug. ***
The problem is actually that the computeroutput tag has been used in 837 places in the DocBook source, but that tag does not preserve line breaks in the source. That's what the DocBook manual means when it notes, in the description for computeroutput, that:
"Note that computeroutput is not a verbatim environment, but an inline."
Agreed that "verbatim environment" could have a secondary, more-explicit warning regarding line breaks...
These will all need to be replaced with screen elements.
Hopefully all fixed in 5.4 branch -r21220 with Java 1.6 regex library, ~115 modifications to 25 files:
Visual diff shows line breaks are now correct in all examples I looked at. <command> els inside <screen> els were preserved (as well as inline <computeroutput> els).
Committed. Now going to fix bug 241314 and then to upload corrected books.
Fixed, 5.4, redhat.com/docs:
*** Bug 438823 has been marked as a duplicate of this bug. ***
*** Bug 452065 has been marked as a duplicate of this bug. ***