Packaging 4.2.5 for Debian

[Magnate]

Hi all,

I'm going to be asking some dumb questions as I get up to speed after several years of not keeping up. (I did get quite a long way in February but there was a bug in SDL2 I wasn't able to fix, which has now been fixed!)

The first one I asked in the V forum - who wrote the code to generate the manual? It's a nice bit of code, but it uses sphinx which I'm not familiar with, and in particular it uses a sphinx template which doesn't exist in Debian, so I need to see what can be salvaged here, otherwise I have to package with the manual generation totally disabled.

[backwardsEric]

The first one I asked in the V forum - who wrote the code to generate the manual? It's a nice bit of code, but it uses sphinx which I'm not familiar with, and in particular it uses a sphinx template which doesn't exist in Debian, so I need to see what can be salvaged here, otherwise I have to package with the manual generation totally disabled.

See also this reply, http://angband.oook.cz/forum/showpos...0&postcount=13 , but takkaria set up the directory much as it exists now. To use one of Sphinx's builtin themes you could either edit docs/conf.py and change the line

html_theme = "@DOC_HTML_THEME@"

to be, for example,

html_theme = "alabaster"

or use configure and set DOC_HTML_THEME as mentioned in the link above. A list of Sphinx's builtin themes with screenshots are at https://www.sphinx-doc.org/en/master/usage/theming.html .

If you do edit docs/conf.py, that can change the version string written to the documentation (via scripts/version.sh which, if you're building with the git repository there and git installed, will use the output of "git describe" or "git rev-parse"). One can manually set the version string written to the documentation by changing the righthand side of this line in docs/conf.py:

version = "@DOC_VERSION@"

(though for packaging for Debian it would probably be cleaner to build from the source archive without the git repository, for instance https://github.com/angband/angband/r...d-4.2.5.tar.gz , and change the version file in the top level directory to match the version number that'll be used with Debian).

[Magnate]

Thank you, that's v helpful. I appear to have found a theme last time I built 4.2.1 and 4.2.4 so I will see how I get on. Thanks for the info!

[Magnate]

Ok here is my next problem:

chrisc@fatboy:~/Tech/angband/angband-github$ make distclean
mk/buildsys.mk:24: mk/extra.mk: No such file or directory
make: *** No rule to make target 'mk/extra.mk'. Stop.
chrisc@fatboy:~/Tech/angband/angband-github$ make clean
mk/buildsys.mk:24: mk/extra.mk: No such file or directory
make: *** No rule to make target 'mk/extra.mk'. Stop.

Why does make clean not work? What am I missing? The mk/ directory contains three files: buildsys.mk, buildsys.mk.in and extra.mk.in

So is extra.mk not getting created when it should be, and breaking things? Or is it now obsolete and the Makefile targets should be updated accordingly?

[Magnate]

Ha, found it. Entirely my problem, created years ago, now fixed.

[Magnate]

In case anyone cares:

https://packages.qa.debian.org/a/angband/news/20231011T210455Z.html

[t4nk]

In case anyone cares:

https://packages.qa.debian.org/a/ang...1T210455Z.html

Hey, Magnate
as a long time user of Debian, and the initial author of the SDL2 frontend, I do care. Thank you.

[Nick]

Hey, Magnate
as a long time user of Debian, and the initial author of the SDL2 frontend, I do care. Thank you.

Good to see you back

[t4nk]

Good to see you back

Thank you. It is possible that I'll yet contribute more to Angband and/or NewSil. If you and backwardsEric are satisfied with the quality of my programming, of course.

main-sdl2.c was included in Angband in essentially an "early beta" stage, for reasons that are well known to you. Even so, it seems to have worked decently, all in all.

edit: in any case, main-sdl2.c was written on and for Debian. I think it was Wheezy... it's been a while So yes, I do care.

[Magnate]

Very pleased to make your acquaintance! I have just updated the package to use fonts from other Debian packages (which the brilliant design of the SDL2 front-end accommodates easily!) but it hasn't been reviewed or uploaded yet. Eric was talking about porting the font browser from the SDL1 front end, which would help people navigate the vast number of available fonts!

I am now working on packaging Shockbolt's tiles and Dubtrain's sounds ...

[Magnate]

Update: both the main angband package, and the angband-audio package (with Dubtrain's sounds) are now in Debian testing, so will eventually be in the next stable version (though that is a year or two off). More usefully for some, they will be in the next Ubuntu release.

Shockbolt's tiles are sadly not included, I've been told that will require yet another package.

The angband package no longer ships its own fonts, and uses preinstalled fonts from xfonts-base. A small number are missing, there is a NEWS file that explains this.