added a haiku book template

moved Shell_Tools in its own directory
added a variable to set the output directory


git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@12677 a95241bf-73f2-0310-859d-f6bbb57e9c96

src/documentation/Jamfile

@@ -9,26 +9,19 @@ rule Doc2HTML
 
 	SEARCH on $(source) = $(SEARCH_SOURCE) ;
 
-	MakeLocate $(target) : [ FDirName $(OBOS_DISTRO_TARGET) beos documentation Shell\ Tools ] ;
+	MakeLocate $(target) : [ FDirName $(OBOS_DISTRO_TARGET) beos documentation $(DOC_LOCATION) ] ;
 
         Depends $(target) : $(source) ;
         LocalDepends doc_files : $(target) ;
-	XSLPROCPATHS on $(target) = $(XSLPATHS:J=\ ) ;
+	XSLPROCPATHS on $(target) = "-path \""$(XSLPATHS:J=\ )"\"" ;
 	Doc2HTML1 $(target) : $(source) ;
         LocalClean clean : $(target) ;
 }
 
 actions Doc2HTML1
 {
-	$(XSLTPROC) -xinclude -path "$(XSLPROCPATHS)" -o "$(1)" $(HTMLXSLSHEET) $(2) ;
+	$(XSLTPROC) -xinclude $(XSLPROCPATHS) -o "$(1)" $(HTMLXSLSHEET) $(2) ;
 }
 
-XSLPATHS = [ FDirName $(OBOS_OBJECT_TARGET) documentation Shell_Tools ] [ FDirName $(OBOS_TOP) src bin coreutils man ] ;
+SubInclude OBOS_TOP src documentation haiku_book ;
-HTMLXSLSHEET = http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl ;
+SubInclude OBOS_TOP src documentation shell_tools ;
-
-Doc2HTML 
-	Shell_Tools-Guide.xml
-	;
-
-Includes [ FGristFiles Shell_Tools-Guide.xml ] : <src!bin!coreutils!man>coreutils.xml ;
-SEARCH on <src!bin!coreutils!man>coreutils.xml = [ FDirName $(OBOS_TOP) src bin coreutils man ] ;

src/documentation/haiku_book/Haiku_Book.xml

@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+<!-- 
+	Things that need fixing should be marked as such with either "TODO"
+	or "FIXME".
+
+-->
+
+<!ENTITY appkit SYSTEM "appkit.xml">
+<!ENTITY devicekit SYSTEM "devicekit.xml">
+<!ENTITY gamekit SYSTEM "gamekit.xml">
+<!ENTITY interfacekit SYSTEM "interfacekit.xml">
+<!ENTITY kernelkit SYSTEM "kernelkit.xml">
+<!ENTITY mailkit SYSTEM "mailkit.xml">
+<!ENTITY mediakit SYSTEM "mediakit.xml">
+<!ENTITY midikit SYSTEM "midikit.xml">
+<!ENTITY networkkit SYSTEM "networkkit.xml">
+<!ENTITY openglkit SYSTEM "openglkit.xml">
+<!ENTITY storagekit SYSTEM "storagekit.xml">
+<!ENTITY supportkit SYSTEM "supportkit.xml">
+<!ENTITY translationkit SYSTEM "translationkit.xml">
+
+<!-- license -->
+<!ENTITY license SYSTEM "../license.xml">
+
+<!-- Text Macros -->
+<!ENTITY haikuorg '<ulink url="http://www.haiku-os.org">Haiku</ulink>'>
+<!ENTITY haiku "Haiku">
+
+]>
+
+<book id="index">
+  <bookinfo>
+    <title>Haiku Book</title>
+    <pubdate>2005-05-16</pubdate>
+    <author>
+      <firstname>Jerome</firstname>
+      <surname>Duval</surname>
+    </author>
+
+    <abstract>
+	 	<para>
+			This guide is the documentation for the C and C++ API of &haiku;.
+		</para>
+    </abstract>
+	 
+    <revhistory>
+	 <revision>
+	 <revnumber>1.0</revnumber>
+	 <date>2005-05-16</date>
+	 <authorinitials>kor</authorinitials>
+	 <revremark>Initial version.</revremark>
+	 </revision>
+    </revhistory>
+  </bookinfo>
+
+
+<!-- Chapters
+-->
+&appkit;
+&devicekit;
+&gamekit;
+&interfacekit;
+&kernelkit;
+&mailkit;
+&mediakit;
+&midikit;
+&networkkit;
+&openglkit;
+&storagekit;
+&supportkit;
+&translationkit;
+
+<!-- 
+	The License 
+-->
+&license;
+
+</book>

