Re: Fwd: API documentation for beginners

[Bao Niu <niubao56 gmail com>]

Hi Hans,

Thank you for your immediate response.

I'm afraid I didn't emphasize my question enough here, my question was:

layers[0] vs. active_layer

not

layers vs. active_layer.

I know the difference between the list and a single item, but if there is only one layers item and I chose the first indexed item(layers[0]), does it automatically refer to the same object that referred to by active_layer? Or it refers to something that only resides in memory and not being rendered yet? That why I asked if the two are the same.

I did do my research through your archive list but didn't find anything.

On Wed, Jun 19, 2013 at 3:52 PM, Hans Breuer <hans breuer org> wrote:

At 19.06.2013 21:19, Bao Niu wrote:

Hi there. I'm learning Dia python scripting and very interested in it.
However I found the current documentation for APIs is a little too terse,
only meant for those who are in the knows. For example I couldn't find any
piece of information on the difference between layers[0] vs active_layers.

Just looked up in the current documentation. It has:

active_layer
    Layer currently active in the diagram.

layers
    Read-only list of the diagrams layers.

Is there any documentation of API that is more detailed, better tailored
for beginners?

I'm not aware of more detailed API documentation. And I'm uncertain what would be necessary in this regard. At least I consider explaning the difference between a list and a single item to be out of scope for Dia.

Regards,
        Hans

-------- Hans "at" Breuer "dot" Org -----------
Tell me what you need, and I'll tell you how to
get along without it.                -- Dilbert
_______________________________________________
dia-list mailing list
dia-list gnome org
https://mail.gnome.org/mailman/listinfo/dia-list
FAQ at http://live.gnome.org/Dia/Faq
Main page at http://live.gnome.org/Dia