Module: sip-router
Branch: janakj/mysql
Commit: 949364089c4b64ed6221bc20854491b1e89f80b7
URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=9493640…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: Fri Mar 7 18:19:45 2008 +0000
- modules documentation migrated from sgml to xml docbook format
- many thanks to Edson <4lists (at) gmail (dot) com> for providing script to replace headers and rename files
- contact updated
- follows re-sync with todays changes and update of Makefile to generate README and html files from XML
git-svn-id: https://openser.svn.sourceforge.net/svnroot/openser/trunk@3886 689a6050-402a-0410-94f2-e92a70836424
---
modules/db_mysql/km_README | 65 ++++++++++++++------
.../km_doc/{db_mysql.sgml => db_mysql.xml} | 22 +++----
.../{db_mysql_user.sgml => db_mysql_admin.xml} | 0
3 files changed, 56 insertions(+), 31 deletions(-)
diff --git a/modules/db_mysql/km_README b/modules/db_mysql/km_README
index 69101ff..cae7ce3 100644
--- a/modules/db_mysql/km_README
+++ b/modules/db_mysql/km_README
@@ -2,16 +2,18 @@ mysql Module
Daniel-Constantin Mierla
- voice-system.ro
-
Edited by
Daniel-Constantin Mierla
Copyright � 2006 voice-system.ro
+ Revision History
+ Revision $Revision$ $Date: 2008-03-04 15:15:47 +0200
+ (Tue, 04 Mar 2008) $
__________________________________________________________
Table of Contents
+
1. User's Guide
1.1. Overview
@@ -29,11 +31,13 @@ Daniel-Constantin Mierla
1.4. Exported Functions
1.5. Installation
+ 2. Frequently Asked Questions
+
List of Examples
- 1-1. Set ping_interval parameter
- 1-2. Set timeout_interval parameter
- 1-3. Set auto_reconnect parameter
- __________________________________________________________
+
+ 1.1. Set ping_interval parameter
+ 1.2. Set timeout_interval parameter
+ 1.3. Set auto_reconnect parameter
Chapter 1. User's Guide
@@ -41,25 +45,20 @@ Chapter 1. User's Guide
This is a module which provides MySQL connectivity for OpenSER.
It implements the DB API defined in OpenSER.
- __________________________________________________________
1.2. Dependencies
1.2.1. OpenSER Modules
The following modules must be loaded before this module:
-
* No dependencies on other OpenSER modules.
- __________________________________________________________
1.2.2. External Libraries or Applications
The following libraries or applications must be installed
before running OpenSER with this module loaded:
-
* libmysqlclient-dev - the development libraries of
mysql-client.
- __________________________________________________________
1.3. Exported Parameters
@@ -70,11 +69,10 @@ Chapter 1. User's Guide
Default value is 300 (5 min).
- Example 1-1. Set ping_interval parameter
+ Example 1.1. Set ping_interval parameter
...
modparam("db_mysql", "ping_interval", 600)
...
- __________________________________________________________
1.3.2. timeout_interval (integer)
@@ -89,11 +87,10 @@ modparam("db_mysql", "ping_interval", 600)
Default value is 2 (6 sec).
- Example 1-2. Set timeout_interval parameter
+ Example 1.2. Set timeout_interval parameter
...
modparam("db_mysql", "timeout_interval", 2)
...
- __________________________________________________________
1.3.3. auto_reconnect (integer)
@@ -102,26 +99,56 @@ modparam("db_mysql", "timeout_interval", 2)
Default value is 1 (1 - on / 0 - off).
- Example 1-3. Set auto_reconnect parameter
+ Example 1.3. Set auto_reconnect parameter
...
modparam("auto_reconnect", "auto_reconnect", 0)
...
- __________________________________________________________
1.4. Exported Functions
No function exported to be used from configuration file.
- __________________________________________________________
1.5. Installation
Because it dependes on an external library, the mysql module is
not compiled and installed by default. You can use one of the
next options.
-
* - edit the "Makefile" and remove "db_mysql" from
"excluded_modules" list. Then follow the standard procedure
to install OpenSER: "make all; make install".
* - from command line use: 'make all
include_modules="db_mysql"; make install
include_modules="db_mysql"'.
+
+Chapter 2. Frequently Asked Questions
+
+ 2.1.
+
+ Where can I find more about OpenSER?
+
+ Take a look at http://openser.org/.
+
+ 2.2.
+
+ Where can I post a question about this module?
+
+ First at all check if your question was already answered on one
+ of our mailing lists:
+ * User Mailing List -
+ http://openser.org/cgi-bin/mailman/listinfo/users
+ * Developer Mailing List -
+ http://openser.org/cgi-bin/mailman/listinfo/devel
+
+ E-mails regarding any stable OpenSER release should be sent to
+ <users(a)openser.org> and e-mails regarding development versions
+ should be sent to <devel(a)openser.org>.
+
+ If you want to keep the mail private, send it to
+ <team(a)openser.org>.
+
+ 2.3.
+
+ How can I report a bug?
+
+ Please follow the guidelines provided at:
+ http://sourceforge.net/tracker/?group_id=139143.
diff --git a/modules/db_mysql/km_doc/db_mysql.sgml b/modules/db_mysql/km_doc/db_mysql.xml
similarity index 56%
rename from modules/db_mysql/km_doc/db_mysql.sgml
rename to modules/db_mysql/km_doc/db_mysql.xml
index 509e408..eb12501 100644
--- a/modules/db_mysql/km_doc/db_mysql.sgml
+++ b/modules/db_mysql/km_doc/db_mysql.xml
@@ -1,11 +1,13 @@
-<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook V4.2//EN" [
+<?xml version="1.0" encoding='ISO-8859-1'?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
-<!ENTITY user SYSTEM "db_mysql_user.sgml">
-<!ENTITY faq SYSTEM "../../../doc/module_faq.sgml">
+<!ENTITY user SYSTEM "db_mysql_admin.xml">
+<!ENTITY faq SYSTEM "../../../doc/module_faq.xml">
<!-- Include general documentation entities -->
-<!ENTITY % docentities SYSTEM "../../../doc/entities.sgml">
+<!ENTITY % docentities SYSTEM "../../../doc/entities.xml">
%docentities;
]>
@@ -18,19 +20,15 @@
<author>
<firstname>Daniel-Constantin</firstname>
<surname>Mierla</surname>
- <affiliation><orgname>&voicesystem;</orgname></affiliation>
<address>
- <email>daniel(a)voice-system.ro</email>
- <otheraddr>
- <ulink url="http://www.voice-system.ro">http://www.voice-system.ro</ulink>
- </otheraddr>
+ <email>miconda(a)gmail.com</email>
</address>
</author>
<editor>
<firstname>Daniel-Constantin</firstname>
<surname>Mierla</surname>
<address>
- <email>danile(a)voice-system.ro</email>
+ <email>miconda(a)gmail.com</email>
</address>
</editor>
</authorgroup>
@@ -40,8 +38,8 @@
</copyright>
<revhistory>
<revision>
- <revnumber>$Revision$</revnumber>
- <date>$Date$</date>
+ <revnumber>$Revision: 3839 $</revnumber>
+ <date>$Date: 2008-03-04 15:15:47 +0200 (Tue, 04 Mar 2008) $</date>
</revision>
</revhistory>
</bookinfo>
diff --git a/modules/db_mysql/km_doc/db_mysql_user.sgml b/modules/db_mysql/km_doc/db_mysql_admin.xml
similarity index 100%
rename from modules/db_mysql/km_doc/db_mysql_user.sgml
rename to modules/db_mysql/km_doc/db_mysql_admin.xml
Module: sip-router
Branch: janakj/mysql
Commit: 6043e412ff51d1c45723a3a4f5fa6f363a54edee
URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=6043e41…
Author: Henning Westerholt <henning.westerholt(a)1und1.de>
Committer: Henning Westerholt <henning.westerholt(a)1und1.de>
Date: Tue Mar 4 13:15:47 2008 +0000
- change module docs FAQ link to a common one in the doc dir
- remove module specific FAQ content from the file in doc, this way no FAQ
content will be created
- credits for the patch/ the change scripts goes to Edson Gellert Schubert,
4lists at gmail dot com
- update all READMEs, for most module docs the FAQ and devel information were
now removed
git-svn-id: https://openser.svn.sourceforge.net/svnroot/openser/trunk@3839 689a6050-402a-0410-94f2-e92a70836424
---
modules/db_mysql/km_README | 42 ----------------------------
modules/db_mysql/km_doc/db_mysql.sgml | 4 +--
modules/db_mysql/km_doc/db_mysql_user.sgml | 3 +-
3 files changed, 2 insertions(+), 47 deletions(-)
diff --git a/modules/db_mysql/km_README b/modules/db_mysql/km_README
index fa0b7be..69101ff 100644
--- a/modules/db_mysql/km_README
+++ b/modules/db_mysql/km_README
@@ -29,9 +29,6 @@ Daniel-Constantin Mierla
1.4. Exported Functions
1.5. Installation
- 2. Developer's Guide
- 3. Frequently Asked Questions
-
List of Examples
1-1. Set ping_interval parameter
1-2. Set timeout_interval parameter
@@ -128,42 +125,3 @@ modparam("auto_reconnect", "auto_reconnect", 0)
* - from command line use: 'make all
include_modules="db_mysql"; make install
include_modules="db_mysql"'.
- __________________________________________________________
-
-Chapter 2. Developer's Guide
-
- The module does not provide any API to use in other OpenSER
- modules.
- __________________________________________________________
-
-Chapter 3. Frequently Asked Questions
-
- 3.1. Where can I find more about OpenSER?
- 3.2. Where can I post a question about this module?
- 3.3. How can I report a bug?
-
- 3.1. Where can I find more about OpenSER?
-
- Take a look at http://openser.org/.
-
- 3.2. Where can I post a question about this module?
-
- First at all check if your question was already answered on one
- of our mailing lists:
-
- * User Mailing List -
- http://openser.org/cgi-bin/mailman/listinfo/users
- * Developer Mailing List -
- http://openser.org/cgi-bin/mailman/listinfo/devel
-
- E-mails regarding any stable OpenSER release should be sent to
- <users(a)openser.org> and e-mails regarding development versions
- should be sent to <devel(a)openser.org>.
-
- If you want to keep the mail private, send it to
- <team(a)openser.org>.
-
- 3.3. How can I report a bug?
-
- Please follow the guidelines provided at:
- http://sourceforge.net/tracker/?group_id=139143.
diff --git a/modules/db_mysql/km_doc/db_mysql.sgml b/modules/db_mysql/km_doc/db_mysql.sgml
index f98b20c..509e408 100644
--- a/modules/db_mysql/km_doc/db_mysql.sgml
+++ b/modules/db_mysql/km_doc/db_mysql.sgml
@@ -2,8 +2,7 @@
<!ENTITY user SYSTEM "db_mysql_user.sgml">
-<!ENTITY devel SYSTEM "db_mysql_devel.sgml">
-<!ENTITY faq SYSTEM "db_mysql_faq.sgml">
+<!ENTITY faq SYSTEM "../../../doc/module_faq.sgml">
<!-- Include general documentation entities -->
<!ENTITY % docentities SYSTEM "../../../doc/entities.sgml">
@@ -49,7 +48,6 @@
<toc></toc>
&user;
- &devel;
&faq;
</book>
diff --git a/modules/db_mysql/km_doc/db_mysql_user.sgml b/modules/db_mysql/km_doc/db_mysql_user.sgml
index 077976e..60f4eab 100644
--- a/modules/db_mysql/km_doc/db_mysql_user.sgml
+++ b/modules/db_mysql/km_doc/db_mysql_user.sgml
@@ -1,8 +1,7 @@
<!-- Module User's Guide -->
<chapter>
- <chapterinfo>
- </chapterinfo>
+
<title>User's Guide</title>
<section>
Module: sip-router
Branch: janakj/mysql
Commit: 00453076cf25097d389598e7e0215f9247959428
URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=0045307…
Author: Henning Westerholt <henning.westerholt(a)1und1.de>
Committer: Henning Westerholt <henning.westerholt(a)1und1.de>
Date: Wed Feb 27 13:53:33 2008 +0000
- first round of cleanups for documentation
- remove all FAQ and DEVEL files considered empty in content (no content at all
or just the default lines)
- remove of the <RevHistory>/</RevHistory> tag (and of course anything between
them)
- remove the comments at the end of the file that begins with
"<!-- Keep this element at the end of the file"
- credits for the patch/ the change scripts goes to Edson Gellert Schubert,
4lists at gmail dot com
git-svn-id: https://openser.svn.sourceforge.net/svnroot/openser/trunk@3769 689a6050-402a-0410-94f2-e92a70836424
---
modules/db_mysql/km_doc/db_mysql_devel.sgml | 22 --------
modules/db_mysql/km_doc/db_mysql_faq.sgml | 70 ---------------------------
modules/db_mysql/km_doc/db_mysql_user.sgml | 11 ----
3 files changed, 0 insertions(+), 103 deletions(-)
diff --git a/modules/db_mysql/km_doc/db_mysql_devel.sgml b/modules/db_mysql/km_doc/db_mysql_devel.sgml
deleted file mode 100644
index ec8667a..0000000
--- a/modules/db_mysql/km_doc/db_mysql_devel.sgml
+++ /dev/null
@@ -1,22 +0,0 @@
-<!-- Module Developer's Guide -->
-
-<chapter>
- <chapterinfo>
- <revhistory>
- <revision>
- <revnumber>$Revision$</revnumber>
- <date>$Date$</date>
- </revision>
- </revhistory>
- </chapterinfo>
- <title>Developer's Guide</title>
- <para>
- The module does not provide any <acronym>API</acronym> to use in other &ser; modules.
- </para>
-</chapter>
-
-<!-- Keep this element at the end of the file
-Local Variables:
-sgml-parent-document: ("db_mysql.sgml" "book" "chapter")
-End:
--->
diff --git a/modules/db_mysql/km_doc/db_mysql_faq.sgml b/modules/db_mysql/km_doc/db_mysql_faq.sgml
deleted file mode 100644
index 526bfb2..0000000
--- a/modules/db_mysql/km_doc/db_mysql_faq.sgml
+++ /dev/null
@@ -1,70 +0,0 @@
-<!-- Module FAQ -->
-
-<chapter>
- <chapterinfo>
- <revhistory>
- <revision>
- <revnumber>$Revision$</revnumber>
- <date>$Date$</date>
- </revision>
- </revhistory>
- </chapterinfo>
- <title>Frequently Asked Questions</title>
- <qandaset defaultlabel="number">
- <qandaentry>
- <question>
- <para>Where can I find more about OpenSER?</para>
- </question>
- <answer>
- <para>
- Take a look at &serhomelink;.
- </para>
- </answer>
- </qandaentry>
- <qandaentry>
- <question>
- <para>Where can I post a question about this module?</para>
- </question>
- <answer>
- <para>
- First at all check if your question was already answered on one of
- our mailing lists:
- </para>
- <itemizedlist>
- <listitem>
- <para>User Mailing List - &seruserslink;</para>
- </listitem>
- <listitem>
- <para>Developer Mailing List - &serdevlink;</para>
- </listitem>
- </itemizedlist>
- <para>
- E-mails regarding any stable &ser; release should be sent to
- &serusersmail; and e-mails regarding development versions
- should be sent to &serdevmail;.
- </para>
- <para>
- If you want to keep the mail private, send it to
- &serhelpmail;.
- </para>
- </answer>
- </qandaentry>
- <qandaentry>
- <question>
- <para>How can I report a bug?</para>
- </question>
- <answer>
- <para>
- Please follow the guidelines provided at:
- &serbugslink;.
- </para>
- </answer>
- </qandaentry>
- </qandaset>
-</chapter>
-
-<!-- Keep this element at the end of the file
-Local Variables:
-sgml-parent-document: ("db_mysql.sgml" "Book" "chapter")
-End:
--->
diff --git a/modules/db_mysql/km_doc/db_mysql_user.sgml b/modules/db_mysql/km_doc/db_mysql_user.sgml
index 403912e..077976e 100644
--- a/modules/db_mysql/km_doc/db_mysql_user.sgml
+++ b/modules/db_mysql/km_doc/db_mysql_user.sgml
@@ -2,12 +2,6 @@
<chapter>
<chapterinfo>
- <revhistory>
- <revision>
- <revnumber>$Revision$</revnumber>
- <date>$Date$</date>
- </revision>
- </revhistory>
</chapterinfo>
<title>User's Guide</title>
@@ -149,8 +143,3 @@ modparam("auto_reconnect", "auto_reconnect", 0)
</section>
</chapter>
-<!-- Keep this element at the end of the file
-Local Variables:
-sgml-parent-document: "db_mysql.sgml" "Book" "chapter")
-End:
--->