Browse code

docbook: Update and add missing docbook Makefiles

This change updates all the Makefiles used to process docbook documents
so that they work with the new docbook build system. It also adds some
missing Makefiles. Every directory containing docbook documentation
should have a Makefile so that it can be processed independently.

Jan Janak authored on 13/05/2009 23:44:10
Showing 1 changed files
1 1
deleted file mode 100644
... ...
@@ -1,120 +0,0 @@
1
-<?xml version="1.0" encoding="UTF-8"?>
2
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
3
-   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4
-
5
-<book id="ser_doc" xmlns:xi="http://www.w3.org/2001/XInclude">
6
-    <bookinfo>
7
-	<revhistory>
8
-	    <revision>
9
-		<revnumber>$Revision$</revnumber>
10
-		<date>$Date$</date>
11
-	    </revision>
12
-	</revhistory>
13
-    </bookinfo>
14
-
15
-    <chapter>
16
-        <?dbhtml dir="sip_intro"?>
17
-	<title>SIP Introduction</title>
18
-	<xi:include href="sip/sip_introduction.xml"/>
19
-    </chapter>
20
-
21
-    <chapter>
22
-        <?dbhtml dir="ser_howto"?>
23
-	<title>Howto</title>
24
-	<xi:include href="serhowto/ser-howto.xml"/>
25
-    </chapter>
26
-
27
-    <chapter>
28
-        <?dbhtml dir="radius_howto"?>
29
-	<title>RADIUS Howto</title>
30
-	<xi:include href="ser_radius/ser_radius.xml"/>
31
-    </chapter>
32
-
33
-    <chapter>
34
-        <?dbhtml dir="admin_guide"?>
35
-	<title>Administrator's Guide</title>
36
-	<xi:include href="seruser/seruser.xml"/>
37
-    </chapter>
38
-
39
-    <chapter>
40
-        <?dbhtml dir="xmlrpc"?>
41
-	<title>SER Remote Procedure Call Interface</title>
42
-	<xi:include href="rpc/ser_rpc.xml"/>
43
-    </chapter>
44
-
45
-    <chapter>
46
-        <?dbhtml dir="db_schema"?>
47
-	<title>SER Database Schema and Administration</title>
48
-	<xi:include href="database/ser_db.xml"/>
49
-    </chapter>
50
-
51
-    <chapter>
52
-        <?dbhtml dir="presence"?>
53
-	<title>Presence Handbook</title>
54
-	<xi:include href="presence/intro.xml"/>
55
-	<xi:include href="presence/xcap.xml"/>
56
-	<xi:include href="presence/install.xml"/>
57
-	<xi:include href="presence/examples.xml"/>
58
-	<xi:include href="presence/biblio.xml"/>
59
-    </chapter>
60
-	
61
-    <chapter>
62
-        <?dbhtml dir="modules"?>
63
-    	<title>Module Documentation</title>
64
-<!--	<xi:include href="../modules/acc/doc/acc.xml"/> -->
65
-	<xi:include href="../modules/auth/doc/auth.xml"/>
66
-	<xi:include href="../modules/auth_db/doc/auth_db.xml"/>
67
-	<xi:include href="../modules/auth_radius/doc/auth_radius.xml"/>
68
-	<xi:include href="../modules/avp/doc/avp.xml"/>
69
-	<xi:include href="../modules/avp_db/doc/avp_db.xml"/>
70
-	<xi:include href="../modules/avpops/doc/avpops.xml"/>
71
-	<xi:include href="../modules/avp_radius/doc/avp_radius.xml"/>
72
-	<xi:include href="../modules/cpl-c/doc/cpl-c.xml"/>
73
-	<xi:include href="../modules/dbtext/doc/dbtext.xml"/>
74
-	<xi:include href="../modules/dispatcher/doc/dispatcher.xml"/>
75
-	<xi:include href="../modules/diversion/doc/diversion.xml"/>
76
-	<xi:include href="../modules/domain/doc/domain.xml"/>
77
-	<xi:include href="../modules/enum/doc/enum.xml"/>
78
-	<xi:include href="../modules/exec/doc/exec.xml"/>
79
-	<xi:include href="../modules/flatstore/doc/flatstore.xml"/>
80
-	<xi:include href="../modules/gflags/doc/gflags.xml"/>
81
-	<xi:include href="../modules/group/doc/group.xml"/>
82
-	<xi:include href="../modules/group_radius/doc/group_radius.xml"/>
83
-	<xi:include href="../modules/jabber/doc/jabber.xml"/>
84
-	<xi:include href="../modules/mangler/doc/mangler.xml"/>
85
-	<xi:include href="../modules/maxfwd/doc/maxfwd.xml"/>
86
-	<xi:include href="../modules/msilo/doc/msilo.xml"/>
87
-	<xi:include href="../modules/nathelper/doc/nathelper.xml"/>
88
-	<xi:include href="../modules/options/doc/options.xml"/>
89
-	<xi:include href="../modules/pa/doc/pa.xml"/>
90
-	<xi:include href="../modules/pdt/doc/pdt.xml"/>
91
-	<xi:include href="../modules/permissions/doc/permissions.xml"/>
92
-	<xi:include href="../modules/pike/doc/pike.xml"/>
93
-	<xi:include href="../modules/print/doc/print.xml"/>
94
-	<xi:include href="../modules/registrar/doc/registrar.xml"/>
95
-	<xi:include href="../modules/rls/doc/rls.xml"/>
96
-	<xi:include href="../modules/rr/doc/rr.xml"/>
97
-	<xi:include href="../modules/sl/doc/sl.xml"/>
98
-	<xi:include href="../modules/sms/doc/sms.xml"/>
99
-	<xi:include href="../modules/speeddial/doc/speeddial.xml"/>
100
-	<xi:include href="../modules/textops/doc/textops.xml"/>
101
-	<xi:include href="../modules/tm/doc/tm.xml"/>
102
-	<xi:include href="../modules/uac/doc/uac.xml"/>
103
-	<xi:include href="../modules/uri/doc/uri.xml"/>
104
-	<xi:include href="../modules/uri_db/doc/uri_db.xml"/>
105
-	<xi:include href="../modules/uri_radius/doc/uri_radius.xml"/>
106
-	<xi:include href="../modules/usrloc/doc/usrloc.xml"/>
107
-	<xi:include href="../modules/xlog/doc/xlog.xml"/>
108
-    </chapter>
109
-   
110
-    <chapter>
111
-        <?dbhtml dir="devel"?>
112
-	<title>Developer's Guide</title>
113
-	<xi:include href="serdev/serdev.xml"/>
114
-    </chapter>
115
-    <chapter>
116
-        <?dbhtml dir="faq"?>
117
-	<title>Frequently Asked Questions</title>
118
-	<xi:include href="serfaq/serfaq.xml"/>
119
-    </chapter>
120
-</book>
Browse code

