October 2006 - graphic-forms-cvs@common-lisp.net

[graphic-forms-cvs] r347 - in trunk/docs: manual website
by junrue＠common-lisp.net 18 Oct '06

18 Oct '06

Author: junrue Date: Wed Oct 18 16:37:02 2006 New Revision: 347 Modified: trunk/docs/manual/gf-data.xsl trunk/docs/manual/gfs-symbols.xml trunk/docs/manual/glossary.xml trunk/docs/manual/introduction.xml trunk/docs/website/index.html Log: Modified: trunk/docs/manual/gf-data.xsl ============================================================================== --- trunk/docs/manual/gf-data.xsl (original) +++ trunk/docs/manual/gf-data.xsl Wed Oct 18 16:37:02 2006 @@ -58,26 +58,6 @@ </xsl:element> </xsl:template> - <xsl:template name="emit-syntax"> - <xsl:element name="bridgehead"> - <xsl:attribute name="renderas">sect2</xsl:attribute> - syntax - </xsl:element> - - <xsl:element name="para"> - <xsl:attribute name="role">normal</xsl:attribute> - (<xsl:call-template name="create-id"/> - <xsl:element name="emphasis"> - <xsl:for-each select="arguments/argument"> - <xsl:value-of select="concat(' ', @name)"/> - </xsl:for-each> - </xsl:element>) => - <xsl:element name="emphasis"> - <xsl:value-of select="return/@type"/> - </xsl:element> - </xsl:element> - </xsl:template> - <xsl:template name="emit-symbol-description"> <xsl:element name="bridgehead"> <xsl:attribute name="renderas">sect2</xsl:attribute> @@ -90,19 +70,11 @@ </xsl:element> </xsl:template> - <xsl:template name="emit-ref-target"> - <xsl:param name="role">normal</xsl:param> - <xsl:choose> - <xsl:when test="$role='small'"> - <xsl:element name="para"> - <xsl:attribute name="role"><xsl:value-of select="$role"/></xsl:attribute> - <xsl:value-of select="."/> - </xsl:element> - </xsl:when> - <xsl:otherwise> - <xsl:value-of select="."/> - </xsl:otherwise> - </xsl:choose> + <xsl:template match="para"> + <xsl:copy> + <xsl:copy-of select="@*"/> + <xsl:apply-templates/> + </xsl:copy> </xsl:template> <xsl:template match="refargument"> @@ -112,38 +84,56 @@ </xsl:template> <xsl:template match="reftopic"> - <xsl:param name="role">normal</xsl:param> <xsl:element name="link"> <xsl:attribute name="linkend"><xsl:value-of select="."/></xsl:attribute> - <xsl:call-template name="emit-ref-target"> - <xsl:with-param name="role"><xsl:value-of select="$role"/></xsl:with-param> - </xsl:call-template> + <xsl:choose> + <xsl:when test="@label"> + <xsl:value-of select="@label"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="."/> + </xsl:otherwise> + </xsl:choose> </xsl:element> </xsl:template> <xsl:template match="refclhs"> - <xsl:param name="role">normal</xsl:param> <xsl:variable name="tmp" select="string()"/> <xsl:element name="ulink"> <xsl:attribute name="url"> <xsl:value-of select="$clhs-table//entry[string(@name)=$tmp]/@url"/> </xsl:attribute> - <xsl:call-template name="emit-ref-target"> - <xsl:with-param name="role"><xsl:value-of select="$role"/></xsl:with-param> - </xsl:call-template> + <xsl:value-of select="."/> </xsl:element> </xsl:template> <xsl:template match="refwin32api"> - <xsl:param name="role">normal</xsl:param> <xsl:variable name="tmp" select="string()"/> <xsl:element name="ulink"> <xsl:attribute name="url"> <xsl:value-of select="$win32-table//entry[string(@name)=$tmp]/@url"/> </xsl:attribute> - <xsl:call-template name="emit-ref-target"> - <xsl:with-param name="role"><xsl:value-of select="$role"/></xsl:with-param> - </xsl:call-template> + <xsl:value-of select="."/> + </xsl:element> + </xsl:template> + + <xsl:template match="syntax"> + <xsl:element name="bridgehead"> + <xsl:attribute name="renderas">sect2</xsl:attribute> + syntax + </xsl:element> + + <xsl:element name="para"> + <xsl:attribute name="role">normal</xsl:attribute> + (<xsl:call-template name="create-id"/> + <xsl:element name="emphasis"> + <xsl:for-each select="arguments/argument"> + <xsl:value-of select="concat(' ', @name)"/> + </xsl:for-each> + </xsl:element>) => + <xsl:element name="emphasis"> + <xsl:apply-templates select="return"/> + </xsl:element> </xsl:element> </xsl:template> @@ -200,15 +190,17 @@ <xsl:element name="entry"> <xsl:attribute name="valign">top</xsl:attribute> <xsl:element name="para"> - <xsl:attribute name="role">small</xsl:attribute> + <xsl:attribute name="role">normal</xsl:attribute> inherits: </xsl:element> </xsl:element> <xsl:element name="entry"> <xsl:attribute name="valign">top</xsl:attribute> - <xsl:apply-templates> - <xsl:with-param name="role">small</xsl:with-param> - </xsl:apply-templates> + <xsl:for-each select="*"> + <xsl:sort select="substring-after(.,':')" order="ascending" case-order="upper-first"/> + <xsl:apply-templates select="."/> + <xsl:if test="not(position()=last())">, </xsl:if> + </xsl:for-each> </xsl:element> </xsl:element> </xsl:template> @@ -218,15 +210,17 @@ <xsl:element name="entry"> <xsl:attribute name="valign">top</xsl:attribute> <xsl:element name="para"> - <xsl:attribute name="role">small</xsl:attribute> + <xsl:attribute name="role">normal</xsl:attribute> inherited by: </xsl:element> </xsl:element> <xsl:element name="entry"> <xsl:attribute name="valign">top</xsl:attribute> - <xsl:apply-templates> - <xsl:with-param name="role">small</xsl:with-param> - </xsl:apply-templates> + <xsl:for-each select="*"> + <xsl:sort select="substring-after(.,':')" order="ascending" case-order="upper-first"/> + <xsl:apply-templates select="."/> + <xsl:if test="not(position()=last())">, </xsl:if> + </xsl:for-each> </xsl:element> </xsl:element> </xsl:template> @@ -247,12 +241,25 @@ <xsl:attribute name="role">normal</xsl:attribute> <xsl:for-each select="*"> + <xsl:sort select="substring-after(.,':')" order="ascending" case-order="upper-first"/> <xsl:apply-templates select="."/> <xsl:if test="not(position()=last())">, </xsl:if> </xsl:for-each> </xsl:element> </xsl:template> + <xsl:template match="structure/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:apply-templates/> + </xsl:element> + </xsl:template> + <xsl:template match="class/description"> <xsl:element name="bridgehead"> <xsl:attribute name="renderas">sect2</xsl:attribute> @@ -318,8 +325,6 @@ <xsl:with-param name="page-type">[<xsl:value-of select="$page-type"/>]</xsl:with-param> </xsl:call-template> - <xsl:call-template name="emit-syntax"/> - <xsl:apply-templates/> </xsl:element> </xsl:template> @@ -330,6 +335,12 @@ </xsl:call-template> </xsl:template> + <xsl:template match="structure"> + <xsl:call-template name="emit-type-section"> + <xsl:with-param name="page-type">Structure</xsl:with-param> + </xsl:call-template> + </xsl:template> + <xsl:template match="condition"> <xsl:call-template name="emit-type-section"> <xsl:with-param name="page-type">Condition</xsl:with-param> Modified: trunk/docs/manual/gfs-symbols.xml ============================================================================== --- trunk/docs/manual/gfs-symbols.xml (original) +++ trunk/docs/manual/gfs-symbols.xml Wed Oct 18 16:37:02 2006 @@ -7,6 +7,8 @@ <package name="gfs"> +  + <condition name="toolkit-error"> <description> <hierarchy> @@ -159,20 +161,217 @@ </seealso> </condition> - <slot-reader name="code"> - <arguments> - <argument name="condition"> +  + + <class name="native-object"> + <description> + <hierarchy> + <inheritedby> + <reftopic>gfw:display</reftopic> + <reftopic>gfg:image-data-plugin</reftopic> + <reftopic>gfg:image</reftopic> + <reftopic>gfg:icon-bundle</reftopic> + <reftopic>gfg:graphics-context</reftopic> + <reftopic>gfg:font</reftopic> + <reftopic>gfw:event-source</reftopic> + </inheritedby> + </hierarchy> + <para role="normal"> + This is the abstract base class for objects representing a system resource + such as a window or device context. + </para> + + <para role="normal"> + Graphic-Forms does not register any finalizer for coordination with the + garbage collector, since the destruction of these system resources has + important application semantics which cannot be postponed. Also, there + are often related system resources (especially other native handles) that + occupy scarce heap space within system components, so these must be cleaned + up promptly as well. + </para> + </description> + <initargs> + <argument name=":handle"> + <description> + A Win32 HANDLE or foreign pointer. + </description> + </argument> + </initargs> + <seealso> + <reftopic>gfs:dispose</reftopic> + <reftopic>gfs:handle</reftopic> + <reftopic>gfs:disposed-error</reftopic> + <reftopic>gfs:disposed-p</reftopic> + </seealso> + </class> + +  + + <structure name="point"> + <description> + This structure represents a point in the Cartesian plane. + </description> + <initargs> + <argument name=":x"> + <description> + An <refclhs>integer</refclhs> specifying the point's X coordinate. + </description> + </argument> + <argument name=":y"> + <description> + An <refclhs>integer</refclhs> specifying the point's Y coordinate. + </description> + </argument> + </initargs> + <seealso> + <reftopic>gfs:copy-point</reftopic> + <reftopic>gfs:make-point</reftopic> + <reftopic>gfs:point-x</reftopic> + <reftopic>gfs:point-y</reftopic> + </seealso> + </structure> + + <structure name="rectangle"> + <description> + This structure represents a rectangle in the Cartesian plane. + </description> + <initargs> + <argument name=":location"> + <description> + A <reftopic>gfs:point</reftopic> specifying the rectangle's upper-left + corner. + </description> + </argument> + <argument name=":size"> + <description> + A <reftopic>gfs:size</reftopic> specifying the rectangle's dimensions. + </description> + </argument> + </initargs> + <seealso> + <reftopic>gfs:copy-rectangle</reftopic> + <reftopic>gfs:location</reftopic> + <reftopic>gfs:make-rectangle</reftopic> + <reftopic>gfs:size</reftopic> + </seealso> + </structure> + + <structure name="size"> + <description> + This structure represents a 2-dimensional area. + </description> + <initargs> + <argument name=":height"> <description> - The <reftopic>gfs:win32-error</reftopic> or <reftopic>gfs:win32-warning</reftopic> - object to be queried. + An <refclhs>integer</refclhs> specifying the height of the area. </description> </argument> - </arguments> - <return type="integer"/> + <argument name=":width"> + <description> + An <refclhs>integer</refclhs> specifying the width of the area. + </description> + </argument> + </initargs> + <seealso> + <reftopic>gfs:copy-size</reftopic> + <reftopic>gfs:equal-size-p</reftopic> + <reftopic>gfs:make-size</reftopic> + <reftopic>gfs:size-height</reftopic> + <reftopic>gfs:size-width</reftopic> + <reftopic>gfs:rectangle</reftopic> + </seealso> + </structure> + + <structure name="span"> + <description> + This structure represents a contiguous range of <refclhs>integer</refclhs> + values. + </description> + <initargs> + <argument name=":start"> + <description> + An <refclhs>integer</refclhs> specifying the starting value. + </description> + </argument> + <argument name=":end"> + <description> + An <refclhs>integer</refclhs> specifying the ending value. + </description> + </argument> + </initargs> + <seealso> + <reftopic>gfs:copy-span</reftopic> + <reftopic>gfs:empty-span-p</reftopic> + <reftopic>gfs:make-span</reftopic> + <reftopic>gfs:span-start</reftopic> + <reftopic>gfs:span-end</reftopic> + </seealso> + </structure> + +  + + <slot-reader name="code"> + <syntax> + <arguments> + <argument name="condition"> + <description> + The <reftopic>gfs:win32-error</reftopic> or <reftopic>gfs:win32-warning</reftopic> + object to be queried. + </description> + </argument> + </arguments> + <return> + <refclhs>integer</refclhs> + </return> + </syntax> <description> Returns the Win32 error code for <refargument>condition</refargument> as determined by <refwin32api>GetLastError</refwin32api>. </description> </slot-reader> + <slot-reader name="copy-point"> + <syntax> + <arguments> + <argument name="point"> + <description> + The <reftopic>gfs:point</reftopic> structure to be copied. + </description> + </argument> + </arguments> + <return> + <reftopic label="new point">gfs:point</reftopic> + </return> + </syntax> + <description> + Returns a new <reftopic>gfs:point</reftopic> whose X and Y coordinates + were copied from the original. + </description> + <seealso> + <reftopic>gfs:make-point</reftopic> + </seealso> + </slot-reader> + + <slot-reader name="copy-rectangle"> + <syntax> + <arguments> + <argument name="rectangle"> + <description> + The <reftopic>gfs:rectangle</reftopic> structure to be copied. + </description> + </argument> + </arguments> + <return> + <reftopic label="new rectangle">gfs:rectangle</reftopic> + </return> + </syntax> + <description> + Returns a new <reftopic>gfs:rectangle</reftopic> whose location and + dimension values were (shallow) copied from the original. + </description> + <seealso> + <reftopic>gfs:make-rectangle</reftopic> + </seealso> + </slot-reader> + </package> Modified: trunk/docs/manual/glossary.xml ============================================================================== --- trunk/docs/manual/glossary.xml (original) +++ trunk/docs/manual/glossary.xml Wed Oct 18 16:37:02 2006 @@ -3,9 +3,10 @@ Copyright (c) 2006, Jack D. Unrue --> -<glossary><title>Glossary</title> +<glossary id="glossary"><title>Glossary</title> +<indexterm><primary>Glossary</primary></indexterm> -<glossdiv><title>A</title> +<glossdiv id="glossary-A"><title>A</title> <glossentry id="accelerator"><glossterm>accelerator</glossterm> <glossdef> @@ -35,10 +36,10 @@ </glossdiv> -<glossdiv><title>B</title> +<glossdiv id="glossary-B"><title>B</title> </glossdiv> -<glossdiv><title>C</title> +<glossdiv id="glossary-C"><title>C</title> <glossentry id="control"><glossterm>control</glossterm> <glossdef> @@ -52,7 +53,7 @@ </glossdiv> -<glossdiv><title>D</title> +<glossdiv id="glossary-D"><title>D</title> <glossentry id="default action"><glossterm>default action</glossterm> <glossdef> @@ -81,7 +82,7 @@ </glossdiv> -<glossdiv><title>E</title> +<glossdiv id="glossary-E"><title>E</title> <glossentry id="extension"><glossterm>extension</glossterm> <glossdef> @@ -98,28 +99,28 @@ </glossdiv> -<glossdiv><title>F</title> +<glossdiv id="glossary-F"><title>F</title> </glossdiv> -<glossdiv><title>G</title> +<glossdiv id="glossary-G"><title>G</title> </glossdiv> -<glossdiv><title>H</title> +<glossdiv id="glossary-H"><title>H</title> </glossdiv> -<glossdiv><title>I</title> +<glossdiv id="glossary-I"><title>I</title> </glossdiv> -<glossdiv><title>J</title> +<glossdiv id="glossary-J"><title>J</title> </glossdiv> -<glossdiv><title>K</title> +<glossdiv id="glossary-K"><title>K</title> </glossdiv> -<glossdiv><title>L</title> +<glossdiv id="glossary-L"><title>L</title> </glossdiv> -<glossdiv><title>M</title> +<glossdiv id="glossary-M"><title>M</title> <glossentry id="menu"><glossterm>menu</glossterm> <glossdef> @@ -132,7 +133,7 @@ </glossdef> </glossentry> - <glossentry id="mix-in class"><glossterm>mix-in class</glossterm> + <glossentry id="mix-in"><glossterm>mix-in class</glossterm> <glossdef> <para> A mix-in class represents a specific abstraction that complements @@ -155,13 +156,13 @@ </glossentry> </glossdiv> -<glossdiv><title>N</title> +<glossdiv id="glossary-N"><title>N</title> </glossdiv> -<glossdiv><title>O</title> +<glossdiv id="glossary-O"><title>O</title> </glossdiv> -<glossdiv><title>P</title> +<glossdiv id="glossary-P"><title>P</title> <glossentry id="plugin"><glossterm>plugin</glossterm> <glossdef> @@ -177,34 +178,34 @@ </glossdiv> -<glossdiv><title>Q</title> +<glossdiv id="glossary-Q"><title>Q</title> </glossdiv> -<glossdiv><title>R</title> +<glossdiv id="glossary-R"><title>R</title> </glossdiv> -<glossdiv><title>S</title> +<glossdiv id="glossary-S"><title>S</title> </glossdiv> -<glossdiv><title>T</title> +<glossdiv id="glossary-T"><title>T</title> </glossdiv> -<glossdiv><title>U</title> +<glossdiv id="glossary-U"><title>U</title> </glossdiv> -<glossdiv><title>V</title> +<glossdiv id="glossary-V"><title>V</title> </glossdiv> -<glossdiv><title>W</title> +<glossdiv id="glossary-W"><title>W</title> </glossdiv> -<glossdiv><title>X</title> +<glossdiv id="glossary-X"><title>X</title> </glossdiv> -<glossdiv><title>Y</title> +<glossdiv id="glossary-Y"><title>Y</title> </glossdiv> -<glossdiv><title>Z</title> +<glossdiv id="glossary-Z"><title>Z</title> </glossdiv> </glossary> Modified: trunk/docs/manual/introduction.xml ============================================================================== --- trunk/docs/manual/introduction.xml (original) +++ trunk/docs/manual/introduction.xml Wed Oct 18 16:37:02 2006 @@ -5,10 +5,10 @@ --> <chapter> <title>Introduction</title> + <indexterm><primary>Introduction</primary></indexterm> <bridgehead renderas="sect2">Background</bridgehead> <para role="normal"> - <indexterm><primary>Introduction</primary></indexterm> Graphic-Forms is a user interface library implemented in Common Lisp focusing on the Windows platform. Graphic-Forms is licensed under the terms of the BSD License. The goal is to provide a Common Lisp-based Modified: trunk/docs/website/index.html ============================================================================== --- trunk/docs/website/index.html (original) +++ trunk/docs/website/index.html Wed Oct 18 16:37:02 2006 @@ -10,7 +10,7 @@ <body> <div class="header"> <h1>Graphic-Forms</h1> - <h2>A user interface toolkit for the Windows platform.</h2> + <h2>A user interface toolkit for Windows.</h2> </div> <div class="NavBar">

