[asterisk-dev] XML documentation of apps/functions/the_rest_of_the_world

[Michiel van Baak]

On 17:11, Fri 11 Jul 08, Tilghman Lesher wrote:
> On Friday 11 July 2008 16:07:11 Brandon Kruse wrote:
> > >----- Original Message -----
> > >From: "Tzafrir Cohen" <tzafrir.cohen at xorcom.com>
> > >Suppose the application Foo in our documentation takes no parameters.
> > >Now I unload the standard module and load a module that includes Foo()
> > >that has two parameters. When and how will the application metadata in
> > >Astrisk be invalidated?
> >
> > So you are saying you have an app, for example, that registers "Dial", then
> > you unload app_dial, and load app_thisisstupid.so, which registers
> > application Dial.
> >
> > First of all, I do not see how that would EVER happen, and why you would
> > want to have such confusion. Second of all, the app_thisisstupid.so does
> > NOT use ast_register_application_xml, it will just use
> > app_register_application, like a normal app.
> >
> > If you really wanted to do this (which I, will not), you could have one app
> > be part of 'core' and one of them be a 'third party app'
> >
> > I would hope you would want to have these conflicts figured out before
> > hand.
> 
> A very real situation is someone unloading the app_stack.so from 1.4 and
> loading the app_stack.so module backport from svncommunity.  The backport
> is desireable, because it has more features.  The documentation and argument
> syntax both differ.  How would you accommodate this situation?

Good point.

Maybe something like <Application name="Dial" core="yes">
All stuff in the digium official tree should have this core flag so it
will read the docs out of core-$lang.xml
If this is not set, it will try to look for an <Application name="Dial">
tag in one of the extra xml files in the doc/ directory.

How about that ?
-- 

Michiel van Baak
michiel at vanbaak.eu
http://michiel.vanbaak.eu
GnuPG key: http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x71C946BD

"Why is it drug addicts and computer aficionados are both called users?"