Re: [Django] #31006: Document how to escape a date/time format character for the |date and |time filters.

[Django]

#31006: Document how to escape a date/time format character for the |date and 
|time
filters.
-+-
 Reporter:  Baptiste Mispelon|Owner:  Ryan
 Type:   |  Cheley
  Cleanup/optimization   |   Status:  closed
Component:  Documentation|  Version:  master
 Severity:  Normal   |   Resolution:  fixed
 Keywords:   | Triage Stage:  Accepted
Has patch:  1|  Needs documentation:  0
  Needs tests:  0|  Patch needs improvement:  0
Easy pickings:  1|UI/UX:  0
-+-

Comment (by Mariusz Felisiak ):

 In [changeset:"e8b0903976077b951795938b260211214ed7fe41" e8b09039]:
 {{{
 #!CommitTicketReference repository=""
 revision="e8b0903976077b951795938b260211214ed7fe41"
 [2.2.x] Fixed #31006 -- Doc'd backslash escaping in date/time template
 filters.

 Backport of a1f14ee3e5a2160c2eef1dad58a1da11be4b1531 from master
 }}}

-- 
Ticket URL: 
Django 
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/067.104bcca47b058e8a7a38b77929409c2d%40djangoproject.com.

Re: [Django] #31006: Document how to escape a date/time format character for the |date and |time filters.

[Django]

#31006: Document how to escape a date/time format character for the |date and 
|time
filters.
-+-
 Reporter:  Baptiste Mispelon|Owner:  Ryan
 Type:   |  Cheley
  Cleanup/optimization   |   Status:  closed
Component:  Documentation|  Version:  master
 Severity:  Normal   |   Resolution:  fixed
 Keywords:   | Triage Stage:  Accepted
Has patch:  1|  Needs documentation:  0
  Needs tests:  0|  Patch needs improvement:  0
Easy pickings:  1|UI/UX:  0
-+-

Comment (by Mariusz Felisiak ):

 In [changeset:"cd7f48e85e3e4b9f13df6c0ef5f1d95abc079ff6" cd7f48e8]:
 {{{
 #!CommitTicketReference repository=""
 revision="cd7f48e85e3e4b9f13df6c0ef5f1d95abc079ff6"
 [3.0.x] Fixed #31006 -- Doc'd backslash escaping in date/time template
 filters.

 Backport of a1f14ee3e5a2160c2eef1dad58a1da11be4b1531 from master
 }}}

-- 
Ticket URL: 
Django 
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/067.d32551185d9b6c3c117f9b4bff1fa2f6%40djangoproject.com.

Re: [Django] #31006: Document how to escape a date/time format character for the |date and |time filters.

[Django]

#31006: Document how to escape a date/time format character for the |date and 
|time
filters.
-+-
 Reporter:  Baptiste Mispelon|Owner:  Ryan
 Type:   |  Cheley
  Cleanup/optimization   |   Status:  closed
Component:  Documentation|  Version:  master
 Severity:  Normal   |   Resolution:  fixed
 Keywords:   | Triage Stage:  Accepted
Has patch:  1|  Needs documentation:  0
  Needs tests:  0|  Patch needs improvement:  0
Easy pickings:  1|UI/UX:  0
-+-
Changes (by Mariusz Felisiak ):

 * status:  assigned => closed
 * resolution:   => fixed


Comment:

 In [changeset:"a1f14ee3e5a2160c2eef1dad58a1da11be4b1531" a1f14ee3]:
 {{{
 #!CommitTicketReference repository=""
 revision="a1f14ee3e5a2160c2eef1dad58a1da11be4b1531"
 Fixed #31006 -- Doc'd backslash escaping in date/time template filters.
 }}}

-- 
Ticket URL: 
Django 
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/067.19ad4529dd9a7bcf3e759c510e2876c2%40djangoproject.com.

Re: [Django] #31006: Document how to escape a date/time format character for the |date and |time filters.

[Django]

#31006: Document how to escape a date/time format character for the |date and 
|time
filters.
-+-
 Reporter:  Baptiste Mispelon|Owner:  Ryan
 Type:   |  Cheley
  Cleanup/optimization   |   Status:  assigned
Component:  Documentation|  Version:  master
 Severity:  Normal   |   Resolution:
 Keywords:   | Triage Stage:  Accepted
Has patch:  1|  Needs documentation:  0
  Needs tests:  0|  Patch needs improvement:  0
Easy pickings:  1|UI/UX:  0
-+-
Changes (by felixxm):

 * needs_better_patch:  1 => 0


-- 
Ticket URL: 
Django 
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/067.5c9d342c0353be13978cbd0e6d9bce69%40djangoproject.com.

Re: [Django] #31006: Document how to escape a date/time format character for the |date and |time filters.

[Django]

#31006: Document how to escape a date/time format character for the |date and 
|time
filters.
-+-
 Reporter:  Baptiste Mispelon|Owner:  Ryan
 Type:   |  Cheley
  Cleanup/optimization   |   Status:  assigned
