[graphic-forms-cvs] r350 - trunk/docs/manual - graphic-forms-cvs@common-lisp.net - mailman3.common-lisp.net

19 Oct 2006

Author: junrue
Date: Wed Oct 18 21:57:02 2006
New Revision: 350
Added:
   trunk/docs/manual/gf-package.xsl
Removed:
   trunk/docs/manual/system-package.xml
Modified:
   trunk/docs/manual/Makefile
   trunk/docs/manual/gf-data.xsl
   trunk/docs/manual/gfs-symbols.xml
   trunk/docs/manual/graphic-forms.xml
Log:
Modified: trunk/docs/manual/Makefile
==============================================================================

--- trunk/docs/manual/Makefile	(original)
+++ trunk/docs/manual/Makefile	Wed Oct 18 21:57:02 2006
@@ -5,17 +5,20 @@
 # Copyright (c) 2006, Jack D. Unrue
 #
-COMMON-DEPS = gf-data.xsl clhs-table.xml win32-api-table.xml
+COMMON-DEPS = gf-data.xsl gf-package.xsl clhs-table.xml win32-api-table.xml
-TMP-XML     = gfs-tmp.xml
+TMP-XML     = gfs-tmp-pkg.xml gfs-tmp-syms.xml
XSLT-PROC   = xsltproc --nonet
-docs: gfs-tmp.xml
+docs: gfs-tmp-pkg.xml
    $(XSLT-PROC) graphic-forms.xsl graphic-forms.xml
    -hhc htmlhelp.hhp
-gfs-tmp.xml: gfs-symbols.xml $(COMMON-DEPS)
+gfs-tmp-pkg.xml: gfs-tmp-syms.xml $(COMMON-DEPS)
+	$(XSLT-PROC) --output $@ gf-package.xsl gfs-symbols.xml
+
+gfs-tmp-syms.xml: gfs-symbols.xml $(COMMON-DEPS)
    $(XSLT-PROC) --output $@ gf-data.xsl gfs-symbols.xml
clean:
Modified: trunk/docs/manual/gf-data.xsl
==============================================================================
--- trunk/docs/manual/gf-data.xsl	(original)
+++ trunk/docs/manual/gf-data.xsl	Wed Oct 18 21:57:02 2006
@@ -26,6 +26,23 @@
     </xsl:element>
   </xsl:template>
+  <xsl:template name="emit-page-type">
+    <xsl:param name="page-type"/>
+
+      <xsl:element name="para">
+        <xsl:attribute name="role">normal</xsl:attribute>
+        [<xsl:value-of select="../@name"/>]
+        <xsl:value-of select="$page-type"/>
+      </xsl:element>
+  </xsl:template>
+
+  <xsl:template match="para">
+    xsl:copy
+      <xsl:copy-of select="@*"/>
+      xsl:apply-templates/
+    </xsl:copy>
+  </xsl:template>
+
   <xsl:template name="emit-table">
     <xsl:param name="col2-width"/>
@@ -48,17 +65,8 @@
     </xsl:element>
   </xsl:template>
-  <xsl:template name="emit-page-type">
-    <xsl:param name="page-type"/>
-
-      <xsl:element name="para">
-        <xsl:attribute name="role">normal</xsl:attribute>
-        [<xsl:value-of select="../@name"/>]
-        <xsl:value-of select="$page-type"/>
-      </xsl:element>
-  </xsl:template>
-
-  <xsl:template name="emit-symbol-description">
+<!--
+  <xsl:template match="description">
     <xsl:element name="bridgehead">
       <xsl:attribute name="renderas">sect2</xsl:attribute>
       description
@@ -69,13 +77,7 @@
       <xsl:apply-templates/>
     </xsl:element>
   </xsl:template>
-
-  <xsl:template match="para">
-    <xsl:copy>
-      <xsl:copy-of select="@*"/>
-      <xsl:apply-templates/>
-    </xsl:copy>
-  </xsl:template>
+-->
<xsl:template match="refargument">
     <xsl:element name="emphasis">
@@ -272,7 +274,7 @@
     </xsl:element>
   </xsl:template>
-  <xsl:template match="structure/description">
+  <xsl:template match="/package/*/description">
     <xsl:element name="bridgehead">
       <xsl:attribute name="renderas">sect2</xsl:attribute>
       description
@@ -284,6 +286,7 @@
     </xsl:element>
   </xsl:template>
+<!--
   <xsl:template match="class/description">
     <xsl:element name="bridgehead">
       <xsl:attribute name="renderas">sect2</xsl:attribute>
@@ -309,20 +312,21 @@
   </xsl:template>
<xsl:template match="function/description">
-    <xsl:call-template name="emit-symbol-description"/>
+    <xsl:call-template name="emit-description"/>
   </xsl:template>
<xsl:template match="generic-function/description">
-    <xsl:call-template name="emit-symbol-description"/>
+    <xsl:call-template name="emit-description"/>
   </xsl:template>
