Re: [RFC] 1.040 todos

[muppet <scott asofyet org>]

On Saturday, February 7, 2004, at 06:39 PM, Ross McFarland wrote:

> On Sat, 2004-02-07 at 02:58, muppet wrote:
> > - new features
> >    - Glib::ParamSpec->scalar(), because having to know that you need 
> > to
> >      use Glib::ParamSpec->boxed (... 'Glib::Scalar'...) really sucks.
>
> see attached patch. unless i'm missing something this should do it. 
> i've
> got it and a test ready to commit, let me know if it's good with you.

gperl.h defines GPERL_TYPE_SV, removing the need for 
gperl_type_from_package ("Glib::Scalar").

otherwise, looks good.


> >    - more interface types implemented
> >      - which ones do we need?
>
> unfortunately past experience tells me all any and all. i guess it 
> could be different in this particular case. we've taken the 'implement 
> only what's needed' approach before and always ended up giving up on 
> it and doing it 'all'.

i'd like to play this one conservatively; implementing these models is 
likely to be more esoteric of an operation.


> > - documentation generation
> >    - a way to specify that some set of pod paragraphs go *after* the
> >      method listing
>
> an example of what you're wanting to do with this please. mainly out 
> of curiosity.

look at the Gtk2::TreeModel manpage.  the whole section on how to 
derive new models comes before the method, signal, and property 
listings; the method listing is more generally useful in this instance, 
and should precede the more esoteric information (so you don't have to 
scroll through descriptions of ten ALL_CAPS_METHODS to get to the 
listing of public model methods).

similarly for Gtk2::CellRenderer.

i could be wrong about this; i'd like to have more eyes on the pages, 
but my gut tells me this is how it needs to be.

(for the sake of opening the discussion to others, i'm hoping to get 
the 1.034 releases made this evening so you can see these particular 
pages.)



--
"it's hard to be eventful when you have this much style."
   - me, rationalizing yet another night of sitting at home.