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

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:

Looking at upstream, publican seems rather dead though: and
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 ( I can download a tarball for release 4.3.2 ("") 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.




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.



2020-08-09 08:04

developer   ~0064250

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 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 (

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



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!