Re: groff 1.25.0.rc1 testing

"G. Branden Robinson" <[email protected]> Tue, 21 Jul 2026 00:40:04 -0500
Newsgroups gmane.comp.printing.groff.general
Message-ID <20260721054004.tim7baxasakxttfe@illithid>
--3h7omxljoo2t467d
Content-Type: text/plain; protected-headers=v1; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
Subject: Re: groff 1.25.0.rc1 testing
MIME-Version: 1.0

[self-follow-up]

I left out a step from my explanation.

At 2026-07-21T00:35:40-0500, G. Branden Robinson wrote:
> If you're doing an out-of-tree build, then the presence of ".version"
> in your Git working copy can confuse a human because its contents can
> get very stale, but it doesn't confuse the build system--I'll explain
> below.  You can delete it and start an out-of-tree build anew.
>=20
> The rules for generating these files are as follows.
>=20
> $ nl -ba Makefile.am | sed -n 872,877p
>    872  # Version files - see script "build-aux/git-version-gen".
>    873  .version:
>    874          $(AM_V_GEN)echo $(VERSION) > $@-t && mv $@-t $@
>    875  dist-hook:
>    876          $(AM_V_GEN)echo $(VERSION) > $(distdir)/.tarball-version
>    877

Where does the make(1) macro `VERSION` get its definition?

Earlier in the file.

$ nl -ba Makefile.am | sed -n 509,530p
   509  # 'VERSION' is generated by gnulib script git-version-gen, using the
   510  # command 'git describe':
   511  #
   512  # - From a git repository: if the current commit corresponds to a
   513  #   tag, then 'VERSION' is simply the tag (e.g. 1.22.3).  Otherwise
   514  #   'VERSION' has the following format:
   515  #     <tag>-<nb_commits>-<commit>
   516  #
   517  #   With:
   518  #     . tag: the most recent tag reachable from the current commit
   519  #     . nb_commits: number of commits between the most recent tag a=
nd
   520  #       the current commit.
   521  #     . current commit, abbreviated.
   522  #   For example: 1.22.3.real.434-5aafd
   523  #   The version is stored in .version.
   524  #
   525  # - From a tarball, the version is taken from .tarball-version
   526  #
   527  # REVISION is the full revision given by git-version-gen, which can
   528  # have non-alphanumeric symbols.
   529  #
   530  # Also see configure.ac for the related SHORT_VERSION macro.

Regards,
Branden

--3h7omxljoo2t467d
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAmpfBjMACgkQ0Z6cfXEm
bc4q7g//dKNpTfvgjGZdrli66lidaHNQOQAIBVieRcCKc3FQnsKiYuN/bIh2d9qP
JOi8tA9+MmGbF/vNEvlE7DLjdogquSXYmNcFMO7UMHJEYuSkk6jKeVDZPr/E2Gc1
uP1ayMP/ubk4cdylMI+PjyL3+5o/i12dUZuE8FugMsgLkwOTLQqhSXk93g/Efv2d
Y5ILlvRkANjHgq5AjbfNIN/W5QFfdP7zus0qgMWGa84b+1wmq282TrJj53NEMqOo
HiiCZ35s2bYRcw4+jklaelkds1mkMLyGM5zxTmLPJreBoHXKMD9uv4MQ+L/aoJuH
yv4cKoPqBZ2raVIJn463OebMz3SxnWc/77TC62cFuyxDjcRRlJnMBsZkwz5dXf0i
OY8mO53IZx7jSPlxFr7AYcZCLQpfClcMoNrReBe+RVeFZBU27GRsuTOfWZ5JPtmy
/5UmpA84Ra6qvPtXMoi9sSwDA2bSOgBtvgIY/WWRzoEXnZ1PsMmMDU9GWbghdWAJ
yeaqIVLOuIzqLbto434juBWE6ej7CelJcrpjhFIgV0zSLiVvPG6TYcyf+VQwQVmh
0i+uckyOIus8XGjuSBuumjbZKgpcLQme9hWKi8KCT+1JNPMuyotd8NTzrXWkC7Rp
dpvZk+KYShL3fqKabzxCtT+D7iof7BqK7O+1PJLf6yGV2BHo3b8=
=pbVE
-----END PGP SIGNATURE-----

--3h7omxljoo2t467d--