darcs - doc

repos / doc / headdiff

Link Benchmark --> to head

Sat Apr 3 21:12:53 CEST 2010 Tobias Rautenkranz <tobias@rautenkranz.ch>

* KDE is split up in kde.ui and kde.core.

Sat Apr 3 21:12:32 CEST 2010 Tobias Rautenkranz <tobias@rautenkranz.ch>

* C++ member variable access

Sun Jan 10 09:57:54 CET 2010 Tobias Rautenkranz <tobias@rautenkranz.ch>

* modular smoke.

Sun Dec 13 14:22:09 CET 2009 Tobias Rautenkranz <tobias@rautenkranz.ch>

* remove mudballs

Wed Sep 2 14:08:06 CEST 2009 Tobias Rautenkranz <tobias@rautenkranz.ch>

* cl-smoke now supports user conversions for return values.

Sun Aug 30 16:26:13 CEST 2009 Tobias Rautenkranz <tobias@rautenkranz.ch>

* Multiple inheritance doc & expand tabs in programmlisting.

Thu Aug 27 13:47:08 CEST 2009 Tobias Rautenkranz <tobias@rautenkranz.ch>

* Update for the new smokegenerator

Sun Aug 2 13:24:57 CEST 2009 Tobias Rautenkranz <tobias@rautenkranz.ch>

* Remove wrong note about cxx:meta-object

Thu Jul 23 00:59:59 CEST 2009 Tobias Rautenkranz <tobias@rautenkranz.ch>

* add phonon repository

Thu Jul 23 00:53:41 CEST 2009 Tobias Rautenkranz <tobias@rautenkranz.ch>

* phonon & :arg0

Mon Jul 6 23:51:20 CEST 2009 Tobias Rautenkranz <tobias@rautenkranz.ch>

* OpenGL: origami

Fri Jul 3 00:28:43 CEST 2009 Tobias Rautenkranz <tobias@rautenkranz.ch>

* cl-smoke.commonqt & Clozure CL support

Sun Jun 21 11:29:52 CEST 2009 Tobias Rautenkranz <tobias@rautenkranz.ch>

* Link Benchmark

diff -rN -u old-doc/chunk.xsl new-doc/chunk.xsl

--- old-doc/chunk.xsl 2014-10-30 07:11:52.000000000 +0100

+++ new-doc/chunk.xsl 2014-10-30 07:11:52.000000000 +0100

@@ -2,16 +2,18 @@

<xsl:stylesheet version="1.0"

xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

-<xsl:import href="/usr/share/xml/docbook/stylesheet/nwalsh/xhtml/chunk.xsl"/>

-<xsl:import href="link-apidoc.xsl"/>

+<xsl:import href="/usr/share/xml/docbook/stylesheet/nwalsh/html/chunk.xsl" />

+<xsl:import href="nonlink-apidoc.xsl" />

-<xsl:import href="/usr/share/xml/docbook/stylesheet/nwalsh/xhtml/highlight.xsl"/>

-<xsl:param name="highlight.source" select="1"/>

+<xsl:import href="video.xsl" />

+<xsl:import href="/usr/share/xml/docbook/stylesheet/nwalsh/html/highlight.xsl" />

+<xsl:param name="highlight.source" select="1" />

<!--

<xsl:param name="admon.graphics" select="1"/>

!-->

-<xsl:param name="use.id.as.filename" select="1"/>

+<xsl:param name="use.id.as.filename" select="1" />

</xsl:stylesheet>

Binary files old-doc/commonqt-t14.png and new-doc/commonqt-t14.png differ

diff -rN -u old-doc/introduction.xml new-doc/introduction.xml

--- old-doc/introduction.xml 2014-10-30 07:11:52.000000000 +0100

+++ new-doc/introduction.xml 2014-10-30 07:11:52.000000000 +0100

@@ -14,7 +14,7 @@

Lisp-CFFI-Qt4</ulink> (dead)</para></listitem>

</itemizedlist>

</section>

-<section><title>Limitations</title>

+<section id="limitations"><title>Limitations</title>

<listitem><para>Ownership transfer to / from C++ of non QObject objects is seldom known to cl-smoke.

E.g.: cl-smoke might delete an instance even though it is still needed by C++.

@@ -24,38 +24,44 @@

