Bug 755955

Summary: some of pacemaker's man pages are not cut&paste friendly
Product: Red Hat Enterprise Linux 6 Reporter: Jaroslav Kortus <jkortus>
Component: pacemakerAssignee: Andrew Beekhof <abeekhof>
Status: CLOSED NOTABUG QA Contact: Cluster QE <mspqa-list>
Severity: low Docs Contact:
Priority: unspecified    
Version: 6.3CC: cluster-maint
Target Milestone: rc   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-12-20 17:59:10 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Jaroslav Kortus 2011-11-22 14:23:58 UTC
Description of problem:
Some of the man pages contain strange apostrophes instead of single quotes (''). 
This makes the examples cut&paste unfriendly (as the command is invalid as it stands).

I suggest correcting these. For example cibadmin has correct examples when run from command line and incorrect in the man page.

Version-Release number of selected component (if applicable):
pacemaker-1.1.6-3.el6.x86_64
pacemaker-cli-1.1.6-3.el6.x86_64


How reproducible:
n/a

Steps to Reproduce:
1. man cibadmin, look at examples
2. for manpage in  `rpm -ql pacemaker-cli  pacemaker | grep man | sed 's/.*\/\(.*\).[78].gz/\1/' `; do echo $manpage; man $manpage | grep ’; done
3. for manpage in  `rpm -ql pacemaker-cli  pacemaker | grep man | sed 's/.*\/\(.*\).[78].gz/\1/' `; do echo $manpage; man $manpage | grep ´; done
  
Actual results:
invalid chars in commands

Expected results:
lovely single quotes instead

Additional info:

Comment 2 Andrew Beekhof 2011-11-24 01:05:42 UTC
Quote characters are not allowed in man pages?
Surely cut&paste is a secondary consideration compared to supplying the required information.

Comment 3 Lon Hohberger 2011-12-02 18:48:09 UTC
Works for me in Xterm.

Comment 4 Lon Hohberger 2011-12-20 17:59:10 UTC
# cibadmin \fB\-\-delete\fR \fB\-\-xml\-text\fR '<primitive id="old"/>'

This is a problem in groff/troff/man.