integer llCreateLink(key id)

would be nice if llCreateLink returned the link number of the object it just linked in.

What happens when you link two objects together:

When linking an object, say, Object A, to another, Object B, Object A's parent prim is assigned link number 2. All of Object A's children's link numbers are incrimented and added to the set (the Link#2 of Object A, becomes the link#3 of Object B). All previous links that Object B had are basicly pushed back the number of prims that object A was composed of. (Lets say Object B is a link set of 2 prims, and Object A is a link set of 2 prims. When object A is linked to object B, object A's parent prim is assigned link number 2, object A's child prim is assigned link number 3, and the child prim of object B is pushed back in link number, from link number 2 before the linking to link number 4 after.

Example:

Before Linking:

Object A's links:
1, 2

Object B's links:
1, 2

Object A is linked to B.
Object B's new links:

1, 2, 3, ,4

IMO, this is more complicated then simply appending the new prims to the set. However, because the current implementation is more complicated to program (I think), there had to be a good reason for it.

Reply:
The main reason why this suggestion wont work well, is that you can link multi prim objects to your object. Returning one integer only tells a small part of the story. Perhaps returning a list would be better.

==Chris