Hi Ahmad, On Sun, Jan 19, 2025 at 08:01:09PM +0000, Ahmad Khalifa wrote: > > I'm trying to package FreeBASIC along with its documentation. However, the > documentation is built from a download of their Wiki [1]. > > How to deal with this situation, I could only think of... > > 1. Package the generated html in debian/ directly. This would work, but I'm > not sure it's good idea or not. Not worried about the effort to maintain > this, but more about whether it's been done before and common or not. > > 2. Package the source of the html, which is wiki markup. This has all the > negatives of #1 along with the fact that compiling the wiki markup is done > using an included BASIC tool which has to be compiled using the compiler > being packaged. > > 3. Package the documentation compiler tool itself with a maintainer script > to download/compile the html? The documentation is important, but not this > important. > > 4. Skip documentation - it's just not redistributable. > > > Any views or ideas on this? Example projects would be appreciated. > > > 1. https://www.freebasic.net/wiki/DocToc
I solved a related problem for a non-free package with https://salsa.debian.org/debian/publicfile/-/blob/master/debian/get-publicfile-docs : to be called by the user at runtime. Not quite sure if such a hack would be suitable in your situation though... The solution as suggested by Julien would be more clean. Anyway: HTH! Bye, Joost