- Processing instructions to generate output in subdirs - acc removed

Jan Janak authored on 05/12/2005 12:11:18
Showing 1 changed files
... ...
@@ -13,36 +13,43 @@
13 13
     </bookinfo>
14 14
 
15 15
     <chapter>
16
+        <?dbhtml dir="sip_intro"?>
16 17
 	<title>SIP Introduction</title>
17 18
 	<xi:include href="sip/sip_introduction.xml"/>
18 19
     </chapter>
19 20
 
20 21
     <chapter>
22
+        <?dbhtml dir="ser_howto"?>
21 23
 	<title>Howto</title>
22 24
 	<xi:include href="serhowto/ser-howto.xml"/>
23 25
     </chapter>
24 26
 
25 27
     <chapter>
28
+        <?dbhtml dir="radius_howto"?>
26 29
 	<title>RADIUS Howto</title>
27 30
 	<xi:include href="ser_radius/ser_radius.xml"/>
28 31
     </chapter>
29 32
 
30 33
     <chapter>
34
+        <?dbhtml dir="admin_guide"?>
31 35
 	<title>Administrator's Guide</title>
32 36
 	<xi:include href="seruser/seruser.xml"/>
33 37
     </chapter>
34 38
 
35 39
     <chapter>
40
+        <?dbhtml dir="xmlrpc"?>
36 41
 	<title>SER Remote Procedure Call Interface</title>
37 42
 	<xi:include href="rpc/ser_rpc.xml"/>
38 43
     </chapter>
39 44
 
