bug#64397: 29.0.91; Limited configuration of commands based on python-interpreter

[kobarity]

Eli Zaretskii wrote:
> 
> > From: Matthias Meulien <orontee@gmail.com>
> > Cc: kobarity <kobarity@gmail.com>,  64397@debbugs.gnu.org
> > Date: Thu, 06 Jul 2023 22:39:34 +0200
> > 
> > Not sure it address your very relevant comment on the doc string of
> > python-shell-interpreter-args.  I must confess I don't understand the
> > meaning of the word "shell" in this file python-mode.el (even after
> > reading https://en.wikipedia.org/wiki/Shell_(computing))!
> 
> Then how about leaving the doc string of python-shell-interpreter-args
> as it was before?

This may be a good opportunity to clarify the docstrings.  The current
short descriptions are a bit inconsistent.

python-interpreter
  Python interpreter for noninteractive use.
python-shell-interpreter
  Default Python interpreter for shell.
python-shell-interpreter-args
  Default arguments for the Python interpreter.

In python.el, Python Shell just means the interactive Python
interpreter (or REPL) invoked by C-c C-p (M-x run-python).
python-interpreter is added in Emacs 29 to call Python
non-interactively.  How about the following descriptions?

python-interpreter
  Python interpreter for noninteractive use.
python-interpreter-args
  Arguments for the Python interpreter for noninteractive use.
python-shell-interpreter
  Python interpreter for interactive use.
python-shell-interpreter-args
  Arguments for the Python interpreter for interactive use.