[asterisk-doc] r3 - // /en/config/ /en/reference/general/ /en/reference/general/functions/ /...

Peter Beckman beckman at purplecow.com
Thu May 4 07:22:12 MST 2006


On Wed, 3 May 2006, Russell Bryant wrote:

> commits at digium.com wrote:
>> +<refentry id="function.vmauthenticate">
>
> As has been suggested multiple times already, you should *really* start
> using the term "application" in this documentation before you get much
> further.  We have another entity in asterisk called dialplan functions
> which are completely different from applications.  Use of the term
> "function" in this context is bound to cause mass confusion.

  You did, and it was noted.  Unfortunately there is a lot of code wrapped
  up around the name function and I fear that trying to figure out how to
  rename them will slow the implementation of documentation.  Since
  "function" only exists in the ID name and the URL name, I decided to fix
  that later, since the change could be automated, and only exists within
  the application documentation in a single place.

  I'm hoping that someone will come forward to tinker with the internals of
  how the documentation is auto-generated (function/application indexes are
  automatically generated rather than manually, and I don't want to muck it
  up at this point).

Beckman
---------------------------------------------------------------------------
Peter Beckman                                                  Internet Guy
beckman at purplecow.com                             http://www.purplecow.com/
---------------------------------------------------------------------------


More information about the asterisk-doc mailing list