40 45
     <chapter>
46
+        <?dbhtml dir="db_schema"?>
41 47
 	<title>SER Database Schema and Administration</title>
42 48
 	<xi:include href="database/ser_db.xml"/>
43 49
     </chapter>
44 50
 
45 51
     <chapter>
52
+        <?dbhtml dir="presence"?>
46 53
 	<title>Presence Handbook</title>
47 54
 	<xi:include href="presence/intro.xml"/>
48 55
 	<xi:include href="presence/xcap.xml"/>
... ...
@@ -52,8 +59,9 @@
52 59
     </chapter>
53 60
 	
54 61
     <chapter>
62
+        <?dbhtml dir="modules"?>
55 63
     	<title>Module Documentation</title>
56
-	<xi:include href="../modules/acc/doc/acc.xml"/>
64
+<!--	<xi:include href="../modules/acc/doc/acc.xml"/> -->
57 65
 	<xi:include href="../modules/auth/doc/auth.xml"/>
58 66
 	<xi:include href="../modules/auth_db/doc/auth_db.xml"/>
59 67
 	<xi:include href="../modules/auth_radius/doc/auth_radius.xml"/>
... ...
@@ -100,10 +108,12 @@
100 108
     </chapter>
101 109
    
102 110
     <chapter>
111
+        <?dbhtml dir="devel"?>
103 112
 	<title>Developer's Guide</title>
104 113
 	<xi:include href="serdev/serdev.xml"/>
105 114
     </chapter>
106 115
     <chapter>
116
+        <?dbhtml dir="faq"?>
107 117
 	<title>Frequently Asked Questions</title>
108 118
 	<xi:include href="serfaq/serfaq.xml"/>
109 119
     </chapter>
Browse code

- updated to include all documentation

Jan Janak authored on 17/11/2005 12:08:17
Showing 1 changed files
... ...
@@ -32,6 +32,16 @@
32 32
 	<xi:include href="seruser/seruser.xml"/>
33 33
     </chapter>
34 34
 
35
+    <chapter>
36
+	<title>SER Remote Procedure Call Interface</title>
37
+	<xi:include href="rpc/ser_rpc.xml"/>
38
+    </chapter>
39
+
40
+    <chapter>
41
+	<title>SER Database Schema and Administration</title>
42
+	<xi:include href="database/ser_db.xml"/>
43
+    </chapter>
44
+
35 45
     <chapter>
36 46
 	<title>Presence Handbook</title>
37 47
 	<xi:include href="presence/intro.xml"/>
Browse code

added cfg example into "presence handbook"

Vaclav Kubart authored on 10/11/2005 13:36:17
Showing 1 changed files
... ...
@@ -37,6 +37,7 @@
37 37
 	<xi:include href="presence/intro.xml"/>
38 38
 	<xi:include href="presence/xcap.xml"/>
39 39
 	<xi:include href="presence/install.xml"/>
40
+	<xi:include href="presence/examples.xml"/>
40 41
 	<xi:include href="presence/biblio.xml"/>
41 42
     </chapter>
42 43
 	
Browse code

updated "presence handbook" - documentation of presence and presence modules

Vaclav Kubart authored on 09/11/2005 14:18:48
Showing 1 changed files
... ...
@@ -34,7 +34,9 @@
34 34
 
35 35
     <chapter>
36 36
 	<title>Presence Handbook</title>
37
-	<xi:include href="presence/presence.xml"/>
37
+	<xi:include href="presence/intro.xml"/>
38
+	<xi:include href="presence/xcap.xml"/>
39
+	<xi:include href="presence/install.xml"/>
38 40
 	<xi:include href="presence/biblio.xml"/>
39 41
     </chapter>
40 42
 	
Browse code

Added some documentation about presence in ser. Will be improved continuously.

Vaclav Kubart authored on 01/11/2005 12:24:41
Showing 1 changed files
... ...
@@ -32,6 +32,12 @@
32 32
 	<xi:include href="seruser/seruser.xml"/>
33 33
     </chapter>
34 34
 
35
+    <chapter>
36
+	<title>Presence Handbook</title>
37
+	<xi:include href="presence/presence.xml"/>
38
+	<xi:include href="presence/biblio.xml"/>
39
+    </chapter>
40
+	
35 41
     <chapter>