Component:  Documentation|  Version:  master
 Severity:  Normal   |   Resolution:
 Keywords:   | Triage Stage:  Accepted
Has patch:  1|  Needs documentation:  0
  Needs tests:  0|  Patch needs improvement:  1
Easy pickings:  1|UI/UX:  0
-+-

Comment (by Ryan Cheley):

 Added note to 'time' as suggested by @felixxm here
 ​https://github.com/django/django/pull/12128

-- 
Ticket URL: 
Django 
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/067.c9bee362708c85a74d6f273edaea70f6%40djangoproject.com.

Re: [Django] #31006: Document how to escape a date/time format character for the |date and |time filters.

[Django]

#31006: Document how to escape a date/time format character for the |date and 
|time
filters.
-+-
 Reporter:  Baptiste Mispelon|Owner:  Ryan
 Type:   |  Cheley
  Cleanup/optimization   |   Status:  assigned
Component:  Documentation|  Version:  master
 Severity:  Normal   |   Resolution:
 Keywords:   | Triage Stage:  Accepted
Has patch:  1|  Needs documentation:  0
  Needs tests:  0|  Patch needs improvement:  1
Easy pickings:  1|UI/UX:  0
-+-

Comment (by Ryan Cheley):

 Added example to 'time' as suggested by @felixxm here
 [https://github.com/django/django/pull/12128]

-- 
Ticket URL: 
Django 
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/067.1fb66d3a0251fff95a99003f18868d0d%40djangoproject.com.

Re: [Django] #31006: Document how to escape a date/time format character for the |date and |time filters.

[Django]

#31006: Document how to escape a date/time format character for the |date and 
|time
filters.
-+-
 Reporter:  Baptiste Mispelon|Owner:  Ryan
 Type:   |  Cheley
  Cleanup/optimization   |   Status:  assigned
Component:  Documentation|  Version:  master
 Severity:  Normal   |   Resolution:
 Keywords:   | Triage Stage:  Accepted
Has patch:  1|  Needs documentation:  0
  Needs tests:  0|  Patch needs improvement:  1
Easy pickings:  1|UI/UX:  0
-+-
Changes (by felixxm):

 * needs_better_patch:  0 => 1


-- 
Ticket URL: 
Django 
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/067.523154c2d26a1173233c8498bcb3cdc8%40djangoproject.com.

Re: [Django] #31006: Document how to escape a date/time format character for the |date and |time filters.

[Django]

#31006: Document how to escape a date/time format character for the |date and 
|time
filters.
-+-
 Reporter:  Baptiste Mispelon|Owner:  Ryan
 Type:   |  Cheley
  Cleanup/optimization   |   Status:  assigned
Component:  Documentation|  Version:  master
 Severity:  Normal   |   Resolution:
 Keywords:   | Triage Stage:  Accepted
Has patch:  1|  Needs documentation:  0
  Needs tests:  0|  Patch needs improvement:  0
Easy pickings:  1|UI/UX:  0
-+-
Changes (by felixxm):

 * has_patch:  0 => 1


Old description:

> The current documentation for the
> [https://docs.djangoproject.com/en/dev/ref/templates/builtins/#std
> :templatefilter-date date] and
> [https://docs.djangoproject.com/en/dev/ref/templates/builtins/#std
> :templatefilter-time time] filters doesn't explain how to escape a format
> character.
>
> It's only documented as part of the
> [https://docs.djangoproject.com/en/dev/ref/templates/builtins/#std
> :templatetag-now now] template tag:
>
> Note that you can backslash-escape a format string if you want to use
> the “raw” value. In this example, both “o” and “f” are backslash-escaped,
> because otherwise each is a format string that displays the year and the
> time, respectively:
> It is the {% now "jS \o\f F" %}
> This would display as “It is the 4th of September”.
>

> Historically, the big table with all the available format characters used
> to be next to the documentation for `{% now %}` but it was moved at some
> point (to be with the documentation for `|date`.
>
> I would suggest moving the paragraph about backslash escape under the
> table of all formats instead (or least duplicating it there too).

New description:

 The current documentation for the
 [https://docs.djangoproject.com/en/dev/ref/templates/builtins/#std
 :templatefilter-date date] and
 [https://docs.djangoproject.com/en/dev/ref/templates/builtins/#std
 :templatefilter-time time] filters doesn't explain how to escape a format
 character.

 It's only documented as part of the
 [https://docs.djangoproject.com/en/dev/ref/templates/builtins/#std
 :templatetag-now now] template tag:

 > Note that you can backslash-escape a format string if you want to use
 the “raw” value. In this example, both “o” and “f” are backslash-escaped,
 because otherwise each is a format string that displays the year and the
 time, respectively:
 > It is the {% now "jS \o\f F" %}
 > This would display as “It is the 4th of September”.

 Historically, the big table with all the available format characters used
 to be next to the documentation for `{% now %}` but it was moved at some
 point (to be with the documentation for `|date`.

 I would suggest moving the paragraph about backslash escape under the
 table of all formats instead (or least duplicating it there too).

--

-- 
Ticket URL: 
Django 
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/067.1594bc26e232af25ba96b07825e644c1%40djangoproject.com.

Re: [Django] #31006: Document how to escape a date/time format character for the |date and |time filters.

[Django]

#31006: Document how to escape a date/time format character for the |date and 
|time
filters.
-+-
 Reporter:  Baptiste Mispelon|Owner:  Ryan
 Type:   |  Cheley
  Cleanup/optimization   |   Status:  assigned
Component:  Documentation|  Version:  master
 Severity:  Normal   |   Resolution:
 Keywords:   | Triage Stage:  Accepted
Has patch:  0|  Needs documentation:  0
  Needs tests:  0|  Patch needs improvement:  0
Easy pickings:  1|UI/UX:  0
-+-

Comment (by Ryan Cheley):

 I have made the requested change (I think) which can be found here
 [https://github.com/ryancheley/django/tree/ticket_31006]

-- 
Ticket URL: 
Django 
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/067.c72c703878e393afaa931dfaeb34fea3%40djangoproject.com.

Re: [Django] #31006: Document how to escape a date/time format character for the |date and |time filters. (was: Document how to escape a date/time format character for the |date and |time filters)

[Django]

#31006: Document how to escape a date/time format character for the |date and 
|time
filters.
-+-
 Reporter:  Baptiste Mispelon|Owner:  Ryan
 Type:   |  Cheley
  Cleanup/optimization   |   Status:  assigned
Component:  Documentation|  Version:  master
 Severity:  Normal   |   Resolution:
 Keywords:   | Triage Stage:  Accepted
Has patch:  0|  Needs documentation:  0
  Needs tests:  0|  Patch needs improvement:  0
Easy pickings:  1|UI/UX:  0
-+-
Changes (by felixxm):

 * stage:  Unreviewed => Accepted


Comment:

 `date` documentation contains an example with escaped format characters:

 > outputs 9 de Enero de 2008 (the DATE_FORMAT format specifier for the es
 locale is r'j \d\e F \d\e Y'.

 so maybe we can add a short explanation to this example, e.g.:

 > outputs 9 de Enero de 2008 (the DATE_FORMAT format specifier for the es
 locale is r'j \d\e F \d\e Y'). Both “d” and “e” are backslash-escaped,
 because otherwise each is a format string that displays the day and the
 timezone name, respectively.

 I also agree to duplicate backslash example to the `time` documentation.

-- 
Ticket URL: 
Django 
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/067.b4922fdf8e4fbbe5da4e98a422997810%40djangoproject.com.

Re: [Django] #31006: Document how to escape a date/time format character for the |date and |time filters

[Django]

#31006: Document how to escape a date/time format character for the |date and 
|time
filters
-+-
 Reporter:  Baptiste Mispelon|Owner:  Ryan
 Type:   |  Cheley
  Cleanup/optimization   |   Status:  assigned
Component:  Documentation|  Version:  master
 Severity:  Normal   |   Resolution:
 Keywords:   | Triage Stage:
 |  Unreviewed
Has patch:  0|  Needs documentation:  0
  Needs tests:  0|  Patch needs improvement:  0
Easy pickings:  1|UI/UX:  0
-+-
Changes (by Ryan Cheley):

 * status:  new => assigned
 * owner:  nobody => Ryan Cheley


-- 
Ticket URL: 
Django 
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/067.fa52fd7dd6368861cc0b4363a4e276cf%40djangoproject.com.

[Django] #31006: Document how to escape a date/time format character for the |date and |time filters

[Django]

#31006: Document how to escape a date/time format character for the |date and 
|time
filters
+
   Reporter:  Baptiste Mispelon |  Owner:  nobody
   Type:  Cleanup/optimization  | Status:  new
  Component:  Documentation |Version:  master
   Severity:  Normal|   Keywords:
   Triage Stage:  Unreviewed|  Has patch:  0
Needs documentation:  0 |Needs tests:  0
Patch needs improvement:  0 |  Easy pickings:  1
  UI/UX:  0 |
+
 The current documentation for the
 [https://docs.djangoproject.com/en/dev/ref/templates/builtins/#std
 :templatefilter-date date] and
 [https://docs.djangoproject.com/en/dev/ref/templates/builtins/#std
 :templatefilter-time time] filters doesn't explain how to escape a format
 character.

 It's only documented as part of the
 [https://docs.djangoproject.com/en/dev/ref/templates/builtins/#std
 :templatetag-now now] template tag:

 Note that you can backslash-escape a format string if you want to use
 the “raw” value. In this example, both “o” and “f” are backslash-escaped,
 because otherwise each is a format string that displays the year and the
 time, respectively:
 It is the {% now "jS \o\f F" %}
 This would display as “It is the 4th of September”.


 Historically, the big table with all the available format characters used
 to be next to the documentation for `{% now %}` but it was moved at some
 point (to be with the documentation for `|date`.

 I would suggest moving the paragraph about backslash escape under the
 table of all formats instead (or least duplicating it there too).

-- 
Ticket URL: 
Django 
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-updates+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/052.3378cafe0658520552f1a0274fd1c502%40djangoproject.com.