id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
28524	Improve program name for Django's command-line utility.	Nick Pope	Nick Pope	"By default, according to the [[https://docs.djangoproject.com/en/dev/ref/django-admin/#usage|documentation]] there are three ways to execute Django's command-line utility:

{{{#!sh
$ django-admin <command> [options]
$ manage.py <command> [options]
$ python -m django <command> [options]
}}}

When executing the `help` command, however, the way these are rendered may be incorrect:

{{{#!console
$ django-admin help

Type 'django-admin help <subcommand>' for help on a specific subcommand.
...
}}}

{{{#!console
$ ./manage.py help

Type 'manage.py help <subcommand>' for help on a specific subcommand.
...
}}}

{{{#!console
$ python -m django help

Type '__main__.py help <subcommand>' for help on a specific subcommand.
...
}}}

It should also be noted that `manage.py` will typically not work and `./manage.py` is required:

{{{#!console
$ manage.py help
bash: manage.py: command not found
}}}

On Windows it will work, but only if the file type is associated with the Python interpreter and not an editor.

So, the issues here are:

1. `__main__.py` should be replaced by `python -m django` (or possibly use `os.path.basename(sys.executable)`)
2. Should `manage.py` be replaced with `./manage.py` on non-Windows platforms? What about Windows?
3. What should happen with the `manage.py` option in the documentation?"	Cleanup/optimization	closed	Core (Management commands)	dev	Normal	fixed	command-line		Accepted	1	0	0	0	0	0