Hi Waldek,

there is actually a little issue with the sphinx stuff.

I can certainly write code to pick up the year from the commit date at compile time and put it into the year for the BibEntry and also in the copyright string that appears at the bottom of every generated html-page.

However, we certainly also want the year to appear correctly, if the user is running 'make doc' or 'make localdoc'.

So, probably no problem, if there is a .git directory, but if a user gets the sources from the tarball, then I do not see any reliable source for the year inside the actual content of the tarball.

To resolve this "year problem", an option is that you include

src/doc/sphinx/source/citation.rst and
src/doc/sphinx/source/conf.py

https://github.com/fricas/fricas/blob/master/src/doc/sphinx/source/citation.rst?plain=1#L15
https://github.com/fricas/fricas/blob/master/src/doc/sphinx/source/conf.py#L47

into your list of things to set appropriately before the release is done.

Honestly, I'd prefer a variable, for example PACKAGE_YEAR or PACKAGE_RELEASE_DATE (maybe in configure.ac, which you change for the release) that distributes to the Makefiles. Such a variable can then be used to automate that sphinx stuff. So all version stuff just in configure.ac.

What do you prefer?

Ralf

On 6/30/24 18:25, Ralf Hemmecke wrote:
PS: In fact, there is also a missed version change in citation.rst.

  @Misc{FriCAS,
    key =     {FriCAS},
    author =  {{FriCAS team}},
    year =    {2024},
    title =   {{FriCAS} 1.3.10---an advanced computer algebra system},
    note =    {Available at \url{http://fricas.github.io}}
  }

I'll also try to set this up for the next release so that 1.3.10 becomes
|PACKAGE_VERSION| and thus will be automatically be generated correctly.

--
You received this message because you are subscribed to the Google Groups "FriCAS - 
computer algebra system" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/fricas-devel/6514b6c1-e0eb-4345-b3bd-fe89255656ff%40hemmecke.org.

Reply via email to