Opened 5 years ago

Closed 4 years ago

#14419 closed (fixed)

Make `makemessages --help` more useful

Reported by: lsaffre Owned by: nobody
Component: Core (Management commands) Version: master
Severity: Keywords:
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:

Description

Calling django-admin makemessages Without any option gives::

  Error: Type 'django-admin.py help makemessages' for usage.

But calling django-admin help makemessages doesn't produce a very clear documentation. Suggestions:

  • the overview description should mention that one of options -l and -a is required.
  • remove the word "only" in description of -l option ("Creates or updates the message files for the given locale (e.g. pt_BR).")
  • change the description of -a option to "Updates the message files for all existing locales."

Attachments (1)

14419.patch (2.2 KB) - added by gruszczy 5 years ago.

Download all attachments as: .zip

Change History (4)

comment:1 Changed 5 years ago by jezdez

  • Component changed from Uncategorized to django-admin.py
  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset
  • Triage Stage changed from Unreviewed to Accepted

Changed 5 years ago by gruszczy

comment:2 Changed 5 years ago by gruszczy

  • Has patch set

comment:3 Changed 4 years ago by ramiro

  • Resolution set to fixed
  • Status changed from new to closed

(In [15302]) Fixed #14419 -- Enhanced the help text of the makemessages management command. Thanks lsaffre for the report and suggestions and gruszczy for the patch.
Also, removed the sterile make-messages.py, compile-messages.py scripts and dead compatibility code in makemessages.

Note: See TracTickets for help on using tickets.
Back to Top