Opened 14 years ago

Closed 14 years ago

Last modified 12 years ago

#13287 closed (fixed)

Documentation about {% url %} arguments still mentions comma separation

Reported by: rbarberac@… Owned by: Gabriel Hurley
Component: Documentation Version: dev
Severity: Keywords:
Cc: SVN-12936 Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

Until 1.2 the {% url %} aditional arguments to the URL was a comma separated list. Now is a space separated list. In the documentation the samples show this new behavior but the text still says: "Additional arguments are optional and should be comma-separated values that will be used as arguments in the URL".

By the way, this change will have a deep impact in existing deployments using Django 1.1. Didn't was a priority to mantain backwards compability? At last this was what is printed here http://docs.djangoproject.com/en/dev/misc/api-stability/

Attachments (1)

13287_docs.diff (632 bytes ) - added by Gabriel Hurley 14 years ago.
update reference to "comma-separated values" for url tag to "space-separated values"

Download all attachments as: .zip

Change History (9)

in reply to:  description comment:1 by Ramiro Morales, 14 years ago

Replying to rbarberac@gmail.com:

Until 1.2 the {% url %} aditional arguments to the URL was a comma separated list. Now is a space separated list.

[...]

By the way, this change will have a deep impact in existing deployments using Django 1.1. Didn't was a priority to mantain backwards compability? At last this was what is printed here http://docs.djangoproject.com/en/dev/misc/api-stability/

If you are actually reading the docs that accompany the current SVN code and read all the documentation of the url tag you will see a section located at the bottom marked with Changed in Django Development version. that describes how backwards compatibility is being handled transparently.

Ticket #13275 is tracking some additional problems the backward-compatibility code has.

In the documentation the samples show this new behavior but the text still says: "Additional arguments are optional and should be comma-separated values that will be used as arguments in the URL".

That's an error in the documentation. maybe we shoudl switch this ticket to component: Documentation and correct that sentence to read "Additional arguments are optional and should be space-separated values that will be used as arguments in the URL"

comment:2 by rbarberac@…, 14 years ago

Component: UncategorizedDocumentation

Yes this is a documentation error. I've changed the ticket.

comment:3 by Russell Keith-Magee, 14 years ago

Triage Stage: UnreviewedAccepted

by Gabriel Hurley, 14 years ago

Attachment: 13287_docs.diff added

update reference to "comma-separated values" for url tag to "space-separated values"

comment:4 by Gabriel Hurley, 14 years ago

Has patch: set
Owner: changed from nobody to Gabriel Hurley
Status: newassigned

Attached a patch that updates the only instance of that phrase in the docs as suggested by ramiro.

comment:5 by Chris Beaven, 14 years ago

Summary: Change in {% url %} arguments break existing codeDocumentation about {% url %} arguments still mentions comma separation

comment:6 by Chris Beaven, 14 years ago

Triage Stage: AcceptedReady for checkin

comment:7 by Russell Keith-Magee, 14 years ago

Resolution: fixed
Status: assignedclosed

(In [13107]) Fixed #13287 -- Corrected the advice on argument formatting in the {% url %} tag. Thanks to Gabriel Hurley for the report.

comment:8 by Jacob, 12 years ago

milestone: 1.2

Milestone 1.2 deleted

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