src/documentation/haiku_book/Jamfile

@@ -0,0 +1,27 @@
+SubDir OBOS_TOP src documentation haiku_book ;
+
+XSLPATHS = ;
+HTMLXSLSHEET = http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl ;
+DOC_LOCATION = Haiku\ Book ;
+
+Doc2HTML 
+	Haiku_Book.xml
+	;
+
+local chapter_files = appkit.xml
+devicekit.xml
+gamekit.xml
+interfacekit.xml
+kernelkit.xml
+mailkit.xml
+mediakit.xml
+midikit.xml
+networkkit.xml
+openglkit.xml
+storagekit.xml
+supportkit.xml
+translationkit.xml ;
+
+Includes [ FGristFiles Haiku_Book.xml ] 
+	: [ FGristFiles $(chapter_files) ] <src!documentation>license.xml ;
+SEARCH on [ FGristFiles $(chapter_files) ] = [ FDirName $(OBOS_TOP) src documentation haiku_book ] ;

src/documentation/haiku_book/appkit.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<chapter id="st-appkit">
+<title>The Application Kit</title>
+
+</chapter>
+

src/documentation/haiku_book/devicekit.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<chapter id="st-devicekit">
+<title>The Device Kit</title>
+
+</chapter>
+

src/documentation/haiku_book/gamekit.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<chapter id="st-gamekit">
+<title>The Game Kit</title>
+
+</chapter>
+

src/documentation/haiku_book/interfacekit.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<chapter id="st-interfacekit">
+<title>The Interface Kit</title>
+
+</chapter>
+

src/documentation/haiku_book/kernelkit.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<chapter id="st-kernelkit">
+<title>The Kernel Kit</title>
+
+</chapter>
+

src/documentation/haiku_book/mailkit.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<chapter id="st-mailkit">
+<title>The Mail Kit</title>
+
+</chapter>
+

src/documentation/haiku_book/mediakit.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<chapter id="st-mediakit">
+<title>The Media Kit</title>
+
+</chapter>
+

src/documentation/haiku_book/midikit.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<chapter id="st-midikit">
+<title>The Midi Kit</title>
+
+</chapter>
+

src/documentation/haiku_book/networkkit.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<chapter id="st-networkkit">
+<title>The Network Kit</title>
+
+</chapter>
+

src/documentation/haiku_book/openglkit.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<chapter id="st-openglkit">
+<title>The OpenGL Kit</title>
+
+</chapter>
+

src/documentation/haiku_book/storagekit.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<chapter id="st-storagekit">
+<title>The Storage Kit</title>
+
+</chapter>
+

src/documentation/haiku_book/supportkit.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<chapter id="st-supportkit">
+<title>The Support Kit</title>
+
+</chapter>
+

src/documentation/haiku_book/translationkit.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<chapter id="st-translationkit">
+<title>The Translation Kit</title>
+
+</chapter>
+

src/documentation/shell_tools/Jamfile

@@ -0,0 +1,13 @@
+SubDir OBOS_TOP src documentation shell_tools ;
+
+XSLPATHS = [ FDirName $(OBOS_OBJECT_TARGET) documentation Shell_Tools ] [ FDirName $(OBOS_TOP) src bin coreutils man ] ;
+HTMLXSLSHEET = http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl ;
+DOC_LOCATION = Shell\ Tools ;
+
+Doc2HTML 
+	Shell_Tools-Guide.xml
+	;
+
+Includes [ FGristFiles Shell_Tools-Guide.xml ] : <src!bin!coreutils!man>coreutils.xml <src!documentation>license.xml ;
+SEARCH on <src!bin!coreutils!man>coreutils.xml = [ FDirName $(OBOS_TOP) src bin coreutils man ] ;
+

src/documentation/shell_tools/Shell_Tools-Guide.xml

@@ -22,7 +22,7 @@
 <!ENTITY coreutils SYSTEM "coreutils.xml">
 
 <!-- license -->
-<!ENTITY license SYSTEM "license.xml">
+<!ENTITY license SYSTEM "../license.xml">
 
 <!-- Text Macros -->
 <!ENTITY haikuorg '<ulink url="http://www.haiku-os.org">Haiku</ulink>'>