Author: derek Date: Thu Jun 14 21:26:44 2007 New Revision: 326 Modified: sofaswitch/trunk/callflow/docs/app1.sgml sofaswitch/trunk/callflow/docs/chap1.sgml sofaswitch/trunk/callflow/docs/makedoc.xsl Log: Minor tidyups to get it to work more often, first time. Modified: sofaswitch/trunk/callflow/docs/app1.sgml ============================================================================== --- sofaswitch/trunk/callflow/docs/app1.sgml (original) +++ sofaswitch/trunk/callflow/docs/app1.sgml Thu Jun 14 21:26:44 2007 @@ -22,6 +22,14 @@ </para> <para> +Under windows, you are still going to use docbook to transform the +<literal>.xml</literal> file into html documentation. You will need to follow +similar steps to those described in a +<ulink url="http://www.codeproject.com/winhelp/docbook_howto.asp">windows +guide</ulink>, but you will end up with native windows looking documentation. +</para> + +<para> The unix command <screen> xsltproc makedoc.xsl callflow.xml Modified: sofaswitch/trunk/callflow/docs/chap1.sgml ============================================================================== --- sofaswitch/trunk/callflow/docs/chap1.sgml (original) +++ sofaswitch/trunk/callflow/docs/chap1.sgml Thu Jun 14 21:26:44 2007 @@ -72,7 +72,7 @@ For safety, variables required should be limited to the scope of the class that this graph is running. Consequently, if there are multiple instances of this graph being used, there will be no variable collision. It is therefore -suggested that all variables have the string <literal>self</literal> before +suggested that all variables have the string <literal>self.</literal> before them. Consequently, you would refer to the variable <literal>i</literal> as <literal>self.i</literal> </para> Modified: sofaswitch/trunk/callflow/docs/makedoc.xsl ============================================================================== --- sofaswitch/trunk/callflow/docs/makedoc.xsl (original) +++ sofaswitch/trunk/callflow/docs/makedoc.xsl Thu Jun 14 21:26:44 2007 @@ -1,6 +1,6 @@ <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> - <xsl:import href="/usr/share/xml/docbook/stylesheet/nwalsh/1.69.1/htmlhelp/htmlhelp.xsl"/> + <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/> <xsl:param name="htmlhelp.use.hhk" select="1"/> <xsl:param name="htmlhelp.button.next" select="1"/> <xsl:param name="htmlhelp.button.previous" select="1"/> @@ -17,3 +17,22 @@ <xsl:param name="use.id.as.filename" select="1"/> </xsl:stylesheet> + + + <!-- +The third line of the above file is such that everytime you run xsltproc with this file, it goes to the web to get +the .xsl file from sourceforge. If you don't have net access, you can use a different command. +Below are two equivalent commands. One is from a suse 10.2 box, the other from a suse 10.1 box. +If you use the command below, you may have to modify it according to your system. + + Make certain you have xsltproc installed. + + + <xsl:import href="/usr/share/xml/docbook/stylesheet/nwalsh/1.69.1/htmlhelp/htmlhelp.xsl"/> + + <xsl:import href="/usr/share/xml/docbook/stylesheet/nwalsh/1.71.1/htmlhelp/htmlhelp.xsl"/> +--> + + + +