Re: Fwd: API documentation for beginners

[Bao Niu <niubao56 gmail com>]

Thank you very much Steffen. It helps clarify my confusion which is not so easy to be solved by trial and error. I really appreciate it.

I am seriously considering devoting some time to write a PDF user's guide that is designed for new users, a more hand-holding one( after I master it of course, or otherwise it won't be helpful:). I love Dia. I fills perfectly a niche. However I found current documentation is more or less a little too terse, sometimes leaving a new users not one hundred percent sure about his/her understanding.

I think a easy-to-follow documentation will significantly enlarge the user base, and hopefully more attention will lead to more resources being devoted to improve it in future, and make it a even better more powerful tool. Thanks.

On Thu, Jun 20, 2013 at 3:58 AM, Steffen Macke <dia diagramr biz> wrote:

Hi Bao,

On 6/20/13 7:51 AM, Bao Niu wrote:

layers[0] vs. active_layer

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.

In this special case they're the same.
Depending on what you want to do with your code, the assumption that there's only one layer might
be a bit shaky, so active_layer might be a better choice for robust code. But of course, you may
have a worked out a complete different set of logic worked out to deal with your layers.

Regards,

Steffen

_______________________________________________
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