XAutoTextContainer.insertNewByName() accepts a group name in the form "name" +
"*" + pathentrynumber, where pathentrynumber describes where the autotext is to
be stored. This is not properly documented. Right now the only trace of
documentation is in an Example subsection of XAutoTextContainer, which is, due
to spelling and markup mistakes, a pain to look at (and I consequently
overlooked it). It's also lacking any kind of context (e.g. what is
"AutoTextPath" ?).

I'd like the documentation improved in the following ways

1) document the groupname + "*" + number syntax at insertNewByName(). When
people use the IDL docs for reference purposes to look for information about the
parameter for a function call, they don't look in some Example subsection
elsewhere on the page. The doc needs to be together with the function call.

2) Document precisely (or link to the documentation, probably
PathSettings#AutoText) how the AutoTextPath that the number component refers to
is formed. It is apparently not simply the path found in
Tools/Options/Paths/AutoText. In my case that path lists only 1 component,
namely my local user directory. However using *0 doesn't work in my basic macro,
presumably because the shared location (to which a normal user account doesn't
have write access) is implicitly added in the front of the path. 

Related to this: the documentation to PathSettings#AutoText could be improved to
state that this is not identical to what you can configure in
Tools/Options/Paths, because PathSettings#AutoText contains the shared section
as 1st element, which is not visible in Tools/Options/Paths. The documentation
of PathSettings#AutoText should state, where this path is taken from.

3) Document the recommended way for a program to determine the proper "*" number
value. At the moment, apart from analysing PathSettings#AutoText to find a
directory that the user has write access to, I don't see how I'm supposed to
determine the correct number. Is this the only way?

Related: Please state clearly that leaving the * number out will usually NOT
work portably. It's likely to work under Windows (where users commonly have
administrator rights), but on Unix machines the shared location (implict first
element of path, used in absence of * number) is not writable by users. So when
one wants to use insertNewByName reliably, one MUST provide a * number with
number > 0.

4) Fix the markup issues in the example subsection and present working Basic
example code or at least give some context.