Yadex 1.7.0 (2024-01-01)

Packager's guide

This is for people who plan to package Yadex.

So you want to package Yadex ? Here is a list of things you should probably know :

• To make it install in /usr instead of /usr/local, re-run configure with the right --prefix option, type make clean && make all. That's all there is to it.

  You shouldn't have to make any manual changes ; most references to the prefix in the documentation and elsewhere use the files generated by configure (you'll have to make clean, however). One possibly undesirable consequence of this is that the doc from your package and the doc that one would get after installing from the source will not be identical. I suppose it doesn't matter.

• From version 1.6 on, alternative prefixes are better supported but the behaviour has changed somewhat. Instead of looking for files in both /usr and /usr/local, Yadex uses only the prefix directory. The goal was to reduce the unwanted interactions between Yadexes installed with different prefixes on the same system. Since packagers typically use /usr, users should be able to have on their system both the original and the packaged version of Yadex. (Incidentally, that's not true for /etc/yadex/1.7.0/yadex.cfg but the FHS is to blame).

• To allow one to have several different versions installed at the same time on the same system, Yadex uses a somewhat unusual scheme where each file installed has the version number somewhere in its pathname. If your packaging system allows version n + 1 to have a different set of files than version n of the same package, this should cause no problem. In fact, if the package manager allows that, two different versions of the package could coexist (except that they would overwrite each other's symlinks in bin/ and man/, but that's what they're for).

  If you have problems with that scheme, let me know.

• If you actually try to understand the makefile, you're going to end up hating me.