[DB-SIG] reST DBAPI [was: Use of context managers with DB API 2]

[Daniele Varrazzo]

On Tue, Nov 6, 2012 at 2:49 PM, M.-A. Lemburg <mal at egenix.com> wrote:
> On 05.11.2012 18:29, Daniele Varrazzo wrote:
>> On Mon, Nov 5, 2012 at 10:16 AM, M.-A. Lemburg <mal at egenix.com> wrote:
>>> On 05.11.2012 10:46, Daniele Varrazzo wrote:
>>>> On Mon, Nov 5, 2012 at 9:28 AM, M.-A. Lemburg <mal at egenix.com> wrote:
>>>>> On 04.11.2012 23:24, Christoph Zwerschke wrote:
>>>>
>>>>>> Is everybody happy with that?
>>>>>
>>>>> Sounds good :-)
>>>>
>>>> While at changing the DBAPI: would it be ok to reformat it in reST?
>>>> Not only for aesthetic reasons, but also to provide anchors to refer
>>>> to: in psycopg docs there are several cross references to the api and
>>>> they can only be to the whole file, not to the point being referenced.
>>>> I can do it if you want.
>>>
>>> If you'd like to do the conversion, we can go ahead with this. I'd
>>> suggest you first do the conversion and then we add the new text
>>> snippet for context managers.
>>
>> Here is a mockup of the pep rendered with stylesheets in place:
>> <http://piro.synology.me/dbapi/>. Please review it: if it's fine we
>> can submit it for inclusion in the peps repos. Current version of the
>> pep in reST is at <http://piro.synology.me/dbapi/pep-0249.txt>.
>
> Thanks, Daniele. I'll have a look later today. Which version of
> the file is more current ? The one on your site or the one on
> the ticket ?
>
> http://bugs.python.org/issue16420

They should be equal, haven't changed anything after submitting it to
the tracker. I'll keep the tracker informed if I change anything else.

I've seen you have just dropped the note [9]
(http://hg.python.org/peps/rev/888c87639210): I'll leave you to do the
same on the reST version.

-- Daniele