<xsl:template match="slot-reader/description">
-    <xsl:call-template name="emit-symbol-description"/>
+    <xsl:call-template name="emit-description"/>
   </xsl:template>
<xsl:template match="slot-accessor/description">
-    <xsl:call-template name="emit-symbol-description"/>
+    <xsl:call-template name="emit-description"/>
   </xsl:template>
+-->
<xsl:template name="emit-type-section">
     <xsl:param name="page-type"/>
@@ -404,9 +408,11 @@
   </xsl:template>
<xsl:template match="/package">
-    xsl:apply-templates
-      <xsl:sort select="@name" order="ascending" case-order="upper-first"/>
-    </xsl:apply-templates>
+    <data>
+      xsl:apply-templates
+        <xsl:sort select="@name" order="ascending" case-order="upper-first"/>
+      </xsl:apply-templates>
+    </data>
   </xsl:template>
</xsl:stylesheet>
Added: trunk/docs/manual/gf-package.xsl
==============================================================================
--- (empty file)
+++ trunk/docs/manual/gf-package.xsl	Wed Oct 18 21:57:02 2006
@@ -0,0 +1,61 @@
+<!--
+    gf-package.xsl
+
+    Copyright (c) 2006, Jack D. Unrue
+-->
+
+<xsl:stylesheet
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  xmlns:exsl="http://exslt.org/common"
+  version="1.0">
+
+  <xsl:output method="xml" omit-xml-declaration="yes" indent="yes"/>
+
+  <xsl:template match="/package">
+    <chapter>
+      <title><xsl:value-of select="@fullname"/></title>
+
+      <para role="normal">[Package]</para>
+
+      <bridgehead renderas="sect2">nickname</bridgehead>
+      <para role="normal"><xsl:value-of select="@name"/></para>
+
+      <xsl:for-each select="description">
+        <xsl:element name="bridgehead">
+          <xsl:attribute name="renderas">sect2</xsl:attribute>
+          description
+        </xsl:element>
+
+        <xsl:element name="para">
+          <xsl:attribute name="role">normal</xsl:attribute>
+          <xsl:value-of select="."/>
+        </xsl:element>
+      </xsl:for-each>
+
+      <bridgehead renderas="sect2">classes and structures</bridgehead>
+      <para role="normal">
+        native-object, point, rectangle, size, span
+      </para>
+
+      <bridgehead renderas="sect2">accessors, functions, and macros</bridgehead>
+      <para role="normal">
+        code, copy-point, copy-rectangle, copy-size, copy-span, detail, dispose,
+        disposed-p, dlg-code, empty-span-p, equal-size-p, handle, location,
+        make-point, make-rectangle, make-size, make-span, point-x, point-y,
+        size, size-height, size-width, span-end, span-start
+      </para>
+
+      <bridgehead renderas="sect2">conditions</bridgehead>
+      <para role="normal">
+        comdlg-error, disposed-error, toolkit-error, toolkit-warning, win32-error,
+        win32-warning
+      </para>
+
+      <xsl:for-each select="document('gfs-tmp-syms.xml')/data/section">
+        <xsl:copy-of select="current()"/>
+      </xsl:for-each>
+
+    </chapter>
+  </xsl:template>
+
+</xsl:stylesheet>
Modified: trunk/docs/manual/gfs-symbols.xml
==============================================================================
--- trunk/docs/manual/gfs-symbols.xml	(original)
+++ trunk/docs/manual/gfs-symbols.xml	Wed Oct 18 21:57:02 2006
@@ -5,7 +5,14 @@
     Copyright (c) 2006, Jack D. Unrue
 -->
-<package name="gfs">
+<package name="gfs" fullname="graphic-forms.uitoolkit.system">
+
+  <description>
+    The symbols in this package correspond to system-level functionality,
+    such as foreign function declarations for the Win32 API. The majority
+    of symbols in this package are not exported, except for the
+    fundamental types, conditions, and functions listed below.
+  </description>
<!-- CONDITIONS -->
Modified: trunk/docs/manual/graphic-forms.xml
==============================================================================
--- trunk/docs/manual/graphic-forms.xml	(original)
+++ trunk/docs/manual/graphic-forms.xml	Wed Oct 18 21:57:02 2006
@@ -9,8 +9,7 @@
   <!ENTITY legal         SYSTEM "legal.xml">
   <!ENTITY introduction  SYSTEM "introduction.xml">
   <!ENTITY api           SYSTEM "api.xml">
-  <!ENTITY gfspkg        SYSTEM "system-package.xml">
-  <!ENTITY gfssymbols    SYSTEM "gfs-tmp.xml">     <!-- generated file -->
+  <!ENTITY gfspkg        SYSTEM "gfs-tmp-pkg.xml">      <!-- generated file -->
   <!ENTITY misctopics    SYSTEM "miscellaneous-topics.xml">
   <!ENTITY imdataplugins SYSTEM "image-data-plugins.xml">
   <!ENTITY glossary      SYSTEM "glossary.xml">

    