Bug 1486945 - Rework apidoc generation
Summary: Rework apidoc generation
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Spacewalk
Classification: Community
Component: Release
Version: 2.7
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
Assignee: Tomas Lestach
QA Contact: Red Hat Satellite QA List
URL:
Whiteboard:
Depends On:
Blocks: space28
TreeView+ depends on / blocked
 
Reported: 2017-08-30 21:00 UTC by Eric Herget
Modified: 2018-04-20 12:31 UTC (History)
0 users

Fixed In Version: spacewalk-java-2.8.44-1
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2018-04-20 12:31:30 UTC
Embargoed:


Attachments (Terms of Use)

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


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