sr-dev April 2009

sr-dev@lists.kamailio.org

13 participants
230 discussions

git:master: alias_db: added doc/Makefile

by Daniel-Constantin Mierla

Module: sip-router Branch: master Commit: 7028d27fd0d1f6802326ac78a1be5909f7ac7a68 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=7028d27… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Tue Apr 21 21:56:18 2009 +0200 alias_db: added doc/Makefile - makefile rules to generate documentation - entities.xml => kam_entities.xml - module_faq.xml => kam_module_faq.xml --- modules_k/alias_db/doc/Makefile | 40 +++++++++++++++++++++++++++++++++++ modules_k/alias_db/doc/alias_db.xml | 4 +- 2 files changed, 42 insertions(+), 2 deletions(-) diff --git a/modules_k/alias_db/doc/Makefile b/modules_k/alias_db/doc/Makefile new file mode 100644 index 0000000..5013ff7 --- /dev/null +++ b/modules_k/alias_db/doc/Makefile @@ -0,0 +1,40 @@ +# +# The list of documents to build (without extensions) +# +DOCUMENTS = alias_db + +# +# The root directory containing Makefile.doc +# +ROOT_DIR=../../.. + +# +# Validate docbook documents before generating output +# (may be slow) +# +#VALIDATE=1 + +# +# You can override the CSS used in generated +# HTML documents here +# +#HTML_CSS=/style/docbook.css + +# +# You can override the stylesheet used to generate +# xhtml documents here +# +#XHTML_XSL=$(ROOT_DIR)/doc/stylesheets/xhtml.xsl + +# +# You can override the stylesheet used to generate +# plain text documents here +# +#TXT_XSL=$(XHTML_XSL) + +# +# K documentation style +# +DOCBOOK_MODE=k + +include $(ROOT_DIR)/Makefile.doc diff --git a/modules_k/alias_db/doc/alias_db.xml b/modules_k/alias_db/doc/alias_db.xml index ba8e474..eabbf8f 100644 --- a/modules_k/alias_db/doc/alias_db.xml +++ b/modules_k/alias_db/doc/alias_db.xml @@ -3,12 +3,12 @@ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!ENTITY admin SYSTEM "alias_db_admin.xml"> -<!ENTITY faq SYSTEM "../../../doc/module_faq.xml"> +<!ENTITY faq SYSTEM "../../../doc/kam_module_faq.xml"> <!ENTITY aliasdbsql SYSTEM "alias_db.sql">  -<!ENTITY % docentities SYSTEM "../../../doc/entities.xml"> +<!ENTITY % docentities SYSTEM "../../../doc/kam_entities.xml"> %docentities; ]>

15 years, 7 months

git:master: auth: added doc/Makefile

by Daniel-Constantin Mierla

Module: sip-router Branch: master Commit: 11e41144f5e558bd2764372f2c61a915e10d5a20 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=11e4114… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Tue Apr 21 21:55:30 2009 +0200 auth: added doc/Makefile - makefile rules to generate documentation - entities.xml => kam_entities.xml - module_faq.xml => kam_module_faq.xml --- modules_k/auth/doc/Makefile | 40 ++++++++++++++++++++++++++++++++++++++++ modules_k/auth/doc/auth.xml | 4 ++-- 2 files changed, 42 insertions(+), 2 deletions(-) diff --git a/modules_k/auth/doc/Makefile b/modules_k/auth/doc/Makefile new file mode 100644 index 0000000..666ca2e --- /dev/null +++ b/modules_k/auth/doc/Makefile @@ -0,0 +1,40 @@ +# +# The list of documents to build (without extensions) +# +DOCUMENTS = auth + +# +# The root directory containing Makefile.doc +# +ROOT_DIR=../../.. + +# +# Validate docbook documents before generating output +# (may be slow) +# +#VALIDATE=1 + +# +# You can override the CSS used in generated +# HTML documents here +# +#HTML_CSS=/style/docbook.css + +# +# You can override the stylesheet used to generate +# xhtml documents here +# +#XHTML_XSL=$(ROOT_DIR)/doc/stylesheets/xhtml.xsl + +# +# You can override the stylesheet used to generate +# plain text documents here +# +#TXT_XSL=$(XHTML_XSL) + +# +# K documentation style +# +DOCBOOK_MODE=k + +include $(ROOT_DIR)/Makefile.doc diff --git a/modules_k/auth/doc/auth.xml b/modules_k/auth/doc/auth.xml index 588bd35..5d959de 100644 --- a/modules_k/auth/doc/auth.xml +++ b/modules_k/auth/doc/auth.xml @@ -3,10 +3,10 @@ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!ENTITY admin SYSTEM "auth_admin.xml"> -<!ENTITY faq SYSTEM "../../../doc/module_faq.xml"> +<!ENTITY faq SYSTEM "../../../doc/kam_module_faq.xml">  -<!ENTITY % docentities SYSTEM "../../../doc/entities.xml"> +<!ENTITY % docentities SYSTEM "../../../doc/kam_entities.xml"> %docentities; ]>

