Bug 501202

Summary: asciidoc doesn't handle multiple man pages in one file for docbook output
Product: [Fedora] Fedora Reporter: Peter Hutterer <peter.hutterer>
Component: asciidocAssignee: Chris Wright <chrisw>
Status: CLOSED RAWHIDE QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: medium Docs Contact:
Priority: low    
Version: 11CC: chrisw, vonbrand
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
URL: http://groups.google.com/group/asciidoc/browse_thread/thread/c93bb4db025225d8?pli=1
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2009-06-19 05:11:55 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
0001-Handle-multiple-man-pages-in-docbook-output.patch none

Description Peter Hutterer 2009-05-17 23:39:40 UTC 
Created attachment 344362 [details]
0001-Handle-multiple-man-pages-in-docbook-output.patch

Description of problem:

An asciidoc file that describes several man pages in the same file does not generate the right XML file output. 

From http://groups.google.com/group/asciidoc/browse_thread/thread/c93bb4db025225d8?pli=1

"Using the following NAME section, a2x creates "foo,_bar.1" as output
file instead of the intended "foo.1".

  NAME
  ----
  foo, bar - Do some foo 

[...]

  The problem stems from the fact that AsciiDoc puts both the names into a
single DocBook refname element:

     <refname>foo, bar</refname>

Instead of:

     <refname>foo</refname>
     <refname>bar</refname>

The latter is semantically correct and when processed generates two man
page files [...]"


Steps to Reproduce:
1. Take a asciidoc file as above 
2. asciidoc -b docbook -d manpage file.txt
3. xmlto man file.xml

Actual results:
The resulting man page is a single man page foo,_bar.1. 
  
Expected results:
Two man pages foo.1 and bar.1.

Additional info:
The fix for this went upstream http://hg.sharesource.org/asciidoc/raw-rev/fc5a653a30a3. Attached is the backported fix for F-11/rawhide.
Comment 1 Bug Zapper 2009-06-09 16:00:27 UTC 
This bug appears to have been reported against 'rawhide' during the Fedora 11 development cycle.
Changing version to '11'.

More information and reason for this action is here:
http://fedoraproject.org/wiki/BugZappers/HouseKeeping
Comment 2 Peter Hutterer 2009-06-19 05:11:55 UTC 
Fixed in rawhide with version 8.4.5