Sphinxed Phoenix Documentation 3 - wxPython-dev

The old Google Groups will be going away soon, but your browser is incompatible with the new version.
Message from discussion Sphinxed Phoenix Documentation 3
Received-SPF: pass (google.com: domain of andrea.gav...@gmail.com designates 209.85.210.181 as permitted sender) client-ip=209.85.210.181;
MIME-Version: 1.0
In-Reply-To: <4F57E121.5020...@alldunn.com>
References: <CAEf70bw3BcY83YZ0A1_ND+RaLXC6SVFBnSEjBuz+m9JAjr+...@mail.gmail.com>
	<4F440057.7090...@alldunn.com>
	<CAEf70bw8pD07tD4va-ELZv4dhS5Le4Q_w84p6106vh+Fwi8...@mail.gmail.com>
	<4F440DD0.90...@alldunn.com>
	<CAEf70bwZ=ZE9mPPC4zTb19S3_d976=FNHj+U1L4=L4EgVn_...@mail.gmail.com>
	<4F4DDB59.4060...@free.fr>
	<4F57E121.5020...@alldunn.com>
Date: Mon, 12 Mar 2012 23:28:13 +0100
Message-ID: <CAEf70bwjCCOEjbTrPz2xodhAVkj54uHCW2ea21pwM7+YAyr...@mail.gmail.com>
Subject: Re: [wxPython-dev] Sphinxed Phoenix Documentation 3
From: Andrea Gavana <andrea.gav...@gmail.com>
To: wxpython-dev@googlegroups.com
Content-Type: text/plain; charset=ISO-8859-1

Hi Robin & All,

On 7 March 2012 23:28, Robin Dunn wrote:
> On 2/29/12 12:01 AM, werner wrote:
>>
>> Hi Andrea,
>>
>> On 28/02/2012 23:24, Andrea Gavana wrote:
>>>
>>> New documentation:
>>> http://xoomer.virgilio.it/infinity77/Phoenix/main.html TextCtrl specific:
>>
>> That still shows "last updated 30 December 2011", what about putting the
>> generation date into the "SVN Revisions" box?
>>
>> Robin, with regards to the Widget gallery I came up with a way to
>> automate the capture but it requires the demos to be changed to have a
>> method "runTestCapture" which is running the demo directly, i.e.
>> bypasses the button to click stuff we have on many demos. Would this
>> approach be fine with you, i.e. would you accept patches for this to the
>> demo or can you think of a better way doing the capture?
>
>
> Yes, that seems like a good approach.

I have uploaded a new version of the Phoenix documentation, up to date
to today with the various new wx.ToolBar, wx.DateTime and friends and
wx.FileSystem and friends, plus their overview.

But what I wanted to say is: since we are already handling various
snippet of code, which then get embedded in the Sphinx output like
this:

http://xoomer.virgilio.it/infinity77/Phoenix/DateTime.html#DateTime.ConvertYearToBC

I would like to ask the community to try and contribute snippets of
code for methods/classes/functions which do not currently have a
wxPython example, and not to rely only on the translated C++ snippets
from wxWidgets. My point is, each of us has some nice trick in the
hat, short snippets that demonstrate the use of some methods/functions
in a smart or innovative way or simply they fully convey the
usefulness of a method. The snippets need not be full runnable
samples, just few lines of code showing how to call a specific method
(and maybe a comment).

If the community thinks that this is a reasonable idea and if someone
wishes to contribute something like this (and it can be an example of
use of any method/function/class in the Phoenix namespace), please do
send it to me. Normally the convention is to name the snippet of code
like "classname.methodname.INTEGER.py", i.e. if I want to contribute 2
snippets about the wx.CheckBox SetValue method, I'll call my Python
snippet files like this:

CheckBox.SetValue.1.py
CheckBox.SetValue.2.py

I believe it's worth the effort, but then again this is just my 2 cents :-)

Andrea.

"Imagination Is The Only Weapon In The War Against Reality."
http://xoomer.alice.it/infinity77/
Create a group - Google Groups - Google Home - Terms of Service - Privacy Policy
Account Options
