Bug 1486945

Summary: Rework apidoc generation
Product: [Community] Spacewalk Reporter: Eric Herget <eherget>
Component: ReleaseAssignee: Tomas Lestach <tlestach>
Status: CLOSED CURRENTRELEASE QA Contact: Red Hat Satellite QA List <satqe-list>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 2.7   
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: spacewalk-java-2.8.44-1 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-04-20 12:31:30 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1564160    

Description Eric Herget 2017-08-30 21:00:17 UTC 
Description of problem:
apidoc generation was difficult.  The steps described in documentation/how-to-generate-documentation.txt didn't quite work and described using packages from the now deprecated jpackage repo.  In addition, I had to manually copy xalan-j2.jar from the build/run-lib directory to build/build-lib.

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

How reproducible:
Always

Steps to Reproduce:
1. Follows steps described in how-to-generate-documentation.txt

Actual results:
Various failures

Expected results:
Successful creation of apidoc documentation
Comment 1 Eric Herget 2017-11-30 19:47:26 UTC 
This is now fixed.  The steps described in documentation/how-to-generate-documentation.txt have been updated and work correctly.  In addition, the `ant init-install compile` step during Dev Workstation Setup is now updated to add xalan-j2.jar into .../java/build/build-lib dir so its available when running the apidoc generation.

spacewalk.github:
22757cca6af7635a38296f66ec6628d0b9791722
Comment 2 Jiří Dostál 2018-03-26 12:16:35 UTC 
Moving ON_QA
Comment 3 Jiří Dostál 2018-04-20 12:31:30 UTC 
Spacewalk 2.8 has been released.
https://github.com/spacewalkproject/spacewalk/wiki/ReleaseNotes28