New in development version or versionadded

4 views
Skip to first unread message

Graham King

unread,
Jan 28, 2009, 8:21:38 PM1/28/09
to django-d...@googlegroups.com
Hi,

I'm writing docs for a patch (#8348), and wondering how to indicate
that that feature is only available in the development version. This
used to be:

**New in Django development version**

but now I think it should be:

.. versionadded:: dev

however a grep can't find either of the above in the current docs.
What is the preferred syntax?

Thanks,
Graham

Malcolm Tredinnick

unread,
Jan 28, 2009, 8:24:56 PM1/28/09
to django-d...@googlegroups.com

Use "..versionadded::", but make the version be 1.1, not "dev". There's
a patch that we haven't applied yet, but will soon, in Trac to convert
all references to the next version to read "development version" when we
generate the HTML.

That saves us having to go through and change all occurrences of "dev
verison" to "1.1" before releasing "1.1", etc (when we always miss
something).

Regards,
Malcolm


Marc Fargas

unread,
Jan 29, 2009, 4:05:10 AM1/29/09
to django-d...@googlegroups.com
On Thu, Jan 29, 2009 at 2:24 AM, Malcolm Tredinnick <mal...@pointy-stick.com> wrote:

Use "..versionadded::", but make the version be 1.1, not "dev". There's
a patch that we haven't applied yet, but will soon, in Trac to convert
all references to the next version to read "development version" when we
generate the HTML.

For the record;
That maybe #9436, http://code.djangoproject.com/ticket/9436 ;)

Regards,
Marc
--
http://www.marcfargas.com - will be finished someday.
Reply all
Reply to author
Forward
0 new messages