Re: Fwd: API documentation for beginners

2013-06-20 Thread Bao Niu
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

Re: Fwd: API documentation for beginners

2013-06-20 Thread Steffen Macke
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'r

Re: Fwd: API documentation for beginners

2013-06-19 Thread Bao Niu
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 ind

Re: Fwd: API documentation for beginners

2013-06-19 Thread Hans Breuer
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 be