Opened 8 years ago

Closed 8 years ago

Last modified 8 years ago

#4382 closed (fixed)

specify in '{# ... #}' template doc section that this is only for single-line comments

Reported by: Trent Mick <trentm@…> Owned by: jacob
Component: Documentation Version: master
Severity: Keywords:
Cc: Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: UI/UX:

Description

I struggled for a little while to figure out why the use of '{# ... #}' stopped working when a line break was added to the "..." part. I'd just jumped to http://www.djangoproject.com/documentation/templates/#comments to see how to add a comment (not noticing the separate {%comment%} section lower down). It would be helpful to mention in that section that "{#...#}" is only for single-line comments. Perhaps something like:

This syntax only works for single-line comments. For multi-line comments use the {% comment %}...{% endcomment %} syntax <a href="http://www.djangoproject.com/documentation/templates/#comment">described below</a>.

Attachments (1)

4382.diff (417 bytes) - added by Marc Fargas <telenieko@…> 8 years ago.
Add a note on docs/templates.txt stating that.

Download all attachments as: .zip

Change History (5)

Changed 8 years ago by Marc Fargas <telenieko@…>

Add a note on docs/templates.txt stating that.

comment:1 Changed 8 years ago by Marc Fargas <telenieko@…>

  • Has patch set
  • Needs documentation unset
  • Needs tests unset
  • Patch needs improvement unset

Added a docs patch, some triager please checkit and mark ready-for-checkin? thanks! :)

comment:2 Changed 8 years ago by Simon G. <dev@…>

  • Triage Stage changed from Unreviewed to Ready for checkin

done and dusted.

comment:3 Changed 8 years ago by mtredinnick

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

I inadvertently fixed this whilst doing something else and only later remembered that I'd seen it in a ticket. Sorry, Marc, wasn't intending to ignore your patch. Fixed in [5359]

comment:4 Changed 8 years ago by Marc Fargas <telenieko@…>

Don't worry ;)

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