Multiple version of Info manual

Multiple version of Info manual

[Sébastien Gendre]

[-- Attachment #1: Type: text/plain, Size: 580 bytes --]

Hello,

Today, on Planet Emacs, I found this excellent documentation by Jeremy
Bryant:

Creating an info manual by conversion, example for Python
https://onlisp.co.uk/Creating-an-info-manual-for-Python.html

The Python documentation is available for multiple versions of Python.
It's very useful because in different environments (work, school, home)
you sometimes have to work with different versions of Python.

Is it possible, with the Emacs Info support, to manage different version
of the same documentation ?



Best regards

-------
Gendre Sébastien

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 849 bytes --]

Re: Multiple version of Info manual

[Eli Zaretskii]

> From: Sébastien Gendre <seb@k-7.ch>
> Date: Sat, 30 Nov 2024 10:08:28 +0100
> 
> Today, on Planet Emacs, I found this excellent documentation by Jeremy
> Bryant:
> 
> Creating an info manual by conversion, example for Python
> https://onlisp.co.uk/Creating-an-info-manual-for-Python.html

FWIW, the Python manual in Info format can be found on the Internet
and downloaded.  You don't need to produce it by yourself.

> The Python documentation is available for multiple versions of Python.
> It's very useful because in different environments (work, school, home)
> you sometimes have to work with different versions of Python.
> 
> Is it possible, with the Emacs Info support, to manage different version
> of the same documentation ?

You will need to make sure each version's manual has a distinct name.
For example, the manual for Python v3.9 could be called
python-3.9.info, while the manual for Python v3.13 could be called
python-3.13.info.

Re: Multiple version of Info manual

[Sébastien Gendre]

[-- Attachment #1: Type: text/plain, Size: 652 bytes --]

Thank you for your reply.

I have added my reply/remark bellow.

Eli Zaretskii <eliz@gnu.org> writes:
> FWIW, the Python manual in Info format can be found on the Internet
> and downloaded.  You don't need to produce it by yourself.

An official version ?

> You will need to make sure each version's manual has a distinct name.
> For example, the manual for Python v3.9 could be called
> python-3.9.info, while the manual for Python v3.13 could be called
> python-3.13.info.

Including the version in the info name is a good idea. But I will need
to write a function to switch the version of Python documentation used
with `C-h S`.

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 849 bytes --]