15 years, 7 months

git:master: docbook: added files used by K modules' docbook files

by Daniel-Constantin Mierla

Module: sip-router Branch: master Commit: 55447c0be3ca1ecefb1e2136904e53f8aac27ab6 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=55447c0… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Tue Apr 21 21:49:16 2009 +0200 docbook: added files used by K modules' docbook files --- doc/kam-module-docbook.css | 268 ++++++++++++++++++++++++++++++++++++++++++++ doc/kam_entities.xml | 77 +++++++++++++ 2 files changed, 345 insertions(+), 0 deletions(-) diff --git a/doc/kam-module-docbook.css b/doc/kam-module-docbook.css new file mode 100644 index 0000000..dc8d37d --- /dev/null +++ b/doc/kam-module-docbook.css @@ -0,0 +1,268 @@ +BODY { + padding: 20px; + margin: 5px 50px 5px 50px; + background: #ffffff; + color: #000000; + width: 700px; + border: solid 2px #888888; + font-family: Helvetica,Arial; +} + +P { + font-family: Helvetica,Arial; + font-size: 12; + text-align: justify; +} + +P.C2 { + COLOR: #ffffff ; + BACKGROUND-color: #a0a0d0; + BORDER: solid 1px #606090; + PADDING: 1px +} + +A { + color: #041fc5; + text-decoration: none; +} + +A:hover { + color: #990000; + text-decoration: underline; +} + +DIV.ABSTRACT { + border: solid 2px; + padding-left: 10pt; + padding-right: 10pt; +} +PRE.SCREEN { + font-family:monospace; + white-space: pre; + background-color: #fefeee; + border:solid; + color: #000000; + border-color: #99CCCC; + border-left: solid #99CCCC 1px; + border-right: solid #99CCCC 1px; + border-top: solid #99CCCC 1px; + border-bottom: solid #99CCCC 1px; + padding-left: 15pt; +} + +PRE.PROGRAMLISTING { + font-family:monospace; + white-space: pre; + background-color: #fefeee; + border:solid; + color: #000000; + border-color: #99CCCC; + border-left: solid #99CCCC 1px; + border-right: solid #99CCCC 1px; + border-top: solid #99CCCC 1px; + border-bottom: solid #99CCCC 1px; + padding-left: 15pt; +} + +H1 { + color: #000000; + border: solid 2px #a0a0a0; + background-color: #DCDCDC; + font-variant: small-caps; + font-size: 16; + padding-left: 5px; +} + +.TITLE a { + color: #000000; + text-decoration: none; +} + +.TITLE a:active { + color: #000000; + text-decoration: none; +} + +.TITLE a:visited { + color: #000000; + text-decoration: none; +} + +H2 { + COLOR: #000000 ; + font-style: italic; + border: solid 1px #b0b0b0; + background-color: #ECECEC; + padding-left: 5px; + font-family: Helvetica,Arial; + font-weight: bold; + font-size: 14; +} + +H2 a { + color: #000000; + text-decoration: none; +} + +H2 a:active { + color: #000000; + text-decoration: none; +} + +H2 a:visited { + color: #000000; + text-decoration: none; +} + +H2 a:hover { + color: #000000; + text-decoration: none; +} + +H3.SECTION { + COLOR: #000000 ; + font-style: italic; + border: solid 1px #c0c0c0; + background-color: #F2F2F2; + padding-left: 5px; + font-family: Helvetica,Arial; + font-weight: bold; + font-size: 13; +} + +H3 a { + color: #000000; + text-decoration: none; +} + +H3 a:active { + color: #000000; + text-decoration: none; +} + +H3 a:visited { + color: #000000; + text-decoration: none; +} + +H3 a:hover { + color: #000000; + text-decoration: none; +} + +H3.AUTHOR { + font-family: Helvetica,Arial; + font-weight: bold; + font-size: 13; +} + +H3.EDITOR { + font-family: Helvetica,Arial; + font-weight: bold; + font-style: italic; + font-size: 11; +} + +H4 { + font-family: Helvetica,Arial; + font-weight: bold; + font-size: 12; +} + +TABLE.IMPORTANT { + font-style:italic; + border: solid 2px #ff0000; + width: 70%; + margin-left: 15%; +} + +TABLE.CAUTION { + font-style:italic; + border: ridge 2px #ffff00; + width: 70%; + margin-left: 15%; +} + +TABLE.NOTE { + font-style:italic; + border: solid 1px #000000; + width: 70%; + margin-left: 15%; +} + +TABLE.TIP { + font-style:italic; + border: solid 1px #000000; + width: 70%; + margin-left: 15%; +} + +TABLE.WARNING { + font-style:italic; + font-weight: bold; + border: ridge 4px #ff0000; + width: 70%; + margin-left: 15%; +} + +DIV.VARIABLELIST { + font-family: sans-serif; + font-style: normal; + font-weight: normal; + padding-left: 20px; +} + +.VARLISTENTRY { + font-weight: bold; + margin-top: 10px; + COLOR: #ffffff ; + BACKGROUND-color: #a0a0d0; + BORDER: solid 1px #606090; + PADDING: 1px +} + +DIV.NAVFOOTER { + color: #000000; + background-color: #EFEFF8; + padding: 5px; + margin-top: 10px; + width: 100%; + border: thin solid #a0a0d0; +} + +DIV.NUKEFOOTER { + color: #000000; + background-color: #B0E0E6; + padding: 5px; + margin-top: 10px; + width: 100%; + border: thin solid #a0a0d0; +} + +DIV.NAVHEADER { + color: #000000; + background-color: #EFEFF8; + padding: 5px; + margin-bottom: 10px; + width: 100%; + border: thin solid #a0a0d0; +} + +DIV.SECT1,DIV.SECT2,DIV.SECT3 { + margin-left: 20px; +} + +DIV.EXAMPLE,DIV.TOC { + border: thin dotted #70AAE5; + padding-left: 10px; + padding-right: 10px; + color: #000000; + background-color: #EFF8F8; +} + +DIV.TOC { + margin-left: 20px; + margin-right: 20px; +} + + diff --git a/doc/kam_entities.xml b/doc/kam_entities.xml new file mode 100644 index 0000000..733c4cd --- /dev/null +++ b/doc/kam_entities.xml @@ -0,0 +1,77 @@ + + + + +<!ENTITY fhg "FhG FOKUS"> + +<!ENTITY kamailio "Kamailio"> +<!ENTITY kamailioname "Kamailio SIP Server Platform"> +<!ENTITY kamailioconfig "kamailio.cfg"> + +<!ENTITY kamwiki "http://www.kamailio.org/dokuwiki/"> +<!ENTITY kamwikilink "<ulink url='&kamwiki;'>&kamwiki;</ulink>"> + +<!ENTITY kamailiohome "http://www.kamailio.org/"> +<!ENTITY kamailiobugs "http://sourceforge.net/tracker/?group_id=139143"> +<!ENTITY kamailiohelp "http://lists.kamailio.org/cgi-bin/mailman/listinfo/team"> +<!ENTITY kamailiousers "http://lists.kamailio.org/cgi-bin/mailman/listinfo/users"> +<!ENTITY kamailiodev "http://lists.kamailio.org/cgi-bin/mailman/listinfo/devel"> +<!ENTITY kamailiodbdocs "http://www.kamailio.org/docs/db-tables/kamailio-db-devel.html"> + +<!ENTITY kamailiohomelink "<ulink url='&kamailiohome;'>&kamailiohome;</ulink>"> +<!ENTITY kamailiobugslink "<ulink url='&kamailiobugs;'>&kamailiobugs;</ulink>"> +<!ENTITY kamailiohelplink "<ulink url='&kamailiohelp;'>&kamailiohelp;</ulink>"> +<!ENTITY kamailiouserslink "<ulink url='&kamailiousers;'>&kamailiousers;</ulink>"> +<!ENTITY kamailiodevlink "<ulink url='&kamailiodev;'>&kamailiodev;</ulink>"> +<!ENTITY kamailiodbdocslink "<ulink url='&kamailiodbdocs;'>&kamailiodbdocs;</ulink>"> + +<!ENTITY kamailiohelpmail "<email>team(a)lists.kamailio.org</email>"> +<!ENTITY kamailiousersmail "<email>users(a)lists.kamailio.org</email>"> +<!ENTITY kamailiodevmail "<email>devel(a)lists.kamailio.org</email>"> + +<!ENTITY adminguide "Admin Guide"> +<!ENTITY develguide "Developer Guide"> +<!ENTITY faqguide "Frequently Asked Questions"> + +<!ENTITY serhomelink "<ulink url='&serhome;'>&serhome;</ulink>"> +<!ENTITY serbugslink "<ulink url='&serbugs;'>&serbugs;</ulink>"> +<!ENTITY serhelplink "<ulink url='&serhelp;'>&serhelp;</ulink>"> +<!ENTITY seruserslink "<ulink url='&serusers;'>&serusers;</ulink>"> +<!ENTITY serdevlink "<ulink url='&serdev;'>&serdev;</ulink>"> + +<!ENTITY defaultdb "mysql://openser:openserrw@localhost/openser"> +<!ENTITY defaultrodb "mysql://openserro:openserro@localhost/openser"> +<!ENTITY exampledb "dbdriver://username:password@dbhost/dbname"> + + + +<!ENTITY sip "<acronym>SIP</acronym>"> +<!ENTITY sdp "<acronym>SDP</acronym>"> +<!ENTITY rtp "<acronym>RTP</acronym>"> +<!ENTITY pstn "<acronym>PSTN</acronym>"> +<!ENTITY http "<acronym>HTTP</acronym>"> +<!ENTITY uri "<acronym>URI</acronym>"> +<!ENTITY url "<acronym>URL</acronym>"> +<!ENTITY uac "<acronym>UAC</acronym>"> +<!ENTITY uas "<acronym>UAS</acronym>"> +<!ENTITY ua "<acronym>UA</acronym>"> +<!ENTITY nat "<acronym>NAT</acronym>"> +<!ENTITY ip "<acronym>IP</acronym>"> +<!ENTITY udp "<acronym>UDP</acronym>"> +<!ENTITY ietf "<ulink url='http://www.ietf.org'>IETF</ulink>"> +<!ENTITY im "<acronym>IM</acronym>"> +<!ENTITY smtp "<acronym>SMTP</acronym>"> +<!ENTITY tls "<acronym>TLS</acronym>"> +<!ENTITY xmpp "<acronym>XMPP</acronym>"> +<!ENTITY gnu "<ulink url='http://www.gnu.org'>GNU</ulink>"> +<!ENTITY gpl "<ulink url='http://www.gnu.org/licenses/licenses.html#GPL'>GPL</ulink>"> +<!ENTITY openssl "<ulink url='http://www.openssl.org'>OpenSSL</ulink>"> + + + +<!ENTITY rfc3261 "<ulink url='http://www.ietf.org/rfc/rfc3261.txt'>RFC3261</ulink>"> +<!ENTITY rfc822 "<ulink url='http://www.ietf.org/rfc/rfc822.txt'>RFC822</ulink>"> +<!ENTITY rfc2543 "<ulink url='http://www.ietf.org/rfc/rfc2543.txt'>RFC2543</ulink>"> + +<!ENTITY vsname "Voice Sistem SRL"> +<!ENTITY voicesystem "<ulink url='http://www.voice-system.ro'>voice-system.ro</ulink>"> diff --git a/doc/kam_module_faq.xml b/doc/kam_module_faq.xml new file mode 100644 index 0000000..e69de29

