Bug 220574

Summary: authconfig.8 synopsis markup is a mess
Product: [Fedora] Fedora Reporter: Eric Raymond <esr>
Component: authconfigAssignee: Tomas Mraz <tmraz>
Status: CLOSED RAWHIDE QA Contact: Brian Brock <bbrock>
Severity: medium Docs Contact:
Priority: medium    
Version: 6   
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: authconfig-5.3.14-1 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2007-06-12 13:41:41 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Attachments:
Description Flags
Fix patch for authconfig.8 none

Description Eric Raymond 2006-12-22 05:18:24 UTC 
Description of problem:
The command synopsis markup of authconfig(8) is a mess -- it violates
some of the standard conventions for synopses.  This doesn't matter
much when the Mark One Eyeball is doing the reading, but it plays
hell with attempts to parse the syntax for translation purposes.

Version-Release number of selected component (if applicable):


How reproducible:
Always

Steps to Reproduce:
1. Run doclifter in an attempt to lift the manual page to XML-Docbook.

  
Actual results:
doclifter barfs.

Expected results:
XML.

Additional info:
Fix patch attached.  Patch also visually groups the options, making the
pile a little easier to read.
Comment 1 Eric Raymond 2006-12-22 05:18:24 UTC 
Created attachment 144250 [details]
Fix patch for authconfig.8
Comment 2 Tomas Mraz 2006-12-22 08:35:55 UTC 
Thanks for the patch.