when a Lisp to C++ conversion is missing and a pointer will be returned when there is no C++ to Lisp

conversion.

</para></listitem>

- <listitem><para>10 seconds startup time<footnote>

+ <listitem><para>6 seconds startup time<footnote>

<para>

- Using an image it is around 1 second.

+ Using a core image it is around 1 second.

(see <xref linkend="core-image"/>)

</para></footnote>

(for <package>qt.examples</package>) on a

- Pentium M 1.7GHz. (Compilation ~20 seconds)</para></listitem>

+ Pentium M 1.7GHz. </para></listitem>

<listitem><para>Needs to be recompiled when the Smoke library is updated.</para></listitem>

<listitem><para>Could be faster</para></listitem>

- <listitem><para>No const-correctness</para></listitem>

</itemizedlist>

+<section><title>Performance</title>

+<para>

+Method calling is near 3000 times slower than native C++. The overhead is mainly in the overload

+resolution and to/from foreign object translation. Some measurements by

+<code><ulink url="http://tobias.rautenkranz.ch/darcsweb/darcsweb.cgi?r=cl-smoke/benchmark;a=summary">:cl-smoke.benchmark</ulink></code>

+are in

+<filename><ulink url="../benchmark.pdf">benchmark.pdf</ulink></filename>.

+</para>

</section>

-<section><title>Installation</title>

+</section>

+<section id="installation"><title>Installation</title>

<section><title>Dependencies</title>

<listitem><para><ulink

url="http://techbase.kde.org/Development/Languages/Smoke">Smoke2</ulink>

- bindings 4.2 or later</para></listitem>

+ bindings from svn.

+ <footnote><para>

+ The new smokegenerator is needed (developed by Arno Rehn for the GSOC 09).

+ </para></footnote>

+ </para></listitem>

(development package)</para></listitem>

<ulink url="http://cmake.org">CMake</ulink> 2.6

</para></listitem>

- <listitem><para>a make program (preferably Gnu Make)</para></listitem>

<listitem><para>a C++ compiler (GCC)</para></listitem>

</itemizedlist>

<para>

-On the Lisp side you need <ulink url="http://mudballs.com">Mudballs</ulink>

-and <ulink url="http://tobias.rautenkranz.ch/lisp/sysdef.cmake">sysdef.cmake</ulink>.

-</para>

-<para>

-If you prefer to use <ulink url="http://common-lisp.net/project/asdf/">ASDF</ulink> instead of Mudballs, you need these systems:

<listitem><para><ulink url="http://common-lisp.net/project/alexandria/">alexandria</ulink></para></listitem>

<listitem><para><ulink url="http://common-lisp.net/project/bordeaux-threads/">bordeaux-threads</ulink></para></listitem>

@@ -72,14 +78,8 @@

<ulink url="http://www.sbcl.org">SBCL</ulink> on Linux x86 (and x86_64)

</para></listitem>

- </itemizedlist>

-</section>

-<section><title>Partial</title>

- <itemizedlist>

- <ulink url="http://trac.clozure.com/openmcl">Clozure CL</ulink>

- <footnote><para>There are some test suite failures and

- it is to slow to be usable.</para></footnote>on Linux x86.

+ <ulink url="http://trac.clozure.com/openmcl">Clozure CL</ulink> on Linux x86.

</para></listitem>

</itemizedlist>

</section>

@@ -96,55 +96,34 @@

</section>

<section><title>Installation</title>

<para>

- For loading the systems you can use Mudballs or ASDF. But first get the sources:

-</para>

-<para>

You need to checkout the darcs repositories:

cd <userinput>SOME_DIR</userinput>

-for r in smoke qt qt.test qt.tests qt.examples qt.uitools qt.webkit kde kde.tests kde.examples repl; do

+for r in smoke qt.core qt.gui qt.network qt.test qt.tests qt.examples qt.uitools qt.webkit qt.phonon; do

darcs get "http://tobias.rautenkranz.ch/lisp/cl-smoke/$r"

done

</programlisting>

- </para>

- <section><title>Mudballs</title>

- <para>

- Then add the directory <userinput>SOME_DIR</userinput> to the mudballs search paths by adding

- <programlisting>

-(push (wildcard-searcher "<userinput>SOME_DIR</userinput>/*/*.mbd")

- *custom-search-modules*)

- </programlisting>

- to <filename>~/.mudballs</filename>.

-</para>

-<note>

-<para>

- Loading the packages with <code>mb:load</code> compiles the C wrapper libraries as needed.

-</para>

-</note>

- </section>

- <section><title>ASDF</title>

+ <note>

<para>

- The <code>.asd</code> files are

- <ulink url="http://tobias.rautenkranz.ch/darcsweb/darcsweb.cgi?r=mudballs-to-asdf;a=summary">generated</ulink>

- from the mudballs files.

- <ulink url="http://tobias.rautenkranz.ch/lisp/cl-smoke/cl-smoke-asd.tar.bz2">Get the <code>.asd</code> files</ulink> and

- place them in the corresponding source directories. Then symlink the <code>.asd</code> files in a ASDF search path.

- You can for examples run: <code>ln -s <userinput>SOME_DIR/*/*.asd</userinput> <userinput>ASDF_PATH</userinput></code>

+ There are also the following repositories: qt.svg qt.dbus kde.core kde.ui kde.tests kde.examples

+ </para>

+ </note>

</para>

<para>

- Now build and install the <package>:smoke</package> and <package>:qt</package> C wrapper libraries with:

+ Build and install the <package>:smoke</package> and <package>:qt.core</package> C wrapper libraries with:

- <programlisting>

- cmake ./ && make && sudo make install

- </programlisting>

+ <programlisting>cmake ./ && make && sudo make install</programlisting>

</informalexample>

in the <filename>smoke/</filename> and <filename>qt/</filename> directories.

</para>

- <note><para>

- Some examples get the paths for the files to load from their Mudballs system (ui and i18n) and thus will not work.

- </para></note>

- </section>

+ <para>

+ When you have symlinked the <filename>.asd</filename> system files, you

+ should be able to load the systems. The system name has a

+ <code>:cl-smoke.</code> prefix. e.g.:

+ <informalexample>

+ <programlisting language="lisp">(asdf:oos 'asdf:load-op :cl-smoke.qt.examples) </programlisting>

+ </informalexample>

+ </para>

</section>

</chapter>

diff -rN -u old-doc/kde.xml new-doc/kde.xml

--- old-doc/kde.xml 2014-10-30 07:11:52.000000000 +0100

+++ new-doc/kde.xml 2014-10-30 07:11:52.000000000 +0100

@@ -4,16 +4,20 @@

<para>

-Besides the <package>:kde</package> package there

+To use the KDE libraries use the <package>:cl-smoke.kde.ui</package>

+(Depends on <package>:cl-smoke.kde.core</package>).

+</para>

+<para>

+Besides these packages there

is <package>:kde.tests</package> for the unit tests and

<package>:kde.examples</package> containing the examples.

</para>

-<section><title>Examples</title>

+<section id="kde_examples"><title>Examples</title>

<para>

The examples can be run with:

-(mb:load <package>:kde.examples</package>)

+(asdf:oos 'asdf:load-op <package>:cl-smoke.kde.examples</package>)

</programlisting>

And then running the function of the example; e.g.:

diff -rN -u old-doc/manual.xsl new-doc/manual.xsl

--- old-doc/manual.xsl 2014-10-30 07:11:52.000000000 +0100

+++ new-doc/manual.xsl 2014-10-30 07:11:52.000000000 +0100

@@ -2,10 +2,13 @@

<xsl:stylesheet version="1.0"

xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

-<xsl:import href="/usr/share/xml/docbook/stylesheet/nwalsh/xhtml/docbook.xsl"/>

-<xsl:import href="link-apidoc.xsl"/>

+<xsl:import href="/usr/share/xml/docbook/stylesheet/nwalsh/html/docbook.xsl"/>

+<xsl:import href="nonlink-apidoc.xsl"/>

+<xsl:import href="/usr/share/xml/docbook/stylesheet/nwalsh/html/highlight.xsl"/>

+<xsl:import href="video.xsl" />

-<xsl:import href="/usr/share/xml/docbook/stylesheet/nwalsh/xhtml/highlight.xsl"/>

<xsl:param name="highlight.source" select="1"/>

</xsl:stylesheet>

diff -rN -u old-doc/nonlink-apidoc.xsl new-doc/nonlink-apidoc.xsl

--- old-doc/nonlink-apidoc.xsl 1970-01-01 01:00:00.000000000 +0100

+++ new-doc/nonlink-apidoc.xsl 2014-10-30 07:11:52.000000000 +0100

@@ -0,0 +1,41 @@

+<?xml version='1.0'?>

+<!--

+Permission is hereby granted, free of charge, to any person

+obtaining a copy of this software and associated documentation

+files (the "Software"), to deal in the Software without

+restriction, including without limitation the rights to use,

+copy, modify, merge, publish, distribute, sublicense, and/or sell

+copies of the Software, and to permit persons to whom the

+Software is furnished to do so, subject to the following

+conditions:

+The above copyright notice and this permission notice shall be

+included in all copies or substantial portions of the Software.

+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES

+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT

+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,

+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING

+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR

+OTHER DEALINGS IN THE SOFTWARE.

+!-->

+<xsl:stylesheet version="1.0"

+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

+<xsl:template match="macro">

+ <xsl:call-template name="ulink">

+ </xsl:call-template>

+</xsl:template>

+<xsl:template match="genericfunction">

+ <xsl:call-template name="ulink">

+ </xsl:call-template>

+</xsl:template>

+</xsl:stylesheet>

Binary files old-doc/origami.ogg and new-doc/origami.ogg differ

Binary files old-doc/origami.png and new-doc/origami.png differ

diff -rN -u old-doc/qt.xml new-doc/qt.xml

--- old-doc/qt.xml 2014-10-30 07:11:52.000000000 +0100

+++ new-doc/qt.xml 2014-10-30 07:11:52.000000000 +0100

@@ -4,26 +4,40 @@

<para>

-Besides the <package>:qt</package> there are these packages: with

+Besides the <package>:cl-smoke.qt.gui</package> there are these modules:

- <listitem><para>

- <package>:qt.uitools</package>

- <ulink url="http://doc.trolltech.com/4.5/qtuitools.html">

- QtUiTools</ulink></para></listitem>

- <listitem><para><package>:qt.test</package>

- <ulink url="http://doc.trolltech.com/4.5/qttest.html">

- QtTest</ulink></para></listitem>

- <listitem><para><package>:qt.webkit</package>

- <ulink url="http://doc.trolltech.com/4.5/qtwebkit.html">

- QtWebKit</ulink>

- </para></listitem>

+ <listitem><para>

+ <package>:cl-smoke.qt.uitools</package>

+ <ulink url="http://doc.trolltech.com/4.5/qtuitools.html">

+ QtUiTools</ulink></para></listitem>

+ <listitem><para><package>:cl-smoke.qt.test</package>

+ <ulink url="http://doc.trolltech.com/4.5/qttest.html">

+ QtTest</ulink></para></listitem>

+ <listitem><para><package>:cl-smoke.qt.webkit</package>

+ <ulink url="http://doc.trolltech.com/4.5/qtwebkit.html">

+ QtWebKit</ulink>

+ </para></listitem>

+ <listitem><para><package>:cl-smoke.qt.phonon</package>

+ <ulink url="http://doc.trolltech.com/4.5/phonon.html">

+ Phonon</ulink>

+ </para></listitem>

+ <listitem><para><package>:cl-smoke.qt.network</package>

+ The network classes of Qt.

+ </para></listitem>

+ <listitem><para><package>:cl-smoke.qt.core</package>

+ the nogui Qt core.

+ </para></listitem>

</itemizedlist>

-which provide bindings for their Qt module.

-Additionally there is the <package>:qt.tests</package> system, containing

-the unit tests and <package>:qt.examples</package> for various examples.

+which provide bindings for their Qt module. The class names of this modules are in

+the <package>:qt</package> package. (E.g. Phonon::VideoPlayer is <code>'qt:phonon.video-player</code>

+and QTest is <code>'qt:test</code>)

+</para>

+<para>

+Additionally there is the <package>:cl-smoke.qt.tests</package> system, containing

+the unit tests and <package>:cl-smoke.qt.examples</package> for various examples.

</para>

-<section><title>qt:application</title>

+<section id="qapplication"><title>qt:application</title>

<para>

The <classname>qt:application</classname> object should created with:

<macro>qt:with-app</macro>. In its body the event loop can be

@@ -34,19 +48,24 @@

- <imagedata fileref="hello-world.png" format="PNG"/>

+ <imagedata fileref="hello-world.png" format="PNG"/>

</imageobject>

</mediaobject>

</screenshot>

<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../qt.examples/src/hello-world.lisp" parse="text" />

-</programlisting>

+</programlisting>

</example>

<para>

Subclasses of <classname>qt:paint-device</classname> (e.g. <classname>qt:widget</classname>) can only be used when

a <classname>qt:application</classname> instance exists. When there are, for example, <classname>qt:widget</classname> instances

at the end of <macro>qt:with-app</macro>, they are deleted by the <classname>qt:application</classname> destructor.

</para>

+<para>

+Custom <methodname>cxx:paint-event</methodname> methods can use <macro>qt:with-painter</macro>

+to ensure that the <classname>qt:painter</classname> is deactivated at the end of the method.

+</para>

<section><title>Interactive Development</title>

<para>

The <package>:cl-smoke.repl</package> allows you to start a <classname>qt:application</classname> event loop in the background for

@@ -63,7 +82,7 @@

</section>

-<section><title>Signal-Slot</title>

+<section id="signal_slot"><title>Signal-Slot</title>

<para>

<genericfunction>qt:connect</genericfunction> connects a signal to a slot.

The signal is either a <classname>qt:qsignal</classname> created with

@@ -90,23 +109,24 @@

</para>

</section>

-<section><title>Properties</title>

+<section id="properties"><title>Properties</title>

<para>

<classname>qt:object</classname> properties can be accessed with

<methodname>qt:property</methodname> (setf-able).

The name of the property can be either a string in C++ style or a symbol in Lisp style.

+The predefined Qt properties can be accessed with symbols in the keyword package.

</para>

(let ((object (make-instance '<classname>qt:object</classname>)))

- (setf (<methodname>qt:property</methodname> object 'object-name) "Foo")

- (assert (string= "Foo" (<methodname>qt:property</methodname> object "objectName"))))

+ (setf (<methodname>qt:property</methodname> object :object-name) "Foo")

+ (assert (string= "Foo" (<methodname>qt:property</methodname> object "objectName"))))

</programlisting>

</informalexample>

</section>

-<section><title>Variant</title>

+<section id="variant"><title>Variant</title>

<para>

A <classname>qt:variant</classname> can be constructed with <methodname>qt:make-variant</methodname>

or to pass a Lisp object with <methodname>qt:make-lisp-variant</methodname>.

@@ -114,7 +134,7 @@

</para>

</section>

-<section><title>i18n</title>

+<section id="i18n"><title>i18n</title>

<para>

You can use <methodname>qt:tr</methodname> to translate strings.

</para>

@@ -123,7 +143,7 @@

- <imagedata fileref="i18n-hello-world.png" format="PNG"/>

+ <imagedata fileref="i18n-hello-world.png" format="PNG"/>

</imageobject>

</mediaobject>

</screenshot>

@@ -131,14 +151,14 @@

<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"

href="../qt.examples/src/i18n-hello-world.lisp" parse="text" />

-</programlisting>

+</programlisting>

<title><filename>hello-world_de.po</filename></title>

<para>

<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../qt.examples/src/hello-world_de.po" parse="text" />

-</programlisting>

+</programlisting>

</para>

</formalpara>

</example>

@@ -147,15 +167,15 @@

Gettext is used to extract the i18n strings and compile the message catalog.

See <filename><ulink url="../qt.examples/src/CMakeLists.txt">CMakeLists.txt</ulink></filename>

and <filename><ulink url="../qt.examples/src/UseClQti18n.cmake">UseClQti18n.cmake</ulink></filename>

-in the <filename class="directory">src/</filename> directory of <package>:qt.examples</package> on how to do this.

+in the <filename class="directory">src/</filename> directory of <package>:cl-smoke.qt.examples</package> on how to do this.

</para>

</section>

-<section><title>Examples</title>

+<section id="qt_examples"><title>Examples</title>

<para>

You can run the examples with:

-(mb:load <package>:qt.examples</package>)

+(asdf:oos 'asdf:load-op <package>:cl-smoke.qt.examples</package>)

(<methodname>qt.examples:launcher</methodname>)

</programlisting>

</para>

@@ -169,33 +189,60 @@

- <imagedata fileref="repl.png" format="PNG"/>

+ <imagedata fileref="repl.png" format="PNG"/>

</imageobject>

</mediaobject>

</screenshot>

<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../qt.examples/src/repl.lisp" parse="text" />

-</programlisting>

+</programlisting>

</example>

<title>Class Browser</title>

-<para>Qt Classes browser using <package>:qt.webkit</package> to display the

+<para>Qt Classes browser using <package>:cl-smoke.qt.webkit</package> to display the

API doc and a custom <classname>qt:list-model</classname>

for the <classname>qt:list-view</classname> of the available classes.

</para>

- <imagedata fileref="class-browser.png" format="PNG"/>

+ <imagedata fileref="class-browser.png" format="PNG"/>

</imageobject>

</mediaobject>

</screenshot>

<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../qt.examples/src/class-browser.lisp" parse="text" />

-</programlisting>

+</programlisting>

</example>

</section>

+<section id="opengl"><title>OpenGL</title>

+<para>

+For OpenGL a binding is needed (e.g.:

+<ulink url="http://common-lisp.net/project/cl-opengl/">cl-opengl</ulink>).

+</para>

+<example><title>Origami</title>

+<para>

+<ulink url="http://tobias.rautenkranz.ch/darcsweb/darcsweb.cgi?r=cl-smoke/qt.examples;a=tree;f=/src/origami">Origami</ulink>

+draws a pleated hyperbolic paraboloid using the method described in

+<ulink url="http://arxiv.org/abs/0906.4747">(Non)existence of Pleated Folds: How Paper Folds Between Creases</ulink>

+</para>

+<mediaobject>

+<videoobject>

+<videodata fileref='origami.ogg'/>

+</videoobject>

+</mediaobject>

+<para>

+<note>

+<para>

+<ulink url="http://axiom-wiki.newsynthesis.org/FrontPage">Axiom</ulink> is needed to generate the lisp source to that

+calculates the vertices.

+</para>

+</note>

+</para>

+</example>

+</section>

</chapter>

diff -rN -u old-doc/smoke.xml new-doc/smoke.xml

--- old-doc/smoke.xml 2014-10-30 07:11:52.000000000 +0100

+++ new-doc/smoke.xml 2014-10-30 07:11:52.000000000 +0100

@@ -1,7 +1,7 @@

<?xml version="1.0"?>

<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"

"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

-<chapter id="smoke">

+<chapter id="usage">

<title>Usage</title>

<section><title>Symbols</title>

@@ -17,7 +17,7 @@

</informalexample>

</section>

-<section><title>Class</title>

+<section id="classes"><title>Class</title>

<para>

C++ classes have a corresponding CLOS class. The can be used like any CLOS class; E.g:

to make a <code>QObject</code> instance:

@@ -30,7 +30,14 @@

(let ((parent (make-instance '<classname>qt:object</classname>)))

- (make-instance '<classname>qt:object</classname> :args (list parent)))

+ (make-instance '<classname>qt:object</classname> :args (list parent)))

+</programlisting>

+</informalexample>

+or use <code>:arg0</code>, <code>:arg1</code> and <code>:arg2</code>.

+<informalexample>

+<programlisting language="lisp">

+(let ((parent (make-instance '<classname>qt:object</classname>)))

+ (make-instance '<classname>qt:object</classname> :arg0 parent))

</programlisting>

</informalexample>

</para>

@@ -39,14 +46,26 @@

(defclass my-object (<classname>qt:object</classname>)

- ()

- (:metaclass <classname>cxx:class</classname>))

+ ()

+ (:metaclass <classname>cxx:class</classname>))

+(make-instance 'my-object)

+</programlisting>

+</informalexample>

+The first superclass must be a Smoke class. When you define a class that has several Smoke superclasses,

+they will be constructed with their default constructor. For the first Smoke superclass you can supply arguments

+with the <code>:args</code> and <code>:arg0</code> etc. keywords.

+<informalexample>

+<programlisting language="lisp">

+(defclass my-graphics-object (<classname>qt:object</classname> <classname>qt:graphics-item</classname>)

+ ()

+ (:metaclass <classname>cxx:class</classname>))

</programlisting>

</informalexample>

</para>

</section>

-<section><title>Methods</title>

+<section id="methods"><title>Methods</title>

<para>

C++ methods are generic functions in the <package>:cxx</package> package.

</para>

@@ -72,9 +91,6 @@

</informalexample>

In the second case a temporary <classname>qt:color</classname> instance is implicitly created.

</para>

-<para>

-User defined conversions for return values are currently not supported (in <code>defmethods</code>).

-</para>

</section>

<section><title>Setter Methods</title>

@@ -102,12 +118,12 @@

</para>

<programlisting language="lisp">(defclass the-object-does-nothing (<classname>qt:object</classname>)

- ()

- (:metaclass <classname>cxx:class</classname>))

+ ()

+ (:metaclass <classname>cxx:class</classname>))

(defmethod <genericfunction>cxx:timer-event</genericfunction> ((object the-object-does-nothing) event)

- (declare (ignore object event))

- (call-next-method))

+ (declare (ignore object event))

+ (call-next-method))

</programlisting>

</informalexample>

<para>

@@ -169,7 +185,7 @@

</section>

-<section><title>Static Methods</title>

+<section id="static_methods"><title>Static Methods</title>

<para>

The static C++ method <code>QByteArray::number(int n, int base=10)</code>

can be called by:

@@ -188,15 +204,29 @@

</para>

</section>

-<section><title>Constants</title>

+<section id="constants"><title>Constants</title>

+<para>

+ C++ Class enums available as constants. E.g.:

+ <code>QColor::Rgb</code> is <constant>qt:color.+rgb+</constant>.

+ See <package>:cxx-support</package>.

+</para>

+</section>

+<section id="members"><title>Member variables</title>

<para>

- C++ Class enums available as constants. E.g.:

- <code>QColor::Rgb</code> is <constant>qt:color.+rgb+</constant>.

- See <package>:cxx-support</package>.

+C++ member variables of an instance can be accessed by using <code>slot-value</code>; e.g.:

+<informalexample>

+<programlisting language="lisp">(slot-value (make-instance 'qt:object) :static-meta-object)</programlisting>

+</informalexample>

+or

+<informalexample>

+<programlisting language="lisp">(slot-value (find-class 'qt:object) :static-meta-object)</programlisting>

+</informalexample>

+Usually they can also be accessed using methods from the <package>:cxx</package> package.

</para>

</section>

-<section><title>Garbage Collection</title>

+<section id="gc"><title>Garbage Collection</title>

<para>

You should be able to use C++ Class instances like normal Lisp object.

</para>

@@ -208,20 +238,7 @@

</para>

<para>

-An instance may depend on an other one.

-It is a bad idea to do something like this:

-<programlisting language="lisp">

-(defvar *meta* (<genericfunction>cxx:meta-object</genericfunction> (make-instance 'qt:object)))

-</programlisting>

-<code>*meta*</code> references a <classname>qt:meta-class</classname>

-that can become invalid at any time, since the <classname>qt:object</classname> instance can

-be garbage collected, and then the <code>QMetaObject</code> instance is deleted along

-with the <code>QObject</code>.

-</para>

-</caution>

-<caution>

-<para>

- Ownership transfer for non QObject instances is mostly unimplemented.

+ Ownership transfer for non QObject instances is mostly unimplemented.

</para>

</caution>

</section>

diff -rN -u old-doc/video.xsl new-doc/video.xsl

--- old-doc/video.xsl 1970-01-01 01:00:00.000000000 +0100

+++ new-doc/video.xsl 2014-10-30 07:11:52.000000000 +0100

@@ -0,0 +1,27 @@

+<?xml version='1.0'?>

+<xsl:stylesheet version="1.0"

+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

+

+<xsl:template match="videodata">

+ <video controls="true">

+ <xsl:attribute name="src">

+ <xsl:value-of select="@fileref" />

+ </xsl:attribute>

+ <img>

+ <xsl:attribute name="src">

+ <xsl:value-of select="concat(substring-before(@fileref, 'ogg'),'png')" />

+ </xsl:attribute>

+ </img>

+ <p>

+ <a>

+ <xsl:attribute name="href">

+ <xsl:value-of select="@fileref" />

+ </xsl:attribute>

+ <xsl:text>Download Video</xsl:text>

+ </a>

+ </p>

+ </video>

+</xsl:template>

+</xsl:stylesheet>

Crece desde el pueblo el futuro / crece desde el pie

RSS