Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Translation for "fr/3/library/argparse.html" forgot the translation of some paragraphs #118972

Closed
fkhn opened this issue May 12, 2024 · 2 comments
Labels
docs Documentation in the Doc dir

Comments

@fkhn
Copy link

fkhn commented May 12, 2024

Documentation

In https://docs.python.org/fr/3/library/argparse.html#sub-commands there are paragraphs in English.

Many programs split up their functionality into a number of sub-commands, for example, the svn program can invoke sub-commands like svn checkout, svn update, and svn commit. Splitting up functionality this way can be a particularly good idea when a program performs several different functions which require different kinds of command-line arguments. ArgumentParser supports the creation of such sub-commands with the add_subparsers() method. The add_subparsers() method is normally called with no arguments and returns a special action object. This object has a single method, add_parser(), which takes a command name and any ArgumentParser constructor arguments, and returns an ArgumentParser object that can be modified as usual.

A French translation might be:

De nombreux programmes divisent leurs fonctionnalités en plusieurs sous-commandes. Par exemple, le programme svn peut invoquer des sous-commandes comme svn checkout, svn update et svn commit. Diviser les fonctionnalités de cette manière peut être une bonne idée lorsqu'un programme effectue plusieurs fonctions différentes qui nécessitent différents types d'arguments de ligne de commande. ArgumentParser prend en charge la création de telles sous-commandes avec la méthode add_subparsers(). La méthode add_subparsers() est normalement appelée sans arguments et renvoie un objet d'action spécial. Cet objet a une seule méthode, add_parser(), qui prend un nom de commande et tous les arguments du constructeur ArgumentParser, et renvoie un objet ArgumentParser qui peut être modifié comme d'habitude.

Similarly, when a help message is requested from a subparser, only the help for that particular parser will be printed. The help message will not include parent parser or sibling parser messages. (A help message for each subparser command, however, can be given by supplying the help= argument to add_parser() as above.)

A French translation might be:

De même, lorsqu'un message d'aide est demandé pour un sous-analyseur, seule l'aide pour cet analyseur particulier sera imprimée. Le message d'aide n'inclura pas les messages de l'analyseur parent ou des analyseurs frères. (Cependant, un message d'aide pour chaque commande de sous-analyseur peut être fourni en passant l'argument help= à add_parser() comme ci-dessus.)

@fkhn fkhn added the docs Documentation in the Doc dir label May 12, 2024
@JelleZijlstra
Copy link
Member

Thanks for you report! Could you send this to https://github.com/python/python-docs-fr, where the French docs are maintained?

See also https://devguide.python.org/documentation/translating/ for more on how translations are managed.

@JelleZijlstra JelleZijlstra closed this as not planned Won't fix, can't repro, duplicate, stale May 12, 2024
@fkhn
Copy link
Author

fkhn commented May 12, 2024

Thanks for the pointer, the ticket there is https://git.afpy.org/AFPy/python-docs-fr/issues/268)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation in the Doc dir
Projects
None yet
Development

No branches or pull requests

2 participants