1 0

[graphic-forms-cvs] r346 - in trunk: docs/manual src/uitoolkit/widgets
by junrue＠common-lisp.net 18 Oct '06

18 Oct '06

Author: junrue Date: Wed Oct 18 14:16:10 2006 New Revision: 346 Added: trunk/docs/manual/gfs-symbols.xml Removed: trunk/docs/manual/gfs-function-data.xml trunk/docs/manual/gfs-type-data.xml Modified: trunk/docs/manual/Makefile trunk/docs/manual/clhs-table.xml trunk/docs/manual/gf-data.xsl trunk/docs/manual/graphic-forms.xml trunk/docs/manual/system-package.xml trunk/docs/manual/win32-api-table.xml trunk/src/uitoolkit/widgets/scrolling-event-dispatcher.lisp Log: Modified: trunk/docs/manual/Makefile ============================================================================== --- trunk/docs/manual/Makefile (original) +++ trunk/docs/manual/Makefile Wed Oct 18 14:16:10 2006 @@ -7,22 +7,19 @@ COMMON-DEPS = gf-data.xsl clhs-table.xml win32-api-table.xml -INTERIM-XML = system-types.xml system-functions.xml +TMP-XML = gfs-tmp.xml XSLT-PROC = xsltproc --nonet -docs: system-types.xml system-functions.xml +docs: gfs-tmp.xml $(XSLT-PROC) graphic-forms.xsl graphic-forms.xml -hhc htmlhelp.hhp -system-types.xml: gfs-type-data.xml $(COMMON-DEPS) - $(XSLT-PROC) --output $@ gf-data.xsl gfs-type-data.xml - -system-functions.xml: gfs-function-data.xml $(COMMON-DEPS) - $(XSLT-PROC) --output $@ gf-data.xsl gfs-function-data.xml +gfs-tmp.xml: gfs-symbols.xml $(COMMON-DEPS) + $(XSLT-PROC) --output $@ gf-data.xsl gfs-symbols.xml clean: - rm -f $(INTERIM-XML) + rm -f $(TMP-XML) find . $ -name "*~" -o -name "*.html" -o -name "*.hhk" -o -name "*.hhc" -o -name "*.hhp" $ -exec rm {} \; scrub: clean Modified: trunk/docs/manual/clhs-table.xml ============================================================================== --- trunk/docs/manual/clhs-table.xml (original) +++ trunk/docs/manual/clhs-table.xml Wed Oct 18 14:16:10 2006 @@ -6,7 +6,8 @@ --> <clhs-table> - <entry name="error" url="http://www.lispworks.com/documentation/HyperSpec/Body/e_error.htm"/> - <entry name="list" url="http://www.lispworks.com/documentation/HyperSpec/Body/t_list.htm"/> - <entry name="string" url="http://www.lispworks.com/documentation/HyperSpec/Body/t_string.htm"/> + <entry name="error" url="http://www.lispworks.com/documentation/HyperSpec/Body/e_error.htm"/> + <entry name="list" url="http://www.lispworks.com/documentation/HyperSpec/Body/t_list.htm"/> + <entry name="string" url="http://www.lispworks.com/documentation/HyperSpec/Body/t_string.htm"/> + <entry name="warning" url="http://www.lispworks.com/documentation/HyperSpec/Body/e_warnin.htm"/> </clhs-table> Modified: trunk/docs/manual/gf-data.xsl ============================================================================== --- trunk/docs/manual/gf-data.xsl (original) +++ trunk/docs/manual/gf-data.xsl Wed Oct 18 14:16:10 2006 @@ -40,7 +40,9 @@ <xsl:attribute name="colwidth"><xsl:value-of select="$col2-width"/></xsl:attribute> </xsl:element> <xsl:element name="tbody"> - <xsl:apply-templates/> + <xsl:apply-templates> + <xsl:sort select="@name" order="ascending" case-order="upper-first"/> + </xsl:apply-templates> </xsl:element> </xsl:element> </xsl:element> @@ -51,6 +53,7 @@ <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> @@ -180,6 +183,13 @@ <xsl:attribute name="renderas">sect2</xsl:attribute> initargs </xsl:element> + <xsl:for-each select="argument"> + <xsl:element name="indexterm"> + <xsl:element name="primary"> + <xsl:value-of select="@name"/> + </xsl:element> + </xsl:element> + </xsl:for-each> <xsl:call-template name="emit-table"> <xsl:with-param name="col2-width">5*</xsl:with-param> </xsl:call-template> @@ -283,9 +293,7 @@ <xsl:call-template name="emit-index-term"/> - <xsl:element name="title"> - <xsl:call-template name="create-id"/> - </xsl:element> + <xsl:element name="title"><xsl:value-of select="@name"/></xsl:element> <xsl:call-template name="emit-page-type"> <xsl:with-param name="page-type">[<xsl:value-of select="$page-type"/>]</xsl:with-param> @@ -304,9 +312,7 @@ <xsl:call-template name="emit-index-term"/> - <xsl:element name="title"> - <xsl:call-template name="create-id"/> - </xsl:element> + <xsl:element name="title"><xsl:value-of select="@name"/></xsl:element> <xsl:call-template name="emit-page-type"> <xsl:with-param name="page-type">[<xsl:value-of select="$page-type"/>]</xsl:with-param> @@ -318,28 +324,34 @@ </xsl:element> </xsl:template> - <xsl:template match="/package/class"> + <xsl:template match="class"> <xsl:call-template name="emit-type-section"> <xsl:with-param name="page-type">Class</xsl:with-param> </xsl:call-template> </xsl:template> - <xsl:template match="/package/condition"> + <xsl:template match="condition"> <xsl:call-template name="emit-type-section"> <xsl:with-param name="page-type">Condition</xsl:with-param> </xsl:call-template> </xsl:template> - <xsl:template match="/package/slot-accessor"> + <xsl:template match="slot-accessor"> <xsl:call-template name="emit-function-section"> <xsl:with-param name="page-type">Slot Accessor</xsl:with-param> </xsl:call-template> </xsl:template> - <xsl:template match="/package/slot-reader"> + <xsl:template match="slot-reader"> <xsl:call-template name="emit-function-section"> <xsl:with-param name="page-type">Slot Reader</xsl:with-param> </xsl:call-template> </xsl:template> + <xsl:template match="/package"> + <xsl:apply-templates> + <xsl:sort select="@name" order="ascending" case-order="upper-first"/> + </xsl:apply-templates> + </xsl:template> + </xsl:stylesheet> Added: trunk/docs/manual/gfs-symbols.xml ============================================================================== --- (empty file) +++ trunk/docs/manual/gfs-symbols.xml Wed Oct 18 14:16:10 2006 @@ -0,0 +1,178 @@ +<?xml version="1.0"?> + + +<package name="gfs"> + + <condition name="toolkit-error"> + <description> + <hierarchy> + <inherits> + <refclhs>error</refclhs> + </inherits> + <inheritedby> + <reftopic>gfs:win32-error</reftopic> + </inheritedby> + </hierarchy> + This error is raised to indicate invalid argument values or inconsistent + state. + </description> + <initargs> + <argument name=":detail"> + <description> + A <refclhs>string</refclhs> supplying additional problem information. + </description> + </argument> + </initargs> + <seealso> + <reftopic>gfs:detail</reftopic> + <reftopic>gfs:toolkit-warning</reftopic> + <reftopic>gfs:win32-warning</reftopic> + </seealso> + </condition> + + <condition name="toolkit-warning"> + <description> + <hierarchy> + <inherits> + <refclhs>warning</refclhs> + </inherits> + <inheritedby> + <reftopic>gfs:win32-warning</reftopic> + </inheritedby> + </hierarchy> + This warning is raised to indicate non-fatal problems that nevertheless + may represent application logic errors. + </description> + <initargs> + <argument name=":detail"> + <description> + A <refclhs>string</refclhs> supplying additional problem information. + </description> + </argument> + </initargs> + <seealso> + <reftopic>gfs:detail</reftopic> + <reftopic>gfs:toolkit-error</reftopic> + <reftopic>gfs:win32-error</reftopic> + </seealso> + </condition> + + <condition name="win32-error"> + <description> + <hierarchy> + <inherits> + <reftopic>gfs:toolkit-error</reftopic> + </inherits> + <inheritedby> + <reftopic>gfs:comdlg-error</reftopic> + </inheritedby> + </hierarchy> + This error is raised to indicate that a Win32 API function has failed. + </description> + <initargs> + <argument name=":code"> + <description> + The error code returned by <refwin32api>GetLastError</refwin32api>. + </description> + </argument> + <argument name=":detail"> + <description> + See <reftopic>gfs:toolkit-error</reftopic>. + </description> + </argument> + </initargs> + <seealso> + <reftopic>gfs:code</reftopic> + <reftopic>gfs:detail</reftopic> + <reftopic>gfs:toolkit-warning</reftopic> + <reftopic>gfs:win32-warning</reftopic> + </seealso> + </condition> + + <condition name="win32-warning"> + <description> + <hierarchy> + <inherits> + <reftopic>gfs:toolkit-warning</reftopic> + </inherits> + </hierarchy> + This warning is reported when a Win32 API function has failed in a + non-fatal manner which may indicate a logic error on the part of + the application. + </description> + <initargs> + <argument name=":code"> + <description> + The error code returned by <refwin32api>GetLastError</refwin32api>. + </description> + </argument> + <argument name=":detail"> + <description> + See <reftopic>gfs:toolkit-error</reftopic>. + </description> + </argument> + </initargs> + <seealso> + <reftopic>gfs:code</reftopic> + <reftopic>gfs:detail</reftopic> + <reftopic>gfs:toolkit-error</reftopic> + <reftopic>gfs:win32-error</reftopic> + </seealso> + </condition> + + <condition name="comdlg-error"> + <description> + <hierarchy> + <inherits> + <reftopic>gfs:win32-error</reftopic> + </inherits> + </hierarchy> + This error is raised to indicate that a Win32 Common Dialog API function + has failed. + </description> + <initargs> + <argument name=":dlg-code"> + <description> + The error code returned by <refwin32api>CommDlgExtendedError</refwin32api>. + </description> + </argument> + <argument name=":code"> + <description> + See <reftopic>gfs:win32-error</reftopic>. + </description> + </argument> + <argument name=":detail"> + <description> + See <reftopic>gfs:toolkit-error</reftopic>. + </description> + </argument> + </initargs> + <seealso> + <reftopic>gfs:code</reftopic> + <reftopic>gfs:detail</reftopic> + <reftopic>gfs:toolkit-warning</reftopic> + <reftopic>gfs:win32-warning</reftopic> + </seealso> + </condition> + + <slot-reader name="code"> + <arguments> + <argument name="condition"> + <description> + The <reftopic>gfs:win32-error</reftopic> or <reftopic>gfs:win32-warning</reftopic> + object to be queried. + </description> + </argument> + </arguments> + <return type="integer"/> + <description> + Returns the Win32 error code for <refargument>condition</refargument> + as determined by <refwin32api>GetLastError</refwin32api>. + </description> + </slot-reader> + +</package> Modified: trunk/docs/manual/graphic-forms.xml ============================================================================== --- trunk/docs/manual/graphic-forms.xml (original) +++ trunk/docs/manual/graphic-forms.xml Wed Oct 18 14:16:10 2006 @@ -10,8 +10,7 @@ <!ENTITY introduction SYSTEM "introduction.xml"> <!ENTITY api SYSTEM "api.xml"> <!ENTITY gfspkg SYSTEM "system-package.xml"> - <!ENTITY gfstypes SYSTEM "system-types.xml">  - <!ENTITY gfsfuncs SYSTEM "system-functions.xml">  + <!ENTITY gfssymbols SYSTEM "gfs-tmp.xml">  <!ENTITY misctopics SYSTEM "miscellaneous-topics.xml"> <!ENTITY imdataplugins SYSTEM "image-data-plugins.xml"> <!ENTITY glossary SYSTEM "glossary.xml"> @@ -19,10 +18,12 @@ <book> <title>Graphic-Forms</title> - <subtitle>Programming Reference (version 0.6)</subtitle> + <subtitle> + A Common Lisp user interface toolkit for Windows. + </subtitle> <bridgehead renderas="sect2"> - A Common Lisp user interface toolkit for the Windows platform. + Programming Reference (version 0.6) </bridgehead> Modified: trunk/docs/manual/system-package.xml ============================================================================== --- trunk/docs/manual/system-package.xml (original) +++ trunk/docs/manual/system-package.xml Wed Oct 18 14:16:10 2006 @@ -38,7 +38,6 @@ win32-warning </para> - &gfstypes; - &gfsfuncs; + &gfssymbols; </chapter> Modified: trunk/docs/manual/win32-api-table.xml ============================================================================== --- trunk/docs/manual/win32-api-table.xml (original) +++ trunk/docs/manual/win32-api-table.xml Wed Oct 18 14:16:10 2006 @@ -6,5 +6,6 @@ --> <win32-api-table> - <entry name="GetLastError" url="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/debug/base…"/> + <entry name="CommDlgExtendedError" url="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winui/winu…"/> + <entry name="GetLastError" url="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/debug/base…"/> </win32-api-table> Modified: trunk/src/uitoolkit/widgets/scrolling-event-dispatcher.lisp ============================================================================== --- trunk/src/uitoolkit/widgets/scrolling-event-dispatcher.lisp (original) +++ trunk/src/uitoolkit/widgets/scrolling-event-dispatcher.lisp Wed Oct 18 14:16:10 2006 @@ -131,7 +131,6 @@ ;;; (defmethod event-pre-resize ((disp scrolling-event-dispatcher) (window window) rect type) - (declare (ignore type)) (let ((h-step (gfs:size-width (step-increments disp))) (v-step (gfs:size-height (step-increments disp))) (outer-size (gfw:size window))

1 0

[graphic-forms-cvs] r345 - trunk/docs/manual
by junrue＠common-lisp.net 18 Oct '06

18 Oct '06

Author: junrue Date: Wed Oct 18 03:46:35 2006 New Revision: 345 Removed: trunk/docs/manual/ApiReference.html trunk/docs/manual/ConstantsAndVariables.html trunk/docs/manual/Footnotes.html trunk/docs/manual/Glossary.html trunk/docs/manual/Graphic-FormsProgrammingReference.wcp trunk/docs/manual/GraphicsPackage.html trunk/docs/manual/ImageDataPlugins.html trunk/docs/manual/Introduction.html trunk/docs/manual/LegalInfo.html trunk/docs/manual/MiscellaneousTopics.html trunk/docs/manual/Prerequisites.html trunk/docs/manual/Support.html trunk/docs/manual/SystemPackage.html trunk/docs/manual/TerminologyConventions.html trunk/docs/manual/WidgetsPackage.html Modified: trunk/docs/manual/gf-data.xsl trunk/docs/manual/gfs-function-data.xml trunk/docs/manual/gfs-type-data.xml trunk/docs/manual/graphic-forms.css Log: Modified: trunk/docs/manual/gf-data.xsl ============================================================================== --- trunk/docs/manual/gf-data.xsl (original) +++ trunk/docs/manual/gf-data.xsl Wed Oct 18 03:46:35 2006 @@ -18,6 +18,14 @@ <xsl:value-of select="concat(../@name,':',@name)"/> </xsl:template> + <xsl:template name="emit-index-term"> + <xsl:element name="indexterm"> + <xsl:element name="primary"> + <xsl:value-of select="@name"/> + </xsl:element> + </xsl:element> + </xsl:template> + <xsl:template name="emit-table"> <xsl:param name="col2-width"/> @@ -79,6 +87,21 @@ </xsl:element> </xsl:template> + <xsl:template name="emit-ref-target"> + <xsl:param name="role">normal</xsl:param> + <xsl:choose> + <xsl:when test="$role='small'"> + <xsl:element name="para"> + <xsl:attribute name="role"><xsl:value-of select="$role"/></xsl:attribute> + <xsl:value-of select="."/> + </xsl:element> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="."/> + </xsl:otherwise> + </xsl:choose> + </xsl:template> + <xsl:template match="refargument"> <xsl:element name="emphasis"> <xsl:value-of select="."/> @@ -86,29 +109,38 @@ </xsl:template> <xsl:template match="reftopic"> + <xsl:param name="role">normal</xsl:param> <xsl:element name="link"> <xsl:attribute name="linkend"><xsl:value-of select="."/></xsl:attribute> - <xsl:value-of select="."/> + <xsl:call-template name="emit-ref-target"> + <xsl:with-param name="role"><xsl:value-of select="$role"/></xsl:with-param> + </xsl:call-template> </xsl:element> </xsl:template> <xsl:template match="refclhs"> + <xsl:param name="role">normal</xsl:param> <xsl:variable name="tmp" select="string()"/> <xsl:element name="ulink"> <xsl:attribute name="url"> <xsl:value-of select="$clhs-table//entry[string(@name)=$tmp]/@url"/> </xsl:attribute> - <xsl:value-of select="."/> + <xsl:call-template name="emit-ref-target"> + <xsl:with-param name="role"><xsl:value-of select="$role"/></xsl:with-param> + </xsl:call-template> </xsl:element> </xsl:template> <xsl:template match="refwin32api"> + <xsl:param name="role">normal</xsl:param> <xsl:variable name="tmp" select="string()"/> <xsl:element name="ulink"> <xsl:attribute name="url"> <xsl:value-of select="$win32-table//entry[string(@name)=$tmp]/@url"/> </xsl:attribute> - <xsl:value-of select="."/>() + <xsl:call-template name="emit-ref-target"> + <xsl:with-param name="role"><xsl:value-of select="$role"/></xsl:with-param> + </xsl:call-template> </xsl:element> </xsl:template> @@ -154,19 +186,47 @@ </xsl:template> <xsl:template match="inherits"> - <xsl:element name="para"> - <xsl:attribute name="role">normal</xsl:attribute> - inherits:<xsl:apply-templates/> + <xsl:element name="row"> + <xsl:element name="entry"> + <xsl:attribute name="valign">top</xsl:attribute> + <xsl:element name="para"> + <xsl:attribute name="role">small</xsl:attribute> + inherits: + </xsl:element> + </xsl:element> + <xsl:element name="entry"> + <xsl:attribute name="valign">top</xsl:attribute> + <xsl:apply-templates> + <xsl:with-param name="role">small</xsl:with-param> + </xsl:apply-templates> + </xsl:element> </xsl:element> </xsl:template> <xsl:template match="inheritedby"> - <xsl:element name="para"> - <xsl:attribute name="role">normal</xsl:attribute> - inherited by:<xsl:apply-templates/> + <xsl:element name="row"> + <xsl:element name="entry"> + <xsl:attribute name="valign">top</xsl:attribute> + <xsl:element name="para"> + <xsl:attribute name="role">small</xsl:attribute> + inherited by: + </xsl:element> + </xsl:element> + <xsl:element name="entry"> + <xsl:attribute name="valign">top</xsl:attribute> + <xsl:apply-templates> + <xsl:with-param name="role">small</xsl:with-param> + </xsl:apply-templates> + </xsl:element> </xsl:element> </xsl:template> + <xsl:template match="hierarchy"> + <xsl:call-template name="emit-table"> + <xsl:with-param name="col2-width">8*</xsl:with-param> + </xsl:call-template> + </xsl:template> + <xsl:template match="*/seealso"> <xsl:element name="bridgehead"> <xsl:attribute name="renderas">sect2</xsl:attribute> @@ -195,20 +255,34 @@ </xsl:element> </xsl:template> - <xsl:template match="slot-accessor/description"> - <xsl:call-template name="emit-symbol-description"/> + <xsl:template match="condition/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:apply-templates/> + </xsl:element> </xsl:template> <xsl:template match="slot-reader/description"> <xsl:call-template name="emit-symbol-description"/> </xsl:template> + <xsl:template match="slot-accessor/description"> + <xsl:call-template name="emit-symbol-description"/> + </xsl:template> + <xsl:template name="emit-type-section"> <xsl:param name="page-type"/> <xsl:element name="section"> <xsl:attribute name="id"><xsl:call-template name="create-id"/></xsl:attribute> + <xsl:call-template name="emit-index-term"/> + <xsl:element name="title"> <xsl:call-template name="create-id"/> </xsl:element> @@ -228,6 +302,8 @@ <xsl:element name="section"> <xsl:attribute name="id"><xsl:call-template name="create-id"/></xsl:attribute> + <xsl:call-template name="emit-index-term"/> + <xsl:element name="title"> <xsl:call-template name="create-id"/> </xsl:element> @@ -248,6 +324,12 @@ </xsl:call-template> </xsl:template> + <xsl:template match="/package/condition"> + <xsl:call-template name="emit-type-section"> + <xsl:with-param name="page-type">Condition</xsl:with-param> + </xsl:call-template> + </xsl:template> + <xsl:template match="/package/slot-accessor"> <xsl:call-template name="emit-function-section"> <xsl:with-param name="page-type">Slot Accessor</xsl:with-param> Modified: trunk/docs/manual/gfs-function-data.xml ============================================================================== --- trunk/docs/manual/gfs-function-data.xml (original) +++ trunk/docs/manual/gfs-function-data.xml Wed Oct 18 03:46:35 2006 @@ -9,9 +9,9 @@ <slot-reader name="code"> <arguments> - <argument name="condition" type="cl:condition"> + <argument name="condition"> <description> - The <reftopic>win32-error</reftopic> or <reftopic>win32-warning</reftopic> + The <reftopic>gfs:win32-error</reftopic> or <reftopic>gfs:win32-warning</reftopic> object to be queried. </description> </argument> Modified: trunk/docs/manual/gfs-type-data.xml ============================================================================== --- trunk/docs/manual/gfs-type-data.xml (original) +++ trunk/docs/manual/gfs-type-data.xml Wed Oct 18 03:46:35 2006 @@ -7,14 +7,16 @@ <package name="gfs"> - <class name="toolkit-error"> + <condition name="toolkit-error"> <description> - <inherits> - <refclhs>error</refclhs> - </inherits> - <inheritedby> - <reftopic>win32-error</reftopic> - </inheritedby> + <hierarchy> + <inherits> + <refclhs>error</refclhs> + </inherits> + <inheritedby> + <reftopic>gfs:win32-error</reftopic> + </inheritedby> + </hierarchy> This error is raised to indicate invalid argument values or inconsistent state. </description> @@ -26,11 +28,43 @@ </argument> </initargs> <seealso> - <reftopic>detail</reftopic> - <reftopic>toolkit-warning</reftopic> - <reftopic>win32-warning</reftopic> + <reftopic>gfs:detail</reftopic> + <reftopic>gfs:toolkit-warning</reftopic> + <reftopic>gfs:win32-warning</reftopic> </seealso> - </class> + </condition> + + <condition name="win32-error"> + <description> + <hierarchy> + <inherits> + <reftopic>gfs:toolkit-error</reftopic> + </inherits> + <inheritedby> + <reftopic>gfs:comdlg-error</reftopic> + </inheritedby> + </hierarchy> + This error is raised to indicate that a Win32 API function has failed. + </description> + <initargs> + <argument name=":code"> + <description> + The error code returned by <refwin32api>GetLastError</refwin32api>. + </description> + </argument> + <argument name=":detail"> + <description> + See <reftopic>gfs:toolkit-error</reftopic>. + </description> + </argument> + </initargs> + <seealso> + <reftopic>gfs:code</reftopic> + <reftopic>gfs:detail</reftopic> + <reftopic>gfs:toolkit-warning</reftopic> + <reftopic>gfs:win32-warning</reftopic> + </seealso> + </condition> </package> Modified: trunk/docs/manual/graphic-forms.css ============================================================================== --- trunk/docs/manual/graphic-forms.css (original) +++ trunk/docs/manual/graphic-forms.css Wed Oct 18 03:46:35 2006 @@ -37,7 +37,7 @@ font-family: { Arial, Helvetica, sans-serif; } } -p.small { +a.small, p.small { font-size: 11; font-family: { Arial, Helvetica, sans-serif; } }

1 0

[graphic-forms-cvs] r344 - trunk/docs/manual/gfs
by junrue＠common-lisp.net 18 Oct '06

18 Oct '06

Author: junrue Date: Wed Oct 18 03:46:13 2006 New Revision: 344 Removed: trunk/docs/manual/gfs/ Log:

1 0

[graphic-forms-cvs] r343 - trunk/docs/manual/gfw
by junrue＠common-lisp.net 18 Oct '06

18 Oct '06

Author: junrue Date: Wed Oct 18 03:45:30 2006 New Revision: 343 Removed: trunk/docs/manual/gfw/ Log:

1 0

[graphic-forms-cvs] r342 - trunk/docs/manual/gfg
by junrue＠common-lisp.net 18 Oct '06

18 Oct '06

Author: junrue Date: Wed Oct 18 03:44:55 2006 New Revision: 342 Removed: trunk/docs/manual/gfg/ Log:

1 0

[graphic-forms-cvs] r341 - trunk/docs/manual
by junrue＠common-lisp.net 18 Oct '06

18 Oct '06

Author: junrue Date: Wed Oct 18 02:54:47 2006 New Revision: 341 Added: trunk/docs/manual/clhs-table.xml trunk/docs/manual/gfs-type-data.xml trunk/docs/manual/win32-api-table.xml Modified: trunk/docs/manual/Makefile trunk/docs/manual/gf-data.xsl trunk/docs/manual/gfs-function-data.xml trunk/docs/manual/graphic-forms.xml trunk/docs/manual/graphic-forms.xsl trunk/docs/manual/system-package.xml Log: Modified: trunk/docs/manual/Makefile ============================================================================== --- trunk/docs/manual/Makefile (original) +++ trunk/docs/manual/Makefile Wed Oct 18 02:54:47 2006 @@ -5,15 +5,24 @@ # Copyright (c) 2006, Jack D. Unrue # -docs: system-functions.xml - xsltproc --nonet graphic-forms.xsl graphic-forms.xml +COMMON-DEPS = gf-data.xsl clhs-table.xml win32-api-table.xml + +INTERIM-XML = system-types.xml system-functions.xml + +XSLT-PROC = xsltproc --nonet + +docs: system-types.xml system-functions.xml + $(XSLT-PROC) graphic-forms.xsl graphic-forms.xml -hhc htmlhelp.hhp -system-functions.xml: gfs-function-data.xml gf-data.xsl - xsltproc --nonet --output system-functions.xml gf-data.xsl gfs-function-data.xml +system-types.xml: gfs-type-data.xml $(COMMON-DEPS) + $(XSLT-PROC) --output $@ gf-data.xsl gfs-type-data.xml + +system-functions.xml: gfs-function-data.xml $(COMMON-DEPS) + $(XSLT-PROC) --output $@ gf-data.xsl gfs-function-data.xml clean: - rm -f system-functions.xml + rm -f $(INTERIM-XML) find . $ -name "*~" -o -name "*.html" -o -name "*.hhk" -o -name "*.hhc" -o -name "*.hhp" $ -exec rm {} \; scrub: clean Added: trunk/docs/manual/clhs-table.xml ============================================================================== --- (empty file) +++ trunk/docs/manual/clhs-table.xml Wed Oct 18 02:54:47 2006 @@ -0,0 +1,12 @@ +<?xml version="1.0"?> + + +<clhs-table> + <entry name="error" url="http://www.lispworks.com/documentation/HyperSpec/Body/e_error.htm"/> + <entry name="list" url="http://www.lispworks.com/documentation/HyperSpec/Body/t_list.htm"/> + <entry name="string" url="http://www.lispworks.com/documentation/HyperSpec/Body/t_string.htm"/> +</clhs-table> Modified: trunk/docs/manual/gf-data.xsl ============================================================================== --- trunk/docs/manual/gf-data.xsl (original) +++ trunk/docs/manual/gf-data.xsl Wed Oct 18 02:54:47 2006 @@ -11,21 +11,43 @@ <xsl:output method="xml" omit-xml-declaration="yes" indent="yes"/> - <xsl:template name="page-type"> - <xsl:param name="type-str"/> + <xsl:variable name="win32-table" select="document('win32-api-table.xml')"/> + <xsl:variable name="clhs-table" select="document('clhs-table.xml')"/> + + <xsl:template name="create-id"> + <xsl:value-of select="concat(../@name,':',@name)"/> + </xsl:template> + + <xsl:template name="emit-table"> + <xsl:param name="col2-width"/> + + <xsl:element name="informaltable"> + <xsl:attribute name="frame">none</xsl:attribute> + <xsl:element name="tgroup"> + <xsl:attribute name="cols">2</xsl:attribute> + <xsl:element name="colspec"> + <xsl:attribute name="colwidth">*</xsl:attribute> + </xsl:element> + <xsl:element name="colspec"> + <xsl:attribute name="colwidth"><xsl:value-of select="$col2-width"/></xsl:attribute> + </xsl:element> + <xsl:element name="tbody"> + <xsl:apply-templates/> + </xsl:element> + </xsl:element> + </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="$type-str"/> + <xsl:value-of select="$page-type"/> </xsl:element> </xsl:template> - <xsl:template name="syntax"> - <xsl:param name="package"/> - <xsl:param name="name"/> - <xsl:param name="arguments"/> - <xsl:param name="return-type"/> - + <xsl:template name="emit-syntax"> <xsl:element name="bridgehead"> <xsl:attribute name="renderas">sect2</xsl:attribute> syntax @@ -33,20 +55,81 @@ <xsl:element name="para"> <xsl:attribute name="role">normal</xsl:attribute> - (<xsl:value-of select="$package"/>:<xsl:value-of select="$name"/> + (<xsl:call-template name="create-id"/> <xsl:element name="emphasis"> - <xsl:value-of select="$arguments"/> + <xsl:for-each select="arguments/argument"> + <xsl:value-of select="concat(' ', @name)"/> + </xsl:for-each> </xsl:element>) => <xsl:element name="emphasis"> - <xsl:value-of select="$return-type"/> + <xsl:value-of select="return/@type"/> </xsl:element> </xsl:element> </xsl:template> + <xsl:template name="emit-symbol-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:apply-templates/> + </xsl:element> + </xsl:template> + + <xsl:template match="refargument"> + <xsl:element name="emphasis"> + <xsl:value-of select="."/> + </xsl:element> + </xsl:template> + + <xsl:template match="reftopic"> + <xsl:element name="link"> + <xsl:attribute name="linkend"><xsl:value-of select="."/></xsl:attribute> + <xsl:value-of select="."/> + </xsl:element> + </xsl:template> + + <xsl:template match="refclhs"> + <xsl:variable name="tmp" select="string()"/> + <xsl:element name="ulink"> + <xsl:attribute name="url"> + <xsl:value-of select="$clhs-table//entry[string(@name)=$tmp]/@url"/> + </xsl:attribute> + <xsl:value-of select="."/> + </xsl:element> + </xsl:template> + + <xsl:template match="refwin32api"> + <xsl:variable name="tmp" select="string()"/> + <xsl:element name="ulink"> + <xsl:attribute name="url"> + <xsl:value-of select="$win32-table//entry[string(@name)=$tmp]/@url"/> + </xsl:attribute> + <xsl:value-of select="."/>() + </xsl:element> + </xsl:template> + <xsl:template match="argument"> <xsl:element name="row"> - <xsl:element name="entry"><xsl:value-of select="@name"/></xsl:element> - <xsl:element name="entry"><xsl:value-of select="description"/></xsl:element> + <xsl:element name="entry"> + <xsl:attribute name="valign">top</xsl:attribute> + <xsl:element name="para"> + <xsl:attribute name="role">normal</xsl:attribute> + <xsl:element name="emphasis"> + <xsl:value-of select="@name"/> + </xsl:element> + </xsl:element> + </xsl:element> + <xsl:element name="entry"> + <xsl:attribute name="valign">top</xsl:attribute> + <xsl:element name="para"> + <xsl:attribute name="role">normal</xsl:attribute> + <xsl:apply-templates select="description"/> + </xsl:element> + </xsl:element> </xsl:element> </xsl:template> @@ -55,18 +138,52 @@ <xsl:attribute name="renderas">sect2</xsl:attribute> arguments </xsl:element> - <xsl:element name="informaltable"> - <xsl:attribute name="frame">none</xsl:attribute> - <xsl:element name="tgroup"> - <xsl:attribute name="cols">2</xsl:attribute> - <xsl:element name="tbody"> - <xsl:apply-templates/> - </xsl:element> - </xsl:element> + <xsl:call-template name="emit-table"> + <xsl:with-param name="col2-width">5*</xsl:with-param> + </xsl:call-template> + </xsl:template> + + <xsl:template match="initargs"> + <xsl:element name="bridgehead"> + <xsl:attribute name="renderas">sect2</xsl:attribute> + initargs </xsl:element> + <xsl:call-template name="emit-table"> + <xsl:with-param name="col2-width">5*</xsl:with-param> + </xsl:call-template> </xsl:template> - <xsl:template match="slot-accessor/description"> + <xsl:template match="inherits"> + <xsl:element name="para"> + <xsl:attribute name="role">normal</xsl:attribute> + inherits:<xsl:apply-templates/> + </xsl:element> + </xsl:template> + + <xsl:template match="inheritedby"> + <xsl:element name="para"> + <xsl:attribute name="role">normal</xsl:attribute> + inherited by:<xsl:apply-templates/> + </xsl:element> + </xsl:template> + + <xsl:template match="*/seealso"> + <xsl:element name="bridgehead"> + <xsl:attribute name="renderas">sect2</xsl:attribute> + see also + </xsl:element> + + <xsl:element name="para"> + <xsl:attribute name="role">normal</xsl:attribute> + + <xsl:for-each select="*"> + <xsl:apply-templates select="."/> + <xsl:if test="not(position()=last())">, </xsl:if> + </xsl:for-each> + </xsl:element> + </xsl:template> + + <xsl:template match="class/description"> <xsl:element name="bridgehead"> <xsl:attribute name="renderas">sect2</xsl:attribute> description @@ -74,33 +191,73 @@ <xsl:element name="para"> <xsl:attribute name="role">normal</xsl:attribute> - <xsl:value-of select="."/> + <xsl:apply-templates/> </xsl:element> </xsl:template> - <xsl:template match="slot-accessor"> + <xsl:template match="slot-accessor/description"> + <xsl:call-template name="emit-symbol-description"/> + </xsl:template> + + <xsl:template match="slot-reader/description"> + <xsl:call-template name="emit-symbol-description"/> + </xsl:template> + + <xsl:template name="emit-type-section"> + <xsl:param name="page-type"/> + <xsl:element name="section"> + <xsl:attribute name="id"><xsl:call-template name="create-id"/></xsl:attribute> + <xsl:element name="title"> - <xsl:value-of select="@package"/>:<xsl:value-of select="@name"/> + <xsl:call-template name="create-id"/> </xsl:element> - <xsl:call-template name="page-type"> - <xsl:with-param name="type-str">[Slot Accessor]</xsl:with-param> + <xsl:call-template name="emit-page-type"> + <xsl:with-param name="page-type">[<xsl:value-of select="$page-type"/>]</xsl:with-param> </xsl:call-template> - <xsl:call-template name="syntax"> - <xsl:with-param name="package"><xsl:value-of select="@package"/></xsl:with-param> - <xsl:with-param name="name"><xsl:value-of select="@name"/></xsl:with-param> - <xsl:with-param name="arguments"> - <xsl:for-each select="arguments/argument"> - <xsl:element name="foo"><xsl:value-of select="concat(' ', @name)"/></xsl:element> - </xsl:for-each> - </xsl:with-param> - <xsl:with-param name="return-type"><xsl:value-of select="return/@type"/></xsl:with-param> + <xsl:apply-templates/> + </xsl:element> + + </xsl:template> + + <xsl:template name="emit-function-section"> + <xsl:param name="page-type"/> + + <xsl:element name="section"> + <xsl:attribute name="id"><xsl:call-template name="create-id"/></xsl:attribute> + + <xsl:element name="title"> + <xsl:call-template name="create-id"/> + </xsl:element> + + <xsl:call-template name="emit-page-type"> + <xsl:with-param name="page-type">[<xsl:value-of select="$page-type"/>]</xsl:with-param> </xsl:call-template> + <xsl:call-template name="emit-syntax"/> + <xsl:apply-templates/> </xsl:element> </xsl:template> + <xsl:template match="/package/class"> + <xsl:call-template name="emit-type-section"> + <xsl:with-param name="page-type">Class</xsl:with-param> + </xsl:call-template> + </xsl:template> + + <xsl:template match="/package/slot-accessor"> + <xsl:call-template name="emit-function-section"> + <xsl:with-param name="page-type">Slot Accessor</xsl:with-param> + </xsl:call-template> + </xsl:template> + + <xsl:template match="/package/slot-reader"> + <xsl:call-template name="emit-function-section"> + <xsl:with-param name="page-type">Slot Reader</xsl:with-param> + </xsl:call-template> + </xsl:template> + </xsl:stylesheet> Modified: trunk/docs/manual/gfs-function-data.xml ============================================================================== --- trunk/docs/manual/gfs-function-data.xml (original) +++ trunk/docs/manual/gfs-function-data.xml Wed Oct 18 02:54:47 2006 @@ -5,17 +5,23 @@ Copyright (c) 2006, Jack D. Unrue --> -<slot-accessor package="gfs" name="code"> - <arguments> - <argument name="condition" type="cl:condition"> - <description> - The condition object to be queried; must be of type - win32-error or win32-warning or subclasses thereof. - </description> - </argument> - </arguments> - <return type="integer"/> - <description> - Returns the Win32 error code for the specified condition. - </description> -</slot-accessor> +<package name="gfs"> + + <slot-reader name="code"> + <arguments> + <argument name="condition" type="cl:condition"> + <description> + The <reftopic>win32-error</reftopic> or <reftopic>win32-warning</reftopic> + object to be queried. + </description> + </argument> + </arguments> + <return type="integer"/> + <description> + Returns the Win32 error code for <refargument>condition</refargument> + as determined by <refwin32api>GetLastError</refwin32api>. + </description> + </slot-reader> + +</package> + Added: trunk/docs/manual/gfs-type-data.xml ============================================================================== --- (empty file) +++ trunk/docs/manual/gfs-type-data.xml Wed Oct 18 02:54:47 2006 @@ -0,0 +1,36 @@ +<?xml version="1.0"?> + + +<package name="gfs"> + + <class name="toolkit-error"> + <description> + <inherits> + <refclhs>error</refclhs> + </inherits> + <inheritedby> + <reftopic>win32-error</reftopic> + </inheritedby> + This error is raised to indicate invalid argument values or inconsistent + state. + </description> + <initargs> + <argument name=":detail"> + <description> + A <refclhs>string</refclhs> supplying additional problem information. + </description> + </argument> + </initargs> + <seealso> + <reftopic>detail</reftopic> + <reftopic>toolkit-warning</reftopic> + <reftopic>win32-warning</reftopic> + </seealso> + </class> + +</package> + Modified: trunk/docs/manual/graphic-forms.xml ============================================================================== --- trunk/docs/manual/graphic-forms.xml (original) +++ trunk/docs/manual/graphic-forms.xml Wed Oct 18 02:54:47 2006 @@ -10,6 +10,7 @@ <!ENTITY introduction SYSTEM "introduction.xml"> <!ENTITY api SYSTEM "api.xml"> <!ENTITY gfspkg SYSTEM "system-package.xml"> + <!ENTITY gfstypes SYSTEM "system-types.xml">  <!ENTITY gfsfuncs SYSTEM "system-functions.xml">  <!ENTITY misctopics SYSTEM "miscellaneous-topics.xml"> <!ENTITY imdataplugins SYSTEM "image-data-plugins.xml"> Modified: trunk/docs/manual/graphic-forms.xsl ============================================================================== --- trunk/docs/manual/graphic-forms.xsl (original) +++ trunk/docs/manual/graphic-forms.xsl Wed Oct 18 02:54:47 2006 @@ -22,6 +22,12 @@ <xsl:param name="htmlhelp.hhc.folders.instead.books" select="0"/> <xsl:param name="htmlhelp.show.advanced.search" select="1"/> <xsl:param name="suppress.navigation" select="1"/> + <xsl:template name="user.footer.content"> <div class="footer"> Copyright © 2006, Jack D. Unrue Modified: trunk/docs/manual/system-package.xml ============================================================================== --- trunk/docs/manual/system-package.xml (original) +++ trunk/docs/manual/system-package.xml Wed Oct 18 02:54:47 2006 @@ -38,6 +38,7 @@ win32-warning </para> + &gfstypes; &gfsfuncs; </chapter> Added: trunk/docs/manual/win32-api-table.xml ============================================================================== --- (empty file) +++ trunk/docs/manual/win32-api-table.xml Wed Oct 18 02:54:47 2006 @@ -0,0 +1,10 @@ +<?xml version="1.0"?> + + +<win32-api-table> + <entry name="GetLastError" url="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/debug/base…"/> +</win32-api-table>

1 0

[graphic-forms-cvs] r340 - trunk/docs/manual
by junrue＠common-lisp.net 18 Oct '06

18 Oct '06

Author: junrue Date: Tue Oct 17 23:24:17 2006 New Revision: 340 Added: trunk/docs/manual/gf-data.xsl trunk/docs/manual/gfs-function-data.xml Modified: trunk/docs/manual/Makefile trunk/docs/manual/api.xml trunk/docs/manual/graphic-forms.xml trunk/docs/manual/graphic-forms.xsl trunk/docs/manual/system-package.xml Log: initial steps at generating DocBook content Modified: trunk/docs/manual/Makefile ============================================================================== --- trunk/docs/manual/Makefile (original) +++ trunk/docs/manual/Makefile Tue Oct 17 23:24:17 2006 @@ -5,11 +5,15 @@ # Copyright (c) 2006, Jack D. Unrue # -docs: +docs: system-functions.xml xsltproc --nonet graphic-forms.xsl graphic-forms.xml -hhc htmlhelp.hhp +system-functions.xml: gfs-function-data.xml gf-data.xsl + xsltproc --nonet --output system-functions.xml gf-data.xsl gfs-function-data.xml + clean: + rm -f system-functions.xml find . $ -name "*~" -o -name "*.html" -o -name "*.hhk" -o -name "*.hhc" -o -name "*.hhp" $ -exec rm {} \; scrub: clean Modified: trunk/docs/manual/api.xml ============================================================================== --- trunk/docs/manual/api.xml (original) +++ trunk/docs/manual/api.xml Tue Oct 17 23:24:17 2006 @@ -10,6 +10,6 @@ This chapter documents the Graphic-Forms programming interface. </para> - &systempkg; + &gfspkg; </chapter> Added: trunk/docs/manual/gf-data.xsl ============================================================================== --- (empty file) +++ trunk/docs/manual/gf-data.xsl Tue Oct 17 23:24:17 2006 @@ -0,0 +1,106 @@ +<?xml version="1.0"?> + +<xsl:stylesheet + xmlns:exsl="http://exslt.org/common" + xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + + <xsl:output method="xml" omit-xml-declaration="yes" indent="yes"/> + + <xsl:template name="page-type"> + <xsl:param name="type-str"/> + + <xsl:element name="para"> + <xsl:attribute name="role">normal</xsl:attribute> + <xsl:value-of select="$type-str"/> + </xsl:element> + </xsl:template> + + <xsl:template name="syntax"> + <xsl:param name="package"/> + <xsl:param name="name"/> + <xsl:param name="arguments"/> + <xsl:param name="return-type"/> + + <xsl:element name="bridgehead"> + <xsl:attribute name="renderas">sect2</xsl:attribute> + syntax + </xsl:element> + + <xsl:element name="para"> + <xsl:attribute name="role">normal</xsl:attribute> + (<xsl:value-of select="$package"/>:<xsl:value-of select="$name"/> + <xsl:element name="emphasis"> + <xsl:value-of select="$arguments"/> + </xsl:element>) => + <xsl:element name="emphasis"> + <xsl:value-of select="$return-type"/> + </xsl:element> + </xsl:element> + </xsl:template> + + <xsl:template match="argument"> + <xsl:element name="row"> + <xsl:element name="entry"><xsl:value-of select="@name"/></xsl:element> + <xsl:element name="entry"><xsl:value-of select="description"/></xsl:element> + </xsl:element> + </xsl:template> + + <xsl:template match="arguments"> + <xsl:element name="bridgehead"> + <xsl:attribute name="renderas">sect2</xsl:attribute> + arguments + </xsl:element> + <xsl:element name="informaltable"> + <xsl:attribute name="frame">none</xsl:attribute> + <xsl:element name="tgroup"> + <xsl:attribute name="cols">2</xsl:attribute> + <xsl:element name="tbody"> + <xsl:apply-templates/> + </xsl:element> + </xsl:element> + </xsl:element> + </xsl:template> + + <xsl:template match="slot-accessor/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:template> + + <xsl:template match="slot-accessor"> + <xsl:element name="section"> + <xsl:element name="title"> + <xsl:value-of select="@package"/>:<xsl:value-of select="@name"/> + </xsl:element> + + <xsl:call-template name="page-type"> + <xsl:with-param name="type-str">[Slot Accessor]</xsl:with-param> + </xsl:call-template> + + <xsl:call-template name="syntax"> + <xsl:with-param name="package"><xsl:value-of select="@package"/></xsl:with-param> + <xsl:with-param name="name"><xsl:value-of select="@name"/></xsl:with-param> + <xsl:with-param name="arguments"> + <xsl:for-each select="arguments/argument"> + <xsl:element name="foo"><xsl:value-of select="concat(' ', @name)"/></xsl:element> + </xsl:for-each> + </xsl:with-param> + <xsl:with-param name="return-type"><xsl:value-of select="return/@type"/></xsl:with-param> + </xsl:call-template> + + <xsl:apply-templates/> + </xsl:element> + </xsl:template> + +</xsl:stylesheet> Added: trunk/docs/manual/gfs-function-data.xml ============================================================================== --- (empty file) +++ trunk/docs/manual/gfs-function-data.xml Tue Oct 17 23:24:17 2006 @@ -0,0 +1,21 @@ +<?xml version="1.0"?> + + +<slot-accessor package="gfs" name="code"> + <arguments> + <argument name="condition" type="cl:condition"> + <description> + The condition object to be queried; must be of type + win32-error or win32-warning or subclasses thereof. + </description> + </argument> + </arguments> + <return type="integer"/> + <description> + Returns the Win32 error code for the specified condition. + </description> +</slot-accessor> Modified: trunk/docs/manual/graphic-forms.xml ============================================================================== --- trunk/docs/manual/graphic-forms.xml (original) +++ trunk/docs/manual/graphic-forms.xml Tue Oct 17 23:24:17 2006 @@ -9,7 +9,8 @@ <!ENTITY legal SYSTEM "legal.xml"> <!ENTITY introduction SYSTEM "introduction.xml"> <!ENTITY api SYSTEM "api.xml"> - <!ENTITY systempkg SYSTEM "system-package.xml"> + <!ENTITY gfspkg SYSTEM "system-package.xml"> + <!ENTITY gfsfuncs SYSTEM "system-functions.xml">  <!ENTITY misctopics SYSTEM "miscellaneous-topics.xml"> <!ENTITY imdataplugins SYSTEM "image-data-plugins.xml"> <!ENTITY glossary SYSTEM "glossary.xml"> Modified: trunk/docs/manual/graphic-forms.xsl ============================================================================== --- trunk/docs/manual/graphic-forms.xsl (original) +++ trunk/docs/manual/graphic-forms.xsl Tue Oct 17 23:24:17 2006 @@ -5,6 +5,7 @@ Copyright (c) 2006, Jack D. Unrue --> <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> + <xsl:import href="htmlhelp.xsl"/> <xsl:param name="chapter.autolabel" select="0"/> <xsl:param name="chunk.first.sections" select="1"/> @@ -26,4 +27,5 @@ Copyright © 2006, Jack D. Unrue </div> </xsl:template> + </xsl:stylesheet> Modified: trunk/docs/manual/system-package.xml ============================================================================== --- trunk/docs/manual/system-package.xml (original) +++ trunk/docs/manual/system-package.xml Tue Oct 17 23:24:17 2006 @@ -1,12 +1,12 @@  <chapter> <title>graphic-forms.uitoolkit.system</title> - <para role="normal">[package]</para> + <para role="normal">[Package]</para> <bridgehead renderas="sect2">nickname</bridgehead> <para role="normal">GFS</para> @@ -38,4 +38,6 @@ win32-warning </para> + &gfsfuncs; + </chapter>

1 0

[graphic-forms-cvs] r339 - trunk/docs/manual
by junrue＠common-lisp.net 17 Oct '06

17 Oct '06

Author: junrue Date: Tue Oct 17 19:54:50 2006 New Revision: 339 Added: trunk/docs/manual/api.xml trunk/docs/manual/system-package.xml Modified: trunk/docs/manual/graphic-forms.css trunk/docs/manual/graphic-forms.xml trunk/docs/manual/graphic-forms.xsl Log: Added: trunk/docs/manual/api.xml ============================================================================== --- (empty file) +++ trunk/docs/manual/api.xml Tue Oct 17 19:54:50 2006 @@ -0,0 +1,15 @@ + +<chapter> + <title>API Reference</title> + + <para role="normal"> + This chapter documents the Graphic-Forms programming interface. + </para> + + &systempkg; + +</chapter> Modified: trunk/docs/manual/graphic-forms.css ============================================================================== --- trunk/docs/manual/graphic-forms.css (original) +++ trunk/docs/manual/graphic-forms.css Tue Oct 17 19:54:50 2006 @@ -1,4 +1,4 @@ -h2.title { +div.title, h2.title { font-size: 16; font-family: { Arial, Helvetica, sans-serif; } font-weight: Bold; @@ -17,6 +17,11 @@ font-weight: Bold; } +div.chapter, div.glossary, div.section { + border-bottom-style: groove; + margin-bottom: 12px; +} + div.footer { font-size: 9; font-family: { Arial, Helvetica, sans-serif; } Modified: trunk/docs/manual/graphic-forms.xml ============================================================================== --- trunk/docs/manual/graphic-forms.xml (original) +++ trunk/docs/manual/graphic-forms.xml Tue Oct 17 19:54:50 2006 @@ -8,6 +8,8 @@ [ <!ENTITY legal SYSTEM "legal.xml"> <!ENTITY introduction SYSTEM "introduction.xml"> + <!ENTITY api SYSTEM "api.xml"> + <!ENTITY systempkg SYSTEM "system-package.xml"> <!ENTITY misctopics SYSTEM "miscellaneous-topics.xml"> <!ENTITY imdataplugins SYSTEM "image-data-plugins.xml"> <!ENTITY glossary SYSTEM "glossary.xml"> @@ -18,12 +20,13 @@ <subtitle>Programming Reference (version 0.6)</subtitle> <bridgehead renderas="sect2"> - A user interface toolkit for the Windows platform. + A Common Lisp user interface toolkit for the Windows platform. </bridgehead> &legal; &introduction; + &api; &misctopics; &glossary; Modified: trunk/docs/manual/graphic-forms.xsl ============================================================================== --- trunk/docs/manual/graphic-forms.xsl (original) +++ trunk/docs/manual/graphic-forms.xsl Tue Oct 17 19:54:50 2006 @@ -20,8 +20,8 @@ <xsl:param name="htmlhelp.chm" select="'graphic-forms.chm'"/> <xsl:param name="htmlhelp.hhc.folders.instead.books" select="0"/> <xsl:param name="htmlhelp.show.advanced.search" select="1"/> - <xsl:template name="user.footer.navigation"> - <hr/> + <xsl:param name="suppress.navigation" select="1"/> + <xsl:template name="user.footer.content"> <div class="footer"> Copyright © 2006, Jack D. Unrue </div> Added: trunk/docs/manual/system-package.xml ============================================================================== --- (empty file) +++ trunk/docs/manual/system-package.xml Tue Oct 17 19:54:50 2006 @@ -0,0 +1,41 @@ + +<chapter> + <title>graphic-forms.uitoolkit.system</title> + + <para role="normal">[package]</para> + + <bridgehead renderas="sect2">nickname</bridgehead> + <para role="normal">GFS</para> + + <bridgehead renderas="sect2">description</bridgehead> + <para role="normal"> + 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. + </para> + + <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> + +</chapter>

1 0

[graphic-forms-cvs] r338 - trunk/docs/manual
by junrue＠common-lisp.net 17 Oct '06

17 Oct '06

Author: junrue Date: Tue Oct 17 02:22:41 2006 New Revision: 338 Added: trunk/docs/manual/glossary.xml Modified: trunk/docs/manual/graphic-forms.css trunk/docs/manual/graphic-forms.xml trunk/docs/manual/image-data-plugins.xml Log: restored glossary Added: trunk/docs/manual/glossary.xml ============================================================================== --- (empty file) +++ trunk/docs/manual/glossary.xml Tue Oct 17 02:22:41 2006 @@ -0,0 +1,210 @@ + +<glossary><title>Glossary</title> + +<glossdiv><title>A</title> + + <glossentry id="accelerator"><glossterm>accelerator</glossterm> + <glossdef> + <para> + An accelerator is a key sequence assigned to an application + function allowing a user to bypass navigation of the menu or control + hierarchy normally required to invoke the function. Some accelerators + are established by Windows style guidelines, such as control-c for + the clipboard copy operation from an Edit menu. Applications may define + other accelerators as appropriate. Accelerators are generally intended + for more knowledgeable users and should not be the sole mechanism for + invoking functionality. + </para> + <glossseealso otherterm="mnemonic"/> + </glossdef> + </glossentry> + + <glossentry id="auto-scrolling"><glossterm>auto-scrolling</glossterm> + <glossdef> + <para> + Auto-scrolling is a feature whereby scrolling occurs as a side + effect of user input so content can remain visible, thus avoiding + the need to explicitly manipulate scrollbars to achieve the same result. + </para> + </glossdef> + </glossentry> + +</glossdiv> + +<glossdiv><title>B</title> +</glossdiv> + +<glossdiv><title>C</title> + + <glossentry id="control"><glossterm>control</glossterm> + <glossdef> + <para> + A control is a system-defined window class whose role is to accept + user input and possibly generate notification events based on such + input. + </para> + </glossdef> + </glossentry> + +</glossdiv> + +<glossdiv><title>D</title> + + <glossentry id="default action"><glossterm>default action</glossterm> + <glossdef> + <para> + Conceptually, a default action is a secondary event initiated by + user input that is a logical follow-up to a previous event. Examples + of such user gestures include double-clicking an item in a list box + control, or pressing enter when an edit control has the keyboard focus. + The response to a default action makes use of context established by + the preceding event (e.g., the selection set by an initial click + becomes the context for the double-click response). + </para> + </glossdef> + </glossentry> + + <glossentry id="dialog"><glossterm>dialog</glossterm> + <glossdef> + <para> + A dialog is a mechanism for collecting user input or showing + information. The system defines common dialogs for tasks like + choosing files, fonts, or colors. Custom dialogs can be defined + by application code. + </para> + </glossdef> + </glossentry> + +</glossdiv> + +<glossdiv><title>E</title> + + <glossentry id="extension"><glossterm>extension</glossterm> + <glossdef> + <para> + An extension is code providing additional functionality beyond the + original scope of a system. An extension framework encourages + modularity. More importantly, it is a conscious design choice to + allow a system to be stretched beyond what the original designers may + have anticipated. + </para> + <glossseealso otherterm="plugin"/> + </glossdef> + </glossentry> + +</glossdiv> + +<glossdiv><title>F</title> +</glossdiv> + +<glossdiv><title>G</title> +</glossdiv> + +<glossdiv><title>H</title> +</glossdiv> + +<glossdiv><title>I</title> +</glossdiv> + +<glossdiv><title>J</title> +</glossdiv> + +<glossdiv><title>K</title> +</glossdiv> + +<glossdiv><title>L</title> +</glossdiv> + +<glossdiv><title>M</title> + + <glossentry id="menu"><glossterm>menu</glossterm> + <glossdef> + <para> + A collection of menu items presented within a single rectangular + region. Menus are often anchored to a menu bar, but may also be + invoked in a context-sensitive manner via the mouse or an + <glossseealso otherterm="accelerator"/>. + </para> + </glossdef> + </glossentry> + + <glossentry id="mix-in class"><glossterm>mix-in class</glossterm> + <glossdef> + <para> + A mix-in class represents a specific abstraction that complements + the role(s) of other class(es) in a class hierarchy. + </para> + </glossdef> + </glossentry> + + <glossentry id="mnemonic"><glossterm>mnemonic</glossterm> + <glossdef> + <para> + A mnemonic is a key sequence (usually a single character modified + by the <Alt> key) enabling mouse-free navigation of a menu or + control hierarchy to invoke an application function. Depending on + the user's system settings, mnemonic characters may be hidden until + the user presses the <Alt> key. + </para> + <glossseealso otherterm="accelerator"/> + </glossdef> + </glossentry> +</glossdiv> + +<glossdiv><title>N</title> +</glossdiv> + +<glossdiv><title>O</title> +</glossdiv> + +<glossdiv><title>P</title> + + <glossentry id="plugin"><glossterm>plugin</glossterm> + <glossdef> + <para> + A plugin is a unit of code integrated into a larger system in order + to implement a specific instance of an established category of + services. A plugin framework encourages modularity within a + defined scope of functionality. + </para> + <glossseealso otherterm="extension"/> + </glossdef> + </glossentry> + +</glossdiv> + +<glossdiv><title>Q</title> +</glossdiv> + +<glossdiv><title>R</title> +</glossdiv> + +<glossdiv><title>S</title> +</glossdiv> + +<glossdiv><title>T</title> +</glossdiv> + +<glossdiv><title>U</title> +</glossdiv> + +<glossdiv><title>V</title> +</glossdiv> + +<glossdiv><title>W</title> +</glossdiv> + +<glossdiv><title>X</title> +</glossdiv> + +<glossdiv><title>Y</title> +</glossdiv> + +<glossdiv><title>Z</title> +</glossdiv> + +</glossary> Modified: trunk/docs/manual/graphic-forms.css ============================================================================== --- trunk/docs/manual/graphic-forms.css (original) +++ trunk/docs/manual/graphic-forms.css Tue Oct 17 02:22:41 2006 @@ -27,7 +27,7 @@ font-family: { Arial, Helvetica, sans-serif; } } -a, p.normal, span.productname { +a, dd, dt, p.normal, span.productname { font-size: 12; font-family: { Arial, Helvetica, sans-serif; } } Modified: trunk/docs/manual/graphic-forms.xml ============================================================================== --- trunk/docs/manual/graphic-forms.xml (original) +++ trunk/docs/manual/graphic-forms.xml Tue Oct 17 02:22:41 2006 @@ -10,6 +10,7 @@ <!ENTITY introduction SYSTEM "introduction.xml"> <!ENTITY misctopics SYSTEM "miscellaneous-topics.xml"> <!ENTITY imdataplugins SYSTEM "image-data-plugins.xml"> + <!ENTITY glossary SYSTEM "glossary.xml"> ]> <book> @@ -24,6 +25,7 @@ &legal; &introduction; &misctopics; + &glossary; <index id="index"/> </book> Modified: trunk/docs/manual/image-data-plugins.xml ============================================================================== --- trunk/docs/manual/image-data-plugins.xml (original) +++ trunk/docs/manual/image-data-plugins.xml Tue Oct 17 02:22:41 2006 @@ -16,7 +16,7 @@ <para role="small"> Nowadays, the Windows platform offers alternatives, such as GDI+ which adds among other features native support for additional image - formats. Graphic-Forms sticks with plain-old gdi to avoid the + formats. Graphic-Forms sticks with plain-old GDI to avoid the possibility of these alternatives not being installed. </para> </footnote>

1 0