-
Notifications
You must be signed in to change notification settings - Fork 57
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
Nested subcommands improvement #107
Labels
Comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Hello, thanks for the plugin, it's an excellent tool for documenting click-based apps.
I would like to ask you for improvement. We are using sphinx-click together with the sphinx.ext.autosectionlabel extension. However, there's a problem with subcommands with the same name.
For example, we have two applications that share some of their subcommand names:
and
The problem is that each subcommand is a label that is not unique. So when we use it together with autosectionlabel we duplicate labels get warnings:
The solution is to set nested to "none" but it's useless in this case... So would it be possible to somehow add prefixes to labels of subcommands?
Prefix would be really useful for commands with more than one level of nesting, for example this:
thanks
The text was updated successfully, but these errors were encountered: