- obsolete files removed

doc/serfaq/db_faq.sgml

@@ -1,118 +0,0 @@
-<!-- $Id$ -->
-
-<chapter>
-    <title>Database Related Questions</title>
-    <qandaset>
-	<qandaentry>
-	    <question>
-		<simpara>
-		    Mar 10 16:46:33 ttalksvr /usr/sbin/ser[6592]: connect_db(): Can't connect to
-		    local MySQL server through socket '/var/lib/mysql/mysql.sock' (2)
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    Make sure your MySQL server is running.
-		</simpara>
-	    </answer>
-	</qandaentry>
-
-	<qandaentry>
-	    <question>
-		<simpara>
-		    I get the following error:
-		</simpara>
-		<screen format="linespecific">
-0(5164) db_init(): Error while trying to connect database
-0(5164) mod_init(): Error while connecting database
-0(5164) init_modules(): Error while initializing module usrloc
-</screen>
-		<simpara>
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    Modules using database have variable called db_url which contains username,
-		    password, hostname, and name of the database. Make sure the settings are
-		    correct. See module documentation for more information.
-		</simpara>
-	    </answer>
-	</qandaentry>
-
-	<qandaentry>
-	    <question>
-		<simpara>
-		    Does MySQL/Postgres/Whatever have to reside on localhost?
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    No.
-		    </simpara>
-	    </answer>
-	</qandaentry>
-
-	<qandaentry>
-	    <question>
-		<simpara>
-		    Why do I need a database ?
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    Many modules need the database. Authentication modules retrieve users'
-		    credentials from the database, user location module can be configured to store
-		    registered bindings into the database, accounting module can use database to
-		    store CDR and so on.
-		</simpara>
-	    </answer>
-	</qandaentry>
-	<qandaentry>
-	    <question>
-		<simpara>
-		    Which database engines are supported ?
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    Currently we support MySQL, Postgres and plaintext files.
-		</simpara>
-	    </answer>
-	</qandaentry>
-	
-	<qandaentry>
-	    <question>
-		<simpara>
-		    Which database engine should I use ?
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    That depends on your requirements. Performance aspects are probably not very
-		    important. The most stable and proven is MySQL module. Also serctl utility works
-		    well with this database.
-		</simpara>
-		<simpara>
-		    Another option is postgres support which was donated by Greg Fausak. The module
-		    still new and not that mature (read proven) yet. People using the module
-		    reported that it worked well.
-		</simpara>
-		<simpara>
-		    Last option is dbtext module which uses plaintext files to store the data. This
-		    module is somewhat experimental and shouldn't be used for any serious
-		    deployment. The module is quite slow, but it can fit well into small
-		    installations containing only a couple of users or demos where you need to change
-		    the content of the database often by hand.
-		</simpara>
-	    </answer>
-	</qandaentry>
-
-    </qandaset>
-</chapter>
-
-
-<!-- Keep this element at the end of the file
-Local Variables:
-sgml-parent-document: ("serfaq.sgml" "Book" "chapter")
-End:
--->

doc/serfaq/licensing_faq.sgml

@@ -1,33 +0,0 @@
-<!-- $Id$ -->
-
-<chapter>
-    <title>Licensing</title>
-    <qandaset>
-	<qandaentry>
-	    <question>
-		<simpara>
-		    Is the &sername; (&ser;) free ? Or do we need to pay ? Because my boss worry
-		    about that, please help me.
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    Yes, it is free. See
-		    <ulink url="http://cvs.berlios.de/cgi-bin/viewcvs.cgi/*checkout*/ser/sip_router/COPYING?rev=HEAD&amp;content-type=text/plain">
-			http://cvs.berlios.de/cgi-bin/viewcvs.cgi/*checkout*/ser/sip_router/COPYING?rev=HEAD&amp;content-type=text/plain
-		    </ulink>
-		</simpara>
-	    </answer>
-	</qandaentry>
-
-	
-
-    </qandaset>
-</chapter>
-
-
-<!-- Keep this element at the end of the file
-Local Variables:
-sgml-parent-document: ("serfaq.sgml" "Book" "chapter")
-End:
--->

doc/serfaq/serweb_faq.sgml

@@ -1,184 +0,0 @@
-<!-- $Id$ -->
-
-<chapter>
-    <title>SERWEB</title>
-    <qandaset>
-	<qandaentry>
-	    <question>
-		<simpara>
-		    Is there <quote>send IM</quote> page for sending instant messages only or does
-		    it accept replies as well (i.e. does it act like a full &ua;) ?
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    It can send messages only.
-		</simpara>
-	    </answer>
-	</qandaentry>
-	
-	<qandaentry>
-	    <question>
-		<simpara>
-		    I have serweb running. I'm able to connect to <acronym>MySQL</acronym> fine. But
-		    it doesn't seem like the form params are getting assigned to variables. Is there
-		    something obvious I'm missing?
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    Please check if <varname>register_globals</varname> is set to On in your
-		    <filename>php.ini</filename> file. The option is set off by default due to
-		    security reasons.
-		</simpara>
-	    </answer>
-	</qandaentry>
-	
-	<qandaentry>
-	    <question>
-		<simpara>
-		    Can somebody tell me how to configure the serweb? Which directory should I put
-		    those files and which file and parameters should I modify. Or maybe this
-		    question was asked previously by somebody already, then please provide me a like
-		    to those answers.
-		</simpara>
-	</question>
-	    <answer>
-		<simpara>
-		    Dan Austin's HOWTO (see &ser; webpage) is probably the currently most extensive
-		    documentation available.
-		</simpara>
-	    </answer>
-	</qandaentry>
-	
-	<qandaentry>
-	    <question>
-		<simpara>
-		    Trying to load the serweb page I get the following error message: Fatal error:
-		    Call to undefined function: mysql_pconnect() in
-		    /var/www/html/phplib/db_mysql.inc on line 73
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    Configure <acronym>PHP</acronym> to load the MySQL extension.
-		</simpara>
-	    </answer>
-	</qandaentry>
-	
-	<qandaentry>
-	    <question>
-		<simpara>
-		    I can open the page and even make changes and save them, but I'm receiving the
-		    following warning message: Warning: fopen(<quote>/tmp/ser_fifo</quote>,
-		    <quote>w</quote>) ? Permission denied in /var/www/html/serweb/functions.php on
-		    line 172 Sorry - cannot open fifo.
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    Make sure that the user under which the web server is running has read and write
-		    access to the <acronym>FIFO</acronym>.
-		</simpara>
-	    </answer>
-	</qandaentry>
-    
-	<qandaentry>
-	    <question>
-		<simpara>
-		    Is there a way to add/edit/view aliases from serweb?
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    When new user confirm registration, new numeric alias is created. There is no
-		    another way to add or edit aliases from serweb.
-		</simpara>
-	    </answer>
-	</qandaentry>
-	
-	<qandaentry>
-	    <question>
-		<simpara>
-		    I am getting a <quote>Forbidden</quote> reply from the Apache. The Apache is
-		    pointing to the index.php for the serweb. I've only changed the &ip; address of
-		    the local host to 127.0.0.1 in the config.php. Does anyone have any suggestions
-		    ?
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    Check if the file/folder has read permission for everybody.
-		</simpara>
-	    </answer>
-	</qandaentry>
-
-	<qandaentry>
-	    <question>
-		<simpara>
-		    I get following warnings and error on NetBSD when I call
-		    user_interface/index.php:
-		    </simpara>
-		<simpara>
-		    [Wed Jul 16 09:56:53 2003] [error] PHP Warning: Call-time pass-by-reference has
-		    been deprecated - argument passed by value; If you would like to pass it by
-		    reference, modify the declaration of [runtime function name]().  If you would
-		    like to enable call-time pass-by-reference, you can set
-		    allow_call_time_pass_reference to true in your INI file.  However, future
-		    versions may not support this any longer.  in
-		    /usr/pkg/share/httpd/htdocs/iptel/phplib/user.inc on line 72 [Wed Jul 16
-		    09:56:53 2003] [error] PHP Fatal error: Call to undefined function:
-		    mysql_pconnect() in /usr/pkg/share/httpd/htdocs/iptel/phplib/db_mysql.inc on
-		    line 73
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    Simply do what the text says: enable allow_call_time_pass_reference in
-		    <filename>/usr/pkg/etc/php.ini</filename> and install <acronym>PHP</acronym>
-		    MySQL support.
-		</simpara>
-	    </answer>
-	</qandaentry>
-	
-	<qandaentry>
-	    <question>
-		<simpara>
-		    I started the webserver and got the following message: Starting up of httpd:
-		    [Thu Aug 14 15:16:51 2003] alert ] httpd: Could not determine the of server
-		    fully qualified domain name, using 127.0.0.1 for ServerName 
-		</simpara>
-		<simpara>
-		    Does anyone know where is the problem ?
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    Set ServerName variable in the configuration file of your webserver to hostname
-		    of your computer.
-		</simpara>
-	    </answer>
-	</qandaentry>
-	<qandaentry>
-	    <question>
-		<simpara>
-		    What version of ser should I use with serweb from the CVS ?
-		</simpara>
-	    </question>
-	    <answer>
-		<simpara>
-		    CVS version of serweb is aligned to the stable branch of ser. It will not work
-		    with ser 0.8.10 because the database tables have been changed recently.
-		</simpara>
-	    </answer>
-	</qandaentry>
-
-    </qandaset>
-</chapter>
-
-
-<!-- Keep this element at the end of the file
-Local Variables:
-sgml-parent-document: ("serfaq.sgml" "Book" "chapter")
-End:
--->

doc/template/module/module.sgml

@@ -1,53 +0,0 @@
-<!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook V4.2//EN" [
-
-
-<!ENTITY user SYSTEM "module_user.sgml">
-<!ENTITY devel SYSTEM "module_devel.sgml">
-<!ENTITY faq SYSTEM "module_faq.sgml">
-
-<!-- Include general SER documentation entities -->
-<!ENTITY % serentities SYSTEM "../../ser_entities.sgml">
-%serentities;
-
-]>
-
-<book>
-    <bookinfo>
-	<title>Module's Name</title>
-	<productname class="trade">&sername;</productname>
-	<authorgroup>
-	    <author>
-		<firstname>AuthorFirstname</firstname>
-		<surname>AuthorLastname</surname>
-		<affiliation><orgname>Organization Name</orgname></affiliation>
-		<address>
-		    <email>[email protected]</email>
-		</address>
-	    </author>
-	    <editor>
-		<firstname>EditorFirstname</firstname>
-		<surname>EditorLastname</surname>
-		<address>
-		    <email>[email protected]</email>
-		</address>
-	    </editor>
-	</authorgroup>
-	<copyright>
-	    <year>2003</year>
-	    <year>2004</year>
-	    <holder>Fill in here</holder>
-	</copyright>
-	<revhistory>
-	    <revision>
-		<revnumber>$Revision$</revnumber>
-		<date>$Date$</date>
-	    </revision>
-	</revhistory>
-    </bookinfo>
-    <toc></toc>
-    
-    &user;
-    &devel;
-    &faq;
-    
-</book>

doc/template/module/module_devel.sgml

@@ -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 sort of API to use in other SER modules.
-    </para>
-</chapter>
-
-<!-- Keep this element at the end of the file
-Local Variables:
-sgml-parent-document: ("module.sgml" "book" "chapter")
-End:
--->

doc/template/module/module_faq.sgml

@@ -1,67 +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 &ser;?</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>&seruserslink;</para>
-		    </listitem>
-		    <listitem>
-			<para>&serdevlink;</para>
-		    </listitem>
-		</itemizedlist>
-		<para>
-		    E-mails regarding any stable version should be sent to &serusersmail; and e-mail
-		    regarding development versions or CVS snapshots should be send 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: ("module.sgml" "Book" "chapter")
-End:
--->

doc/template/module/module_user.sgml

@@ -1,110 +0,0 @@
-<!-- Module User's Guide -->
-
-<chapter>
-    <chapterinfo>
-	<revhistory>
-	    <revision>
-		<revnumber>$Revision$</revnumber>
-		<date>$Date$</date>
-	    </revision>
-	</revhistory>
-    </chapterinfo>
-    <title>User's Guide</title>
-    
-    <section>
-	<title>Overview</title>
-	<para>Module description</para>
-    </section>
-    <section>
-	<title>Dependencies</title>
-	<section>
-	    <title>&ser; Modules</title>
-	    <para>
-		The following modules must be loaded before this module:
-	    	<itemizedlist>
-		    <listitem>
-			<para>
-			    <emphasis>No dependencies on other &ser; modules</emphasis>.
-			</para>
-		    </listitem>
-	    	</itemizedlist>
-	    </para>
-	</section>
-	<section>
-	    <title>External Libraries or Applications</title>
-	    <para>
-		The following libraries or applications must be installed before running
-		&ser; with this module loaded:
-	    	<itemizedlist>
-		    <listitem>
-			<para>
-			    <emphasis>None</emphasis>.
-			</para>
-		    </listitem>
-	    	</itemizedlist>
-	    </para>
-	</section>
-    </section>
-    <section>
-	<title>Exported Parameters</title>
-	<section>
-	    <title><varname>param_name</varname> (param_type)</title>
-	    <para>
-		Param description.
-	    </para>
-	    <para>
-		<emphasis>
-		    Default value is <quote>value</quote>.
-		</emphasis>
-	    </para>
-	    <example>
-		<title>Set <varname>param_name</varname> parameter</title>
-		<programlisting format="linespecific">
-...
-modparam("module", "param_name", "param_value")
-...
-</programlisting>
-	    </example>
-	</section>
-    </section>
-    <section>
-	<title>Exported Functions</title>
-	<section>
-	    <title>
-		<function moreinfo="none">function_name(param1, param2)</function>
-	    </title>
-	    <para>
-		Description
-	    </para>
-	    <para>Meaning of the parameters is as follows:</para>
-	    <itemizedlist>
-		<listitem>
-		    <para><emphasis>param1</emphasis> - description.
-		    </para>
-		</listitem>
-		<listitem>
-		    <para><emphasis>param2</emphasis> - description.
-		    </para>
-		</listitem>
-	    </itemizedlist>
-	    <example>
-		<title><function>function_name</function> usage</title>
-		<programlisting format="linespecific">
-...
-function_name("sample_param1", "sample_param2");
-...
-</programlisting>
-	    </example>
-	</section>
-    </section>
-    <section>
-	<title>Installation & Running</title>
-	<para>Notes about installation and running.</para>
-    </section>
-</chapter>
-
-<!-- Keep this element at the end of the file
-Local Variables:
-sgml-parent-document: ("module.sgml" "Book" "chapter")
-End:
--->