Re: Where to contribute manual translations ?

[Eli Zaretskii]

> From: Vincent Belaïche <vincent.b.1@hotmail.fr>
> Date: Wed, 27 Dec 2023 21:14:06 +0000
> msip_labels: 
> 
> Where is the right place to contribute a translation to French of the SES 
> manual ?

We don't have a place yet.  Do you intend to contribute this to the
Emacs project, so that this manual is maintained as part of Emacs and
distributed with the release tarballs, or do you intend to make it a
separately-maintained manual available from outside of emacs.git?  In
the latter case, perhaps making it a GNU ELPA package could be a
possibility?

> Is it there : https://savannah.nongnu.org/projects/emacsdoc-fr

It could be.  But I'm not sure it's the best place, at least from the
discoverability POV.

> Or can it be placed directly under the Emacs repo (or is there any git 
> submodule planned under
> directory doc for that ?)

It can, if you'd like to contribute this manual to the Emacs project,
and keep maintaining it as part of Emacs.

> Another question : how to internationalize docstrings ? IMHO it would be 
> great if the docstring could
> have some info manual anchor in it, and one could display it from the 
> currently selected language
> manual. Besides, reading docstring from manual via some anchor is basically 
> what Calc does with
> some kitchen tricks.  

We don't yet have the necessary infrastructure for translating doc
strings.  This was discussed in the past several times, and the
conclusion was that it's a non-trivial project.  Some of the previous
discussions:

  https://lists.gnu.org/archive/html/emacs-devel/2017-04/msg00750.html
  https://lists.gnu.org/archive/html/emacs-devel/2017-05/msg00645.html
  https://lists.gnu.org/archive/html/emacs-devel/2017-05/msg00751.html
  https://lists.gnu.org/archive/html/emacs-devel/2017-05/msg00806.html
  https://lists.gnu.org/archive/html/emacs-devel/2019-03/msg00081.html
  https://lists.gnu.org/archive/html/help-gnu-emacs/2021-07/msg00422.html