The Perl modules have inline POD docs. This can be converted to HTML and published as a GitLab artifact. The rendered HTML is kind of ugly but improving this is left as an exercise for the future. Signed-off-by: Daniel P. Berrangé <berrange@xxxxxxxxxx> --- .gitlab-ci.yml | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml index 15804f7..1cf73f0 100644 --- a/.gitlab-ci.yml +++ b/.gitlab-ci.yml @@ -3,6 +3,7 @@ stages: - prebuild - containers - build + - docs .container_job_template: &container_job_definition image: docker:stable @@ -157,3 +158,17 @@ ubuntu-1604-build: ubuntu-1804-build: <<: *build_job_definition image: $CI_REGISTRY_IMAGE/ci-ubuntu-1804:latest + +apiref: + stage: docs + image: perl + script: + - mkdir apiref + - perl -MPod::Simple::HTMLBatch -e Pod::Simple::HTMLBatch::go lib apiref + artifacts: + expose_as: 'API Reference' + name: 'apiref' + when: on_success + expire_in: 30 days + paths: + - apiref -- 2.25.4
