Erik found a way to generate the man page automatically from docs/ref/django-admin.txt and this has now been merged & integrated into the release process. See the ticket for details: https://code.djangoproject.com/ticket/23903
On Friday, June 19, 2015 at 10:55:53 AM UTC-4, Luke Plant wrote: > > 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/ >>> >>> 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] <javascript:>. > To post to this group, send email to [email protected] > <javascript:>. > 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/c4f5e150-0015-4768-a16e-2e5debaa77b7%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
