Bug 220574 - authconfig.8 synopsis markup is a mess
Summary: authconfig.8 synopsis markup is a mess
Keywords:
Status: CLOSED RAWHIDE
Alias: None
Product: Fedora
Classification: Fedora
Component: authconfig
Version: 6
Hardware: All
OS: Linux
medium
medium
Target Milestone: ---
Assignee: Tomas Mraz
QA Contact: Brian Brock
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2006-12-22 05:18 UTC by Eric Raymond
Modified: 2007-11-30 22:11 UTC (History)
0 users

Fixed In Version: authconfig-5.3.14-1
Clone Of:
Environment:
Last Closed: 2007-06-12 13:41:41 UTC
Type: ---
Embargoed:


Attachments (Terms of Use)
Fix patch for authconfig.8 (3.15 KB, patch)
2006-12-22 05:18 UTC, Eric Raymond
no flags Details | Diff

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.


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