Bug#866875: quake3: broken symlink: /usr/share/doc/quake3/README.quake3-data -> ../../games/quake3/README.quake3-data

Simon McVittie smcv at debian.org
Sun Jul 2 17:02:00 UTC 2017


On Sun, 02 Jul 2017 at 14:21:55 +0200, Andreas Beckmann wrote:
> 1m2.1s ERROR: FAIL: Broken symlinks:
>   /usr/share/doc/quake3/README.quake3-data -> ../../games/quake3/README.quake3-data
> 
> 
> I don't know if this link would be satisfied by quake3-data,
> it is not satisfied by quake3-demo-data.
> If the README contains information how to acquire quake3-data (or
> quake3-demo-data), including the commands to be used, it should
> be shipped in the quake3 package instead.

Yes, it's meant to be included in quake3, not in one of the generated
data packages. It exists in the source package, but the rule to install
it might have got lost when src:quake3 was merged into
src:game-data-packager.

> Having never used gnome-data-packager myself, I'm wondering whether
> there should be a README giving detailed commands for creating and
> installing the data packages.
>   "If you have the original pak0.pak in /some/path ..."
>   "If you have some CD ..."
>   "To use freely available demo data from the web ..."

Yes ish. The issues with this are:

* README.quake3-data is displayed by the launcher if the data file is
  missing, and instructions at that level of detail would be rather long
  (although a lot less bad now that the launcher uses PyGI and a scrollable
  GTK text box - when a previous generation of the launcher used xmessage,
  zenity or kmessage, there was definitely a rather low limit to how long
  a message we could support).

* Documenting all the possible ways to use g-d-p has a risk of being an
  intimidating "wall of text". The only thing that quake3 strictly *needs*
  is pak0.pk3 - it's able to download everything else (the official patch)
  itself, and it also tries fairly hard to locate a pak0.pk3 in a Steam
  installation or in a previously-installed copy of quake3-data, or
  download one from Steam or GOG. Various compressed or uncompressed
  versions of other related files can be added to the command line to
  skip the download step.

* game-data-packager currently supports 210 games and there is no way
  I'm going to write artisanal READMEs for all of them :-)

    S



More information about the Pkg-games-devel mailing list