Hello,

curious to see if it works with comments starting with #, because it's the common across kamailio configs or it needs to convert them to c-style alternatives ...

Cheers,
Daniel


On 20/10/16 11:49, José Seabra wrote:
Hi, Olle,
Thank you for your reply.
I will take your advice and try Doxygen :)

Thank you all.
BR
José Seabra

2016-10-20 10:36 GMT+01:00 Olle E. Johansson <oej@edvina.net>:
I imagine that you could use tools like Doxygen for this. Doxygen is something we use in
Kamailio to create developer docs - web pages that explains variables, functions and
takes data from comments with a special syntax.

Here’s one example:

There are several similar tools, like jdoc and perldoc.


/O

On 20 Oct 2016, at 10:33, José Seabra <joseseabra4@gmail.com> wrote:

Hello Daniel,
Thank you for your reply,
Can you advice one of these tools please? i will try it :)

BR
José Seabra

2016-10-20 10:18 GMT+01:00 Daniel-Constantin Mierla <miconda@gmail.com>:

Hello,

not aware of any such effort, but maybe tools that can be used to extract the documentation from a c code can be reused to some extent -- inside kamailio.cfg we support the c-style comments, both:

//

and

/*  */

If anyone tries, would be great to know the results.

Cheers,
Daniel


On 18/10/16 11:22, José Seabra wrote:
Hello there,
I'm sending this email in order to know if anyone had work or has any idea how we can generate Documentation from kamailio script using Comments?

This would be great because we could write comments explaining the Route method during  script development  and use it to generate documentation about our kamailio script, saving time and leave our deployment documented.


Thank you
--
Best Regards
José Seabra


_______________________________________________
SIP Express Router (SER) and Kamailio (OpenSER) - sr-users mailing list
sr-users@lists.sip-router.org
http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-users
-- 
Daniel-Constantin Mierla
http://twitter.com/#!/miconda - http://www.linkedin.com/in/miconda
Kamailio Advanced Training, Berlin, Oct 24-26, 2016 - http://www.asipto.com
_______________________________________________ SIP Express Router (SER) and Kamailio (OpenSER) - sr-users mailing list sr-users@lists.sip-router.org http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-users
--
Cumprimentos
José Seabra
_______________________________________________ SIP Express Router (SER) and Kamailio (OpenSER) - sr-users mailing list sr-users@lists.sip-router.org http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-users
_______________________________________________ SIP Express Router (SER) and Kamailio (OpenSER) - sr-users mailing list sr-users@lists.sip-router.org http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-users
--
Cumprimentos
José Seabra
_______________________________________________
SIP Express Router (SER) and Kamailio (OpenSER) - sr-users mailing list
sr-users@lists.sip-router.org
http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-users
-- 
Daniel-Constantin Mierla
http://twitter.com/#!/miconda - http://www.linkedin.com/in/miconda
Kamailio Advanced Training, Berlin, Oct 24-26, 2016 - http://www.asipto.com