Bug 624961 - Incorrect text wrapping in <screen> element in Remote_Management.xml
Summary: Incorrect text wrapping in <screen> element in Remote_Management.xml
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: doc-Virtualization_Administration_Guide
Version: 6.0
Hardware: All
OS: Linux
low
medium
Target Milestone: rc
: ---
Assignee: Don Domingo
QA Contact: ecs-bugs
URL:
Whiteboard:
Keywords: Documentation
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2010-08-18 09:01 UTC by Justin Clift
Modified: 2015-07-13 04:34 UTC (History)
1 user (show)

(edit)
Clone Of:
(edit)
Last Closed: 2010-11-11 15:37:32 UTC


Attachments (Terms of Use)

Description Justin Clift 2010-08-18 09:01:05 UTC
Description of problem:

The publican generated output from one of the <screen> elements in Remote_Management.xml is not good (current RHEL 6 VG git, branch "6").

The lines in the contained elements wrap, when they shouldn't.  Caused by bad placement of <parameter> tag.

Broken output:

****************************************************************************

# ssh-copy-id -i ~/.ssh/id_rsa.pub root@example.com root@example.com's password: Now try logging into the machine, with "ssh 'root@example.com'", and check in: .ssh/authorized_keys to make sure we haven't added extra keys that you weren't expecting

****************************************************************************

Should be:

****************************************************************************

# ssh-copy-id -i ~/.ssh/id_rsa.pub root@example.com
root@example.com's password:

Now try logging into the machine, with "ssh 'root@example.com'", and check in:

  .ssh/authorized_keys
  
to make sure we haven't added extra keys that you weren't expecting

****************************************************************************


The fix is to change this element in the DocBook source (line 74+):

****************************************************************************
                                <screen># ssh-copy-id -i ~/.ssh/id_rsa.pub <parameter>root@example.com
root@example.com's password:

Now try logging into the machine, with "ssh 'root@example.com'", and check in:


  .ssh/authorized_keys


to make sure we haven't added extra keys that you weren't expecting

</parameter>
                                </screen>


****************************************************************************

To this:

****************************************************************************

                                <screen># ssh-copy-id -i ~/.ssh/id_rsa.pub <parameter>root@example.com</parameter>
<parameter>root@example.com</parameter>'s password:

Now try logging into the machine, with "ssh '<parameter>root@example.com</parameter>'", and check in:

  .ssh/authorized_keys

to make sure we haven't added extra keys that you weren't expecting
</screen>

****************************************************************************

Also note the two "double blank lines" have been condensed into two "single blank lines", to match real world output. :)

Comment 2 Don Domingo 2010-08-18 22:41:57 UTC
Justin,

are you sure it's not as follows?

****************************************************************************
<screen># ssh-copy-id -i ~/.ssh/id_rsa.pub root@example.com
root@example.com's password:</screen>

<para>
Now try logging into the machine, with <command>ssh 'root@example.com'</command>, and check in:
</para>

<screen>  .ssh/authorized_keys</screen>

  
<para>
to make sure we haven't added extra keys that you weren't expecting.
</para>
****************************************************************************

Comment 3 Justin Clift 2010-08-19 07:47:49 UTC
Hi Don,

That looks nicer, and is good wording, but no.

This output (all of it) is from the "ssh-copy-id" command itself (really):

****************************************************************************

[root@host1 ~]# ssh-copy-id host2
root@host2's password: 
Now try logging into the machine, with "ssh 'host2'", and check in:

  .ssh/authorized_keys

to make sure we haven't added extra keys that you weren't expecting.

[root@host1 ~]#

****************************************************************************

Comment 4 Justin Clift 2010-08-19 07:50:45 UTC
Note, the real output does have a full stop on the end after the word "expecting", which both the previous author and I had previously missed.

Comment 9 Andrew Ross 2010-08-25 21:59:17 UTC
Verified: Red_Hat_Enterprise_Linux-Virtualization-6-web-en-US-0-70.el5

$ ssh-copy-id -i ~/.ssh/id_rsa.pub
root@example.com
root@example.com's password:

Now try logging into the machine, with "ssh 'root@example.com'", and check in:

  .ssh/authorized_keys

to make sure we haven't added extra keys that you weren't expecting.

Comment 10 releng-rhel@redhat.com 2010-11-11 15:37:32 UTC
Red Hat Enterprise Linux 6.0 is now available and should resolve
the problem described in this bug report. This report is therefore being closed
with a resolution of CURRENTRELEASE. You may reopen this bug report if the
solution does not work for you.


Note You need to log in before you can comment on or make changes to this bug.