15 years, 7 months

git:master: acc: added doc/Makefile

by Daniel-Constantin Mierla

Module: sip-router Branch: master Commit: 54bbef24c78c8ac3359bc174d8d3e0786bd53160 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=54bbef2… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Tue Apr 21 21:55:04 2009 +0200 acc: added doc/Makefile - makefile rules to generate documentation - entities.xml => kam_entities.xml - module_faq.xml => kam_module_faq.xml --- modules_k/acc/doc/Makefile | 40 ++++++++++++++++++++++++++++++++++++++++ modules_k/acc/doc/acc.xml | 2 +- 2 files changed, 41 insertions(+), 1 deletions(-) diff --git a/modules_k/acc/doc/Makefile b/modules_k/acc/doc/Makefile new file mode 100644 index 0000000..7b1f69a --- /dev/null +++ b/modules_k/acc/doc/Makefile @@ -0,0 +1,40 @@ +# +# The list of documents to build (without extensions) +# +DOCUMENTS = acc + +# +# The root directory containing Makefile.doc +# +ROOT_DIR=../../.. + +# +# Validate docbook documents before generating output +# (may be slow) +# +#VALIDATE=1 + +# +# You can override the CSS used in generated +# HTML documents here +# +#HTML_CSS=/style/docbook.css + +# +# You can override the stylesheet used to generate +# xhtml documents here +# +#XHTML_XSL=$(ROOT_DIR)/doc/stylesheets/xhtml.xsl + +# +# You can override the stylesheet used to generate +# plain text documents here +# +#TXT_XSL=$(XHTML_XSL) + +# +# K documentation style +# +DOCBOOK_MODE=k + +include $(ROOT_DIR)/Makefile.doc diff --git a/modules_k/acc/doc/acc.xml b/modules_k/acc/doc/acc.xml index 96f163b..0c75994 100644 --- a/modules_k/acc/doc/acc.xml +++ b/modules_k/acc/doc/acc.xml @@ -6,7 +6,7 @@ <!ENTITY faq SYSTEM "acc_faq.xml">  -<!ENTITY % docentities SYSTEM "../../../doc/entities.xml"> +<!ENTITY % docentities SYSTEM "../../../doc/kam_entities.xml"> %docentities; ]>

15 years, 7 months

git:master: dispatcher: added doc/Makefile

by Daniel-Constantin Mierla

Module: sip-router Branch: master Commit: bd7a3be954280b0f580063cc43f10c7dd3330bc7 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=bd7a3be… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Tue Apr 21 21:53:06 2009 +0200 dispatcher: added doc/Makefile - makefile rules to generate documentation - entities.xml => kam_entities.xml - module_faq.xml => kam_module_faq.xml --- modules_k/dispatcher/README | 276 ++++++++++++++----------------- modules_k/dispatcher/doc/Makefile | 40 +++++ modules_k/dispatcher/doc/dispatcher.xml | 2 +- 3 files changed, 168 insertions(+), 150 deletions(-) Diff: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commitdiff;h=bd7…

15 years, 7 months

git:master: makefile: K mode for documentation generation

by Daniel-Constantin Mierla

Module: sip-router Branch: master Commit: 371312a736015cd3ca654b72729d3385e56fcc69 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=371312a… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Tue Apr 21 21:47:10 2009 +0200 makefile: K mode for documentation generation - K has some extra parameters to XSLTPROC - new option to be able to set the path for css file used inside generated html --- Makefile.doc | 338 ++++++++++++++++++++++++++++++---------------------------- 1 files changed, 177 insertions(+), 161 deletions(-) diff --git a/Makefile.doc b/Makefile.doc index 4cc6791..c6e7cab 100644 --- a/Makefile.doc +++ b/Makefile.doc @@ -1,161 +1,177 @@ -# -# $Id$ -# - -# -# The name of the index file (the one which will be built by default -# without specifying a target -# -DOCUMENTS ?= index - -# -# The root of the document tree, this is used to determine the directory -# of auxiliary files. The variable should be overwritten by per-directory -# Makefiles -# -ROOT_DIR ?= ../../.. - -# -# Output directory where files produced by XSL stylesheets should be stored, -# by default we output to the same directory, documents that are chunked may -# choose to override this to write all chunks in a subdirectory instead -# -OUTPUT_DIR ?= . - -# -# Stylesheet used to generate dependencies from XML files -# -DEP_XSL ?= $(ROOT_DIR)/doc/stylesheets/dep.xsl - -# -# Default stylesheet used to generate XHTML -# -XHTML_XSL ?= $(ROOT_DIR)/doc/stylesheets/xhtml.xsl - -# -# Default stylesheet used to generate Drupal HTML without html headers -# -DRUPAL_XSL ?= $(ROOT_DIR)/doc/stylesheets/drupal.xsl - -# -# Default stylesheet used to generate HTML -# -HTML_XSL ?= $(ROOT_DIR)/doc/stylesheets/html.chunked.xsl - -# -# Stylesheet used to generate plain text documents, -# this is usually the one used for xhtml -# -TXT_XSL ?= $(ROOT_DIR)/doc/stylesheets/txt.xsl - -# -# Stylesheet used to generate FO (Formatted Objects) -# This is used by PDF generators -# -FO_XSL ?= $(ROOT_DIR)/doc/stylesheets/fo.xsl - -# -# Disable document validation by default -# -VALIDATE ?= 0 - -CATALOG=$(ROOT_DIR)/doc/catalog.xml - -LYNX ?= lynx -DIA ?= dia -XSLTPROC ?= xsltproc -XMLLINT ?= /usr/bin/xmllint -XEP ?= /usr/bin/xep - -LYNX_FLAGS ?= -nolist -DIA_ARGS ?= -XSLTPROC_FLAGS ?= -XMLLINT_FLAGS ?= --xinclude --postvalid --noout -XEP_FLAGS ?= - -ifeq ($(VALIDATE), 0) - override XSLTPROC_FLAGS := $(XSLTPROC_FLAGS) --novalid -endif - -alldep = Makefile $(ROOT_DIR)/Makefile.doc $(DEP_XSL) $(EXTRA_DEPS) - -all: xhtml - -xml_files = $(addsuffix .xml, $(DOCUMENTS)) -dep_files = $(addsuffix .d, $(DOCUMENTS)) -xhtml_files = $(addsuffix .xhtml, $(DOCUMENTS)) -html_files = $(addsuffix .html, $(DOCUMENTS)) -txt_files = $(addsuffix .txt, $(DOCUMENTS)) -pdf_files = $(addsuffix .pdf, $(DOCUMENTS)) - -xhtml: $(xhtml_files) -html: $(html_files) -txt: $(txt_files) -pdf: $(pdf_files) -drupal: override HTML_XSL := $(DRUPAL_XSL) -drupal: $(html_files) - - -%.xhtml: %.xml %.d $(alldep) $(XHTML_XSL) - XML_CATALOG_FILES=$(CATALOG) $(XSLTPROC) $(XSLTPROC_FLAGS) \ - --xinclude \ - --stringparam base.dir "$(OUTPUT_DIR)/" \ - --stringparam root.filename "$(basename $<)" \ - --stringparam html.ext ".xhtml" \ - $(XHTML_XSL) $< - -%.html: %.xml %.d $(alldep) $(HTML_XSL) - XML_CATALOG_FILES=$(CATALOG) $(XSLTPROC) $(XSLTPROC_FLAGS) \ - --xinclude \ - --stringparam base.dir "$(OUTPUT_DIR)/" \ - --stringparam root.filename "$(basename $<)" \ - --stringparam html.ext ".html" \ - --stringparam html.stylesheet ser.css \ - $(HTML_XSL) $< - -%.fo: %.xml $(alldep) $(FO_XSL) - XML_CATALOG_FILES=$(CATALOG) $(XSLTPROC) $(XSLTPROC_FLAGS) \ - --xinclude \ - -o $@ $(FO_XSL) $< - -%.pdf: %.fo %.d $(alldep) - $(XEP) $(XEP_FLAGS) -fo $< -pdf $@ - -%.txt: %.xml %.d $(alldep) - XML_CATALOG_FILES=$(CATALOG) $(XSLTPROC) $(XSLTPROC_FLAGS) \ - --xinclude \ - $(TXT_XSL) $< | $(LYNX) $(LYNX_FLAGS) -stdin -dump > $@ - -%.png: %.dia $(alldep) - $(DIA) $(DIA_ARGS) -t png -e $@ $< - -%.d: %.xml $(alldep) - $(XSLTPROC) $(XSLTPROC_FLAGS) \ - --nonet \ - --novalid \ - --stringparam output "$@" \ - $(DEP_XSL) $< - -.PHONY: check -check: $(xml_files) - XML_CATALOG_FILES=$(CATALOG) $(XMLLINT) $(XMLLINT_FLAGS) $< - -.PHONY: clean -clean: - @rm -f $(txt_files) - @rm -f $(xhtml_files) - @rm -f $(pdf_files) - @rm -f $(html_files) - -.PHONY: proper realclean distclean -proper realclean distclean: clean - @rm -f $(dep_files) *~ - - -ifeq (,$(MAKECMDGOALS)) -include $(dep_files) -endif -ifneq (,$(filter-out clean proper realclean distclean check, $(MAKECMDGOALS))) -include $(dep_files) -endif - +# +# $Id$ +# + +# +# The name of the index file (the one which will be built by default +# without specifying a target +# +DOCUMENTS ?= index + +# +# The root of the document tree, this is used to determine the directory +# of auxiliary files. The variable should be overwritten by per-directory +# Makefiles +# +ROOT_DIR ?= ../../.. + +# +# Output directory where files produced by XSL stylesheets should be stored, +# by default we output to the same directory, documents that are chunked may +# choose to override this to write all chunks in a subdirectory instead +# +OUTPUT_DIR ?= . + +# +# Stylesheet used to generate dependencies from XML files +# +DEP_XSL ?= $(ROOT_DIR)/doc/stylesheets/dep.xsl + +# +# Default stylesheet used to generate XHTML +# +XHTML_XSL ?= $(ROOT_DIR)/doc/stylesheets/xhtml.xsl + +# +# Default stylesheet used to generate Drupal HTML without html headers +# +DRUPAL_XSL ?= $(ROOT_DIR)/doc/stylesheets/drupal.xsl + +# +# Default stylesheet used to generate HTML +# +HTML_XSL ?= $(ROOT_DIR)/doc/stylesheets/html.chunked.xsl + +# +# Stylesheet used to generate plain text documents, +# this is usually the one used for xhtml +# +TXT_XSL ?= $(ROOT_DIR)/doc/stylesheets/txt.xsl + +# +# Stylesheet used to generate FO (Formatted Objects) +# This is used by PDF generators +# +FO_XSL ?= $(ROOT_DIR)/doc/stylesheets/fo.xsl + +# +# Disable document validation by default +# +VALIDATE ?= 0 + +# +# K docbook style +# +ifeq ($(DOCBOOK_MODE), k) + HTML_CSS=/css/kam-module-docbook.css + XSLTPROC_FLAGS+= --stringparam section.autolabel 1 \ + --stringparam section.label.includes.component.label 1 \ + --stringparam generate.toc "book toc,title,figure,table,example" +endif + +# +# Default CSS used in generated HTMLs +# +HTML_CSS ?= ser.css + +CATALOG=$(ROOT_DIR)/doc/catalog.xml + +LYNX ?= lynx +DIA ?= dia +XSLTPROC ?= xsltproc +XMLLINT ?= /usr/bin/xmllint +XEP ?= /usr/bin/xep + +LYNX_FLAGS ?= -nolist +DIA_ARGS ?= +XSLTPROC_FLAGS ?= +XMLLINT_FLAGS ?= --xinclude --postvalid --noout +XEP_FLAGS ?= + +ifeq ($(VALIDATE), 0) + override XSLTPROC_FLAGS := $(XSLTPROC_FLAGS) --novalid +endif + +alldep = Makefile $(ROOT_DIR)/Makefile.doc $(DEP_XSL) $(EXTRA_DEPS) + +all: xhtml + +xml_files = $(addsuffix .xml, $(DOCUMENTS)) +dep_files = $(addsuffix .d, $(DOCUMENTS)) +xhtml_files = $(addsuffix .xhtml, $(DOCUMENTS)) +html_files = $(addsuffix .html, $(DOCUMENTS)) +txt_files = $(addsuffix .txt, $(DOCUMENTS)) +pdf_files = $(addsuffix .pdf, $(DOCUMENTS)) + +xhtml: $(xhtml_files) +html: $(html_files) +txt: $(txt_files) +pdf: $(pdf_files) +drupal: override HTML_XSL := $(DRUPAL_XSL) +drupal: $(html_files) + + +%.xhtml: %.xml %.d $(alldep) $(XHTML_XSL) + XML_CATALOG_FILES=$(CATALOG) $(XSLTPROC) $(XSLTPROC_FLAGS) \ + --xinclude \ + --stringparam base.dir "$(OUTPUT_DIR)/" \ + --stringparam root.filename "$(basename $<)" \ + --stringparam html.ext ".xhtml" \ + --stringparam html.stylesheet $(HTML_CSS) \ + $(XHTML_XSL) $< + +%.html: %.xml %.d $(alldep) $(HTML_XSL) + XML_CATALOG_FILES=$(CATALOG) $(XSLTPROC) $(XSLTPROC_FLAGS) \ + --xinclude \ + --stringparam base.dir "$(OUTPUT_DIR)/" \ + --stringparam root.filename "$(basename $<)" \ + --stringparam html.ext ".html" \ + --stringparam html.stylesheet $(HTML_CSS) \ + $(HTML_XSL) $< + +%.fo: %.xml $(alldep) $(FO_XSL) + XML_CATALOG_FILES=$(CATALOG) $(XSLTPROC) $(XSLTPROC_FLAGS) \ + --xinclude \ + -o $@ $(FO_XSL) $< + +%.pdf: %.fo %.d $(alldep) + $(XEP) $(XEP_FLAGS) -fo $< -pdf $@ + +%.txt: %.xml %.d $(alldep) + XML_CATALOG_FILES=$(CATALOG) $(XSLTPROC) $(XSLTPROC_FLAGS) \ + --xinclude \ + $(TXT_XSL) $< | $(LYNX) $(LYNX_FLAGS) -stdin -dump > $@ + +%.png: %.dia $(alldep) + $(DIA) $(DIA_ARGS) -t png -e $@ $< + +%.d: %.xml $(alldep) + $(XSLTPROC) $(XSLTPROC_FLAGS) \ + --nonet \ + --novalid \ + --stringparam output "$@" \ + $(DEP_XSL) $< + +.PHONY: check +check: $(xml_files) + XML_CATALOG_FILES=$(CATALOG) $(XMLLINT) $(XMLLINT_FLAGS) $< + +.PHONY: clean +clean: + @rm -f $(txt_files) + @rm -f $(xhtml_files) + @rm -f $(pdf_files) + @rm -f $(html_files) + +.PHONY: proper realclean distclean +proper realclean distclean: clean + @rm -f $(dep_files) *~ + + +ifeq (,$(MAKECMDGOALS)) +include $(dep_files) +endif +ifneq (,$(filter-out clean proper realclean distclean check, $(MAKECMDGOALS))) +include $(dep_files) +endif +

15 years, 7 months

git:master: makefile: make README removes the txt from doc/

by Daniel-Constantin Mierla

Module: sip-router Branch: master Commit: 8c6e0b056196c94aa957f95736dc7fcad83a1f16 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=8c6e0b0… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Tue Apr 21 21:45:49 2009 +0200 makefile: make README removes the txt from doc/ - generation of README file for modules removes the txt file from doc/ directory --- Makefile.modules | 2 +- 1 files changed, 1 insertions(+), 1 deletions(-) diff --git a/Makefile.modules b/Makefile.modules index da2c37f..0b85655 100644 --- a/Makefile.modules +++ b/Makefile.modules @@ -95,7 +95,7 @@ ifneq (,$(wildcard doc/Makefile)) README: doc/*.xml $(MAKE) -C doc $(MOD_NAME).txt - cp doc/$(MOD_NAME).txt $@ + mv doc/$(MOD_NAME).txt $@ else # do nothing

15 years, 7 months

git:master: * Module: presence

by Juha Heinanen

Module: sip-router Branch: master Commit: 50c83331d15723022e758984b01fd5edb7e11d17 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=50c8333… Author: Juha Heinanen <jh(a)tutpro.com> Committer: Juha Heinanen <jh(a)tutpro.com> Date: Tue Apr 21 21:38:26 2009 +0300 * Module: presence Fixed wrong error message. --- modules_k/presence/presence.c | 4 ++-- 1 files changed, 2 insertions(+), 2 deletions(-) diff --git a/modules_k/presence/presence.c b/modules_k/presence/presence.c index 67f082f..9aac54c 100644 --- a/modules_k/presence/presence.c +++ b/modules_k/presence/presence.c @@ -541,8 +541,8 @@ static struct mi_root* mi_refreshWatchers(struct mi_root* cmd, void* param) return 0; if(node->value.s== NULL || node->value.len== 0) { - LM_ERR( "empty event parameter\n"); - return init_mi_tree(400, "Empty event parameter", 21); + LM_ERR( "empty refresh type parameter\n"); + return init_mi_tree(400, "Empty refresh type parameter", 28); } if(str2int(&node->value, &refresh_type)< 0) {

15 years, 7 months

how to generate README?

by jh＠tutpro.com

in k, i can generate README of a module like this (from INSTALL): -generate README file for textops module make modules=modules/textops modules-readme when i try it in sip-router, i get: jh@taimen:/usr/src/orig/sip-router$ rm modules_k/textops/README jh@taimen:/usr/src/orig/sip-router$ make modules=modules_k/textops modules-readme config.mak loaded Makefile.defs defs skipped Makefile:350: "make TLS option is obsoleted, try TLS_HOOKS or CORE_TLS" config.mak included make[1]: Entering directory `/usr/src/orig/sip-router/modules_k/textops' make[1]: Nothing to be done for `README'. make[1]: Leaving directory `/usr/src/orig/sip-router/modules_k/textops' i tried 'make man', but it didn't generate textops README either. -- juha

15 years, 7 months

git:master: Merge branch 'master' of ssh://jh@git.sip-router.org/sip-router

by Juha Heinanen

Module: sip-router Branch: master Commit: 4dce83ec72e26a2ce3b705fa8a59878d2bea5b65 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=4dce83e… Author: Juha Heinanen <jh(a)tutpro.com> Committer: Juha Heinanen <jh(a)tutpro.com> Date: Tue Apr 21 19:33:11 2009 +0300 Merge branch 'master' of ssh://jh@git.sip-router.org/sip-router * 'master' of ssh://jh@git.sip-router.org/sip-router: fix crash in carrierroute related to failed config file loading ---

15 years, 7 months

← Newer
1
...
10
11
12
13
14
15
16
...
23
Older →

Jump to page:

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

sr-dev April 2009