Another argument for removing it (or trimming it down to minimum) is
that it's actually extensible
(https://docs.djangoproject.com/en/1.8/howto/custom-management-commands/
), and some packages (at least in the past) have actually changed the
behaviour of built in commands (e.g.
http://south.readthedocs.org/en/latest/commands.html#syncdb ).
So, the man page is doomed to be both incomplete and possibly incorrect.
Surely it makes more sense for a man page to just point to the "--help"
tag and official docs online?
Luke
On 03/03/15 15:42, Tim Graham wrote:
Is anyone interested in updating Django's man page? It's a bit
embarrassing that the one that ships with 1.7 includes commands that
no longer exist (cleanup, install (never heard of that one before),
etc.). The fact that it is so outdated and that we've gotten no
complaints about it is why I thought we could consider it for removal).
Any recommendations for a program to edit/preview manpage sources
that's more human friendly?
On Wednesday, November 26, 2014 at 8:21:31 AM UTC-5, Markus Holtermann
wrote:
On Wednesday, November 26, 2014 7:46:16 AM UTC+1, Aymeric Augustin
wrote:
Le 26 nov. 2014 à 01:51, Nick Phillips <[email protected]>
a écrit :
>
> I'd suggest considering implementing
> something to generate a man page from whatever you wish the
"canonical"
> source of the information to be.
The canonical source of information is:
https://docs.djangoproject.com/en/dev/ref/django-admin/
<https://docs.djangoproject.com/en/dev/ref/django-admin/>
Does a rst-->man conversion tool exist?
Yes, rst2man.py is part of docutils. And Sphinx even has a man
builder. Inside the docs directory run "make man". The generated
man page is 4MB though, and contains the _entire_ documentation,
not only the django-admin.py command. But there should be some way
to work around that.
/Markus
--
You received this message because you are subscribed to the Google
Groups "Django developers (Contributions to Django itself)" group.
To unsubscribe from this group and stop receiving emails from it, send
an email to [email protected]
<mailto:[email protected]>.
To post to this group, send email to
[email protected]
<mailto:[email protected]>.
Visit this group at http://groups.google.com/group/django-developers.
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-developers/1ecfaac4-b31a-4675-bd62-95e76369a6e5%40googlegroups.com
<https://groups.google.com/d/msgid/django-developers/1ecfaac4-b31a-4675-bd62-95e76369a6e5%40googlegroups.com?utm_medium=email&utm_source=footer>.
For more options, visit https://groups.google.com/d/optout.
--
"He knows the way I take: when he has tried me, I shall come forth
as gold" (Job 23:10).
Luke Plant || http://lukeplant.me.uk/
--
You received this message because you are subscribed to the Google Groups "Django
developers (Contributions to Django itself)" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/django-developers.
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-developers/55842D5F.8010409%40cantab.net.
For more options, visit https://groups.google.com/d/optout.
