View Issue Details

IDProjectCategoryView StatusLast Update
0027140mantisbtdocumentationpublic2020-08-11 12:41
Reporterdvzrv Assigned To 
PrioritynormalSeverityminorReproducibilityhave not tried
Status confirmedResolutionopen 
Summary0027140: tool used for documentation generation (publican) is more or less dead
Description

Hi! I package mantisbt for Arch Linux.
I am currently considering building the package directly from the auto-generated source tarball on github (as e.g. for 2.24.2 the generated tarball is not yet available on sourceforge).

I realized that I need publican to generate the administrator/developer documentation: https://github.com/mantisbt/mantisbt/tree/master/docbook

Looking at upstream, publican seems rather dead though: https://sourceware.org/publican/en-US/index.html and https://fedoraproject.org/wiki/Infrastructure/Fedorahosted-retirement
I can't package publican (due to missing sources) and therefore can not build mantisbt from source.

Looking at Fedora's own spec file for the publican package (https://src.fedoraproject.org/rpms/publican/blob/master/f/publican.spec) I can download a tarball for release 4.3.2 ("https://fedorahosted.org/released/publican/Publican-v4.3.2.tar.gz") but the tarball is a broken archive... :-/

It would be great to switch to some alternative tool for docbook , that is more widespread and still maintained.

TagsNo tags attached.

Activities

atrol

atrol

2020-08-09 06:53

developer   ~0064248

the generated tarball is not yet available on sourceforge

Meanwhile It's available.
Due to various reasons there is some delay until it's uploaded to SF and some more delay until it's replicated to all SF servers.

I am currently considering building the package directly from the auto-generated source tarball

Keep in mind there is not only the missing documentation, but also the missing 3rd party components installed by composer.

dregad

dregad

2020-08-09 08:04

developer   ~0064250

@dvzrv
I'm aware of the obsolescence of Publican, but switching the to a new toolchain and/or format is no small undertaking, and as much as I would like to do it, the conversion effort is unfortunately too great at the moment for the time I am able to invest in MantisBT.

I also failed to find Publican binaries after fedorahosted.org was killed, and even reported the issue but never got any response.

As for not being able to download the release tarballs from SourceForge, as an alternative you can always get the nightly build following the release from our own server (https://mantisbt.org/builds.php).

The latest version of the documentation is also available online in different versions including downloadable for offline viewing.

dvzrv

dvzrv

2020-08-11 12:41

reporter   ~0064255

@atrol: Yes, the missing 3rdparty components should be no problem though, as we can use composer to install them in the packaging process.

@dregad: I understand. Do you currently use a Fedora system to generate the docs? Maybe there is an easy alternative solution to publican.
If I come across one, I'll post it here!

Issue History

Date Modified Username Field Change
2020-08-08 05:49 dvzrv New Issue
2020-08-09 06:53 atrol Note Added: 0064248
2020-08-09 08:04 dregad Status new => confirmed
2020-08-09 08:04 dregad Note Added: 0064250
2020-08-11 12:41 dvzrv Note Added: 0064255