Bug 727739

Summary: Publican Eclipse output doesn't work
Product: [Community] Publican Reporter: Isaac Rooskov <irooskov>
Component: publicanAssignee: Jeff Fearn 🐞 <jfearn>
Status: CLOSED CURRENTRELEASE QA Contact: Ruediger Landmann <rlandman+disabled>
Severity: medium Docs Contact:
Priority: unspecified    
Version: 2.6CC: mmcallis, publican-list, rlandman, yshao
Target Milestone: 2.7   
Target Release: ---   
Hardware: Unspecified   
OS: Linux   
Whiteboard:
Fixed In Version: 2.7 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-09-06 03:56:47 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Attachments:
Description Flags
Normal publican output
none
Modified publican output none

Description Isaac Rooskov 2011-08-03 05:16:40 UTC 
Description of problem:
Generated Eclipse plug-in output doesn't work. Placed "as is" into an eclipse plug-in directory forces the program to hang on start-up. With modification to adhere to eclipse standards (naming etc..), eclipse will start but parse errors will be shown when accessing the document in eclipse help (instead of content). 

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

How reproducible:
100%

Steps to Reproduce (Hanging):
1. Unzip attached eclipse.zip file and copy folder into your eclipse plugin directory
2. Start eclipse
3. Eclipse hangs

Steps to Reproduce (Error):
1. Unzip attached com.jboss.developer.studio.beginners.guide_1.0.0.zip file and copy folder into your eclipse plugin directory
2. Start eclipse
3. Eclipse opens
4. Go to Help -> Help Contents
5. Expand "Beginners Guide"
6. Click on any child link
7. Error appears on the right where the content should appear 

 
Actual results:
Hanging or error (see above for further details).

Expected results:
Output folder named correctly with plugin.xml containing correct information in the "id" field and "version" field as it applies to Eclipse (see attached examples).

That the folder can be dropped into an eclipse plugin directory, eclipse started and the content able to be used - branded - as expected.

Additional info:
The attached files are as follows:

eclipse.zip -> eclipse output of the JBDS Beginners Guide, untouched after publican generation

com.jboss.developer.studio.beginners.guide_1.0.0.zip -> publican generated content modified to adhere to eclipse convention and links (in the toc.xml) that refer to anchors commented out for testing purposes

com.redhat.eap6.doc_1.0.0.zip -> output from internal program created by mcasperson that works as an eclipse plugin. 

SVN location of book (anonymous check-out): 
http://anonsvn.jboss.org/repos/jbosstools/trunk/documentation/guides/Beginners_Guide/
Comment 1 Isaac Rooskov 2011-08-03 05:18:56 UTC 
Created attachment 516432 [details]
Normal publican output
Comment 2 Isaac Rooskov 2011-08-03 05:19:46 UTC 
Created attachment 516433 [details]
Modified publican output
Comment 4 Isaac Rooskov 2011-08-03 05:35:58 UTC 
This page may be of assistance:

http://www.ibm.com/developerworks/opensource/library/os-echelp/
Comment 5 Ruediger Landmann 2011-08-22 05:51:52 UTC 
Nothing to do with Fedora's packaging of Publican: redirecting upstream.
Comment 6 Jeff Fearn 🐞 2011-08-24 03:55:38 UTC 
The presence of the DOCTYPE line in xml and html output was causing eclipse to barf. Suppressed output of DOCTYPE for eclipse output.

Applied to branches/publican-2x and trunk.

Committed revision 1869.
Comment 7 Jeff Fearn 🐞 2011-09-06 03:56:47 UTC 
Publican 2.7 has been release and includes a fix for this issue.