36 42
     	<title>Module Documentation</title>
37 43
 	<xi:include href="../modules/acc/doc/acc.xml"/>
... ...
@@ -65,6 +71,7 @@
65 71
 	<xi:include href="../modules/pike/doc/pike.xml"/>
66 72
 	<xi:include href="../modules/print/doc/print.xml"/>
67 73
 	<xi:include href="../modules/registrar/doc/registrar.xml"/>
74
+	<xi:include href="../modules/rls/doc/rls.xml"/>
68 75
 	<xi:include href="../modules/rr/doc/rr.xml"/>
69 76
 	<xi:include href="../modules/sl/doc/sl.xml"/>
70 77
 	<xi:include href="../modules/sms/doc/sms.xml"/>
Browse code

- documents are now valid (apart from xmlns:xi problem which would require docbook dtd changes)

Jan Janak authored on 24/08/2005 22:24:59
Showing 1 changed files
... ...
@@ -1,16 +1,16 @@
1 1
 <?xml version="1.0" encoding="UTF-8"?>
2
-<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
2
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
3 3
    "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4 4
 
5 5
 <book id="ser_doc" xmlns:xi="http://www.w3.org/2001/XInclude">
6
-    <sectioninfo>
6
+    <bookinfo>
7 7
 	<revhistory>
8 8
 	    <revision>
9 9
 		<revnumber>$Revision$</revnumber>
10 10
 		<date>$Date$</date>
11 11
 	    </revision>
12 12
 	</revhistory>
13
-    </sectioninfo>
13
+    </bookinfo>
14 14
 
15 15
     <chapter>
16 16
 	<title>SIP Introduction</title>
... ...
@@ -78,12 +78,11 @@
78 78
 	<xi:include href="../modules/usrloc/doc/usrloc.xml"/>
79 79
 	<xi:include href="../modules/xlog/doc/xlog.xml"/>
80 80
     </chapter>
81
-    
81
+   
82 82
     <chapter>
83 83
 	<title>Developer's Guide</title>
84 84
 	<xi:include href="serdev/serdev.xml"/>
85 85
     </chapter>
86
-
87 86
     <chapter>
88 87
 	<title>Frequently Asked Questions</title>
89 88
 	<xi:include href="serfaq/serfaq.xml"/>
Browse code

- DTDs and stylesheets will be downloaded from the network if they are not available locally.

Jan Janak authored on 24/08/2005 13:24:27
Showing 1 changed files
... ...
@@ -1,6 +1,6 @@
1 1
 <?xml version="1.0" encoding="UTF-8"?>
2
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4//EN"
3
-                      "file:///usr/share/sgml/docbook/dtd/xml/4/docbookx.dtd">
2
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
3
+   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4 4
 
5 5
 <book id="ser_doc" xmlns:xi="http://www.w3.org/2001/XInclude">
6 6
     <sectioninfo>
Browse code

- Customized stylesheet for XHTML generation - Very basic CSS style for documentation - Stylesheet for generating Docbook dependencies in Makefiles

Jan Janak authored on 23/07/2005 23:01:14
Showing 1 changed files
1 1
new file mode 100644
... ...
@@ -0,0 +1,91 @@
1
+<?xml version="1.0" encoding="UTF-8"?>
2
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4//EN"
3
+                      "file:///usr/share/sgml/docbook/dtd/xml/4/docbookx.dtd">
4
+
5
+<book id="ser_doc" xmlns:xi="http://www.w3.org/2001/XInclude">
6
+    <sectioninfo>
7
+	<revhistory>
8
+	    <revision>
9
+		<revnumber>$Revision$</revnumber>
10
+		<date>$Date$</date>
11
+	    </revision>
12
+	</revhistory>
13
+    </sectioninfo>
14
+
15
+    <chapter>
16
+	<title>SIP Introduction</title>
17
+	<xi:include href="sip/sip_introduction.xml"/>
18
+    </chapter>
19
+
20
+    <chapter>
21
+	<title>Howto</title>
22
+	<xi:include href="serhowto/ser-howto.xml"/>
23
+    </chapter>
24
+
25
+    <chapter>
26
+	<title>RADIUS Howto</title>
27
+	<xi:include href="ser_radius/ser_radius.xml"/>
28
+    </chapter>
29
+
30
+    <chapter>
31
+	<title>Administrator's Guide</title>
32
+	<xi:include href="seruser/seruser.xml"/>
33
+    </chapter>
34
+
35
+    <chapter>
36
+    	<title>Module Documentation</title>
37
+	<xi:include href="../modules/acc/doc/acc.xml"/>
38
+	<xi:include href="../modules/auth/doc/auth.xml"/>
39
+	<xi:include href="../modules/auth_db/doc/auth_db.xml"/>
40
+	<xi:include href="../modules/auth_radius/doc/auth_radius.xml"/>
41
+	<xi:include href="../modules/avp/doc/avp.xml"/>
42
+	<xi:include href="../modules/avp_db/doc/avp_db.xml"/>
43
+	<xi:include href="../modules/avpops/doc/avpops.xml"/>
44
+	<xi:include href="../modules/avp_radius/doc/avp_radius.xml"/>
45
+	<xi:include href="../modules/cpl-c/doc/cpl-c.xml"/>
46
+	<xi:include href="../modules/dbtext/doc/dbtext.xml"/>
47
+	<xi:include href="../modules/dispatcher/doc/dispatcher.xml"/>
48
+	<xi:include href="../modules/diversion/doc/diversion.xml"/>
49
+	<xi:include href="../modules/domain/doc/domain.xml"/>
50
+	<xi:include href="../modules/enum/doc/enum.xml"/>
51
+	<xi:include href="../modules/exec/doc/exec.xml"/>
52
+	<xi:include href="../modules/flatstore/doc/flatstore.xml"/>
53
+	<xi:include href="../modules/gflags/doc/gflags.xml"/>
54
+	<xi:include href="../modules/group/doc/group.xml"/>
55
+	<xi:include href="../modules/group_radius/doc/group_radius.xml"/>
56
+	<xi:include href="../modules/jabber/doc/jabber.xml"/>
57
+	<xi:include href="../modules/mangler/doc/mangler.xml"/>
58
+	<xi:include href="../modules/maxfwd/doc/maxfwd.xml"/>
59
+	<xi:include href="../modules/msilo/doc/msilo.xml"/>
60
+	<xi:include href="../modules/nathelper/doc/nathelper.xml"/>
61
+	<xi:include href="../modules/options/doc/options.xml"/>
62
+	<xi:include href="../modules/pa/doc/pa.xml"/>
63
+	<xi:include href="../modules/pdt/doc/pdt.xml"/>
64
+	<xi:include href="../modules/permissions/doc/permissions.xml"/>
65
+	<xi:include href="../modules/pike/doc/pike.xml"/>
66
+	<xi:include href="../modules/print/doc/print.xml"/>
67
+	<xi:include href="../modules/registrar/doc/registrar.xml"/>
68
+	<xi:include href="../modules/rr/doc/rr.xml"/>
69
+	<xi:include href="../modules/sl/doc/sl.xml"/>
70
+	<xi:include href="../modules/sms/doc/sms.xml"/>
71
+	<xi:include href="../modules/speeddial/doc/speeddial.xml"/>
72
+	<xi:include href="../modules/textops/doc/textops.xml"/>
73
+	<xi:include href="../modules/tm/doc/tm.xml"/>
74
+	<xi:include href="../modules/uac/doc/uac.xml"/>
75
+	<xi:include href="../modules/uri/doc/uri.xml"/>
76
+	<xi:include href="../modules/uri_db/doc/uri_db.xml"/>
77
+	<xi:include href="../modules/uri_radius/doc/uri_radius.xml"/>
78
+	<xi:include href="../modules/usrloc/doc/usrloc.xml"/>
79
+	<xi:include href="../modules/xlog/doc/xlog.xml"/>
80
+    </chapter>
81
+    
82
+    <chapter>
83
+	<title>Developer's Guide</title>
84
+	<xi:include href="serdev/serdev.xml"/>
85
+    </chapter>
86
+
87
+    <chapter>
88
+	<title>Frequently Asked Questions</title>
89
+	<xi:include href="serfaq/serfaq.xml"/>
90
+    </chapter>
91
+</book>