mentby.com
Blog | Jobs | Help | Signup | Login

Commentary of wxPython online docs



This may be helpful to others needing information from the online
wxPython docs;

http://www.wxpython.org/docs/api/wx.TextCtrl-class.html
does not have specific TextCtrl widget styles or events documented.

but http://www.wxpython.org/docs/api/wx.Button-class.html
does list widget styles and events.

I presume the documentation of widgets will at times list specific
widget styles and events and at other times other wxPython widget docs
will not.

Or is this unqiue to wx.TextCtrl()?

When I don't find the wxPython docs complete I go to:

http://wxruby.rubyforge.org/doc/textctrl.html
# visually very appealing and professional looking IMO

http://docs.wxwidgets.org/2.6/wx_wxtextctrl.html
# relatively comprehensive but in IE6 different web blocks put fonts
SO tiny that I have to zoom in and out just to follow the topic

http://wiki.wxwidgets.org/WxTextCtrl
# offers different perspectives of usage

http://docs.wxwidgets.org/trunk/classwx_text_ctrl.html
# relatively comprehsive but has things not apart of the wxPython
package such as wxFilename and more.

This I use PyCrust to check if what's in other websites docs is in the
wxPython package. Yeah, I know alot of hunting for info. It is what it
is, for now.

--
To unsubscribe, send email to wxPython-users+unsubscribe*******
or visit  http://groups.google.com/group/wxPython-users?hl=en


Dev Player Sun, 09 Jan 2011 13:10:58 -0800

Thanks for all the leads. It takes a lot of work to come up with a
good list. I understand all the wxWidgets docs are now in the process
of being rewritten. But, I won't be holding my breathe waiting for
this to happen.

HOWEVER, don't you think in the meantime this info would best be
documented as a permanent item on this Google group's front page at
wxPython-users *******/group/wxpython-users  ? Yes,
this is a rhetorical question. It seems doing so would save the need
for many threads that could be easily answered once users have
convenient access to good documentation sources.

A while back ( 6-12 months ago IIRC ) there was another thread to
which many people contributed a whole lot of good doc sources. I
forgot to make a bookmark to that thread (sigh).

Ray Pasco

--
To unsubscribe, send email to wxPython-users unsubscribe*******
or visit  http://groups.google.com/group/wxPython-users?hl=en


Ray Pasco Mon, 10 Jan 2011 09:58:58 -0800

No, the docs at wxpython.org were never finished and so lots of classes
only have the information that was automatically generated.  That is not
as useless as it sounds because knowing exactly which classes and
methods are available in wxPython, and their parameter names and types
is not something you can always reliably get from the C++ docs.  So
although work on those docs has been mostly abandoned, I plan on leaving
them on the web site until the new new docs are being generated by
Project Phoenix.

--
Robin Dunn
Software Craftsman http://wxPython.org

--
To unsubscribe, send email to wxPython-users+unsubscribe*******
or visit  http://groups.google.com/group/wxPython-users?hl=en


Robin Dunn Mon, 10 Jan 2011 11:15:22 -0800

I compiled a list of links too for wxPython documentation: http://www.blog.pythonlibrary.org/2010/12/05/wxpython-docume[..]

-------------------
Mike Driscoll

Blog:    http://blog.pythonlibrary.org

--
To unsubscribe, send email to wxPython-users unsubscribe*******
or visit  http://groups.google.com/group/wxPython-users?hl=en


Mike Driscoll Mon, 10 Jan 2011 12:52:15 -0800

All in all, I'd agree that there is a good bit of hunting involved, but I
think that wxPython is worth it! Yes, I think it would be good to have a
link to this on the frontpage, but also, I think that one  item should be
added: the mailing list archives. There are lot's of wonderful threads with
tons of good advice, but, just to say, putting a link on the frontpage won't
stop people from asking about good doc sources, because, there is a link to
the sample app page, and lot's of time, people still write in with specific
questions without sample apps, I'll admit that sometimes I too do this, but
it's just cause I'm a lazy programmer :)

--
Hi, I will kill all ads in google gmail.
They will all be dead and gone for all my emails to you. HA HA bye bye ads I
just massacred you!!!

--
To unsubscribe, send email to wxPython-users+unsubscribe*******
or visit  http://groups.google.com/group/wxPython-users?hl=en


mpnordland Mon, 10 Jan 2011 14:10:46 -0800

Thanks Mike.

I noticed at your link your blog and saw you mention the same issue
someone else will get some free time and become a doc monkey who can
go through the wiki and clean it up. "

I'd only ask that there are tutorials on there that may be old,
meaning the styles are no longer used. But should you find yourself
working away at some of those wiki articles please keep in mind that
sometimes -new- isn't always a better teacher. Some of the old stuff I
find there and other places explain things better then alot of "newer"
posts.

And I, being very forgetful, keep going back to them, like the sizer
ones and the starter apps.

--
To unsubscribe, send email to wxPython-users unsubscribe*******
or visit  http://groups.google.com/group/wxPython-users?hl=en


Dev Player Thu, 13 Jan 2011 17:54:07 -0800

I'm referring to the stuff that uses wxPanel instead of wx.Panel and other
obsolete or just plain wrong methodologies. If I was to go through it, I
would not delete important stuff, just update it and maybe add some more
examples, screenshots, etc.

--
-----------------
Mike Driscoll

Blog:    http://blog.pythonlibrary.org

--
To unsubscribe, send email to wxPython-users+unsubscribe*******
or visit  http://groups.google.com/group/wxPython-users?hl=en


Mike Driscoll Thu, 13 Jan 2011 18:40:14 -0800



Related Topics

Post a Comment