~oem-solutions-group/unity-2d/clutter-1.0

« back to all changes in this revision

Viewing changes to doc/manual/clutter-manual.xml.in

  • Committer: Bazaar Package Importer
  • Author(s): Emilio Pozuelo Monfort
  • Date: 2010-03-21 13:27:56 UTC
  • mto: (2.1.3 experimental)
  • mto: This revision was merged to the branch mainline in revision 8.
  • Revision ID: james.westby@ubuntu.com-20100321132756-nf8yd30yxo3zzwcm
Tags: upstream-1.2.2
ImportĀ upstreamĀ versionĀ 1.2.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
<?xml version='1.0' encoding='UTF-8'?>
2
2
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3
3
        "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4
 
<!ENTITY appversion "@CLUTTER_MAJORMINOR@">
5
 
<!ENTITY appurl "http://clutter-project.org">
 
4
<!ENTITY apiversion "@CLUTTER_API_VERSION@">
 
5
<!ENTITY appurl "http://www.clutter-project.org/docs">
6
6
<!ENTITY author_mail "mallum@o-hand.com">
7
7
]>
8
8
 
9
9
<book lang="en">
10
 
        <bookinfo>
11
 
                <author>
12
 
                        <firstname>Matthew</firstname>
13
 
                        <surname>Allum</surname>
14
 
                        <address><email>&author_mail;</email></address>
15
 
                </author>
16
 
                <copyright>
17
 
                        <year>2007</year>
18
 
                </copyright>
19
 
                <legalnotice>
20
 
                        <para>
21
 
                                This document is distributed under the terms of the GNU General Public License as published by the Free
22
 
                                Software Foundation; either version 2 of the License, or (at your option) any later version.
23
 
                                A copy of this license can be found in the file COPYING included with the source code of this
24
 
                                program.
25
 
                        </para>
26
 
                </legalnotice>
27
 
                <title>
28
 
                        Clutter Application Developer Manual &appversion;
29
 
                </title>
30
 
        </bookinfo>
31
 
 
32
 
        <chapter id="intro">
33
 
                <title>
34
 
                        Introduction
35
 
                </title>
36
 
                <section>
37
 
                        <title>About Clutter</title>
38
 
                        <para>
39
 
                        FIXME
40
 
                        </para>
41
 
                </section>
42
 
                <section>
43
 
                        <title>About this document</title>
44
 
                        <para>
45
 
                                This documentation is available in various formats like HTML, text and PDF. The latest version is
46
 
                                always available at <ulink url="&appurl;">&appurl;</ulink>.
47
 
                        </para>
48
 
                </section>
49
 
                <section>
50
 
                        <title>Where to get it</title>
51
 
                        <para>
52
 
                                You can obtain Clutter from <ulink url="&appurl;">&appurl;</ulink>
53
 
                                or perhaps from your distributor.
54
 
                        </para>
55
 
                </section>
56
 
                <section>
57
 
                        <title>License</title>
58
 
                        <para>
59
 
                                Clutter is distributed under the terms of the GNU Lesser General Public License as published
60
 
                                by the Free     Software Foundation; either version 2 of the License, or (at your option) any later version.
61
 
                                A copy of this license can be found in the file COPYING included with the source code of this
62
 
                                program.
63
 
                        </para>
64
 
                </section>
65
 
        </chapter>
66
 
 
67
 
        <chapter id="installation">
68
 
                <title>
69
 
                        Installation
70
 
                </title>
71
 
                <section>
72
 
                        <title>Requirements</title>
73
 
                        <para>
74
 
                        </para>
75
 
                        <para>
76
 
                        </para>
77
 
                </section>
78
 
                <section id="binary_packages">
79
 
                        <title>Binary packages</title>
80
 
                        <para>
81
 
                        </para>
82
 
                </section>
83
 
        </chapter>
84
 
 
85
 
        <appendix id="FAQ">
86
 
                 <title>
87
 
                        Frequently Asked Questions
88
 
                </title>
89
 
                <qandaset defaultlabel='qanda'>
90
 
                <qandaentry>
91
 
                        <question>
92
 
                                <para>
93
 
 
94
 
                                Why do Clutter applications run <emphasis>really</emphasis> slowly on Intel cards even though 
95
 
                                direct rendering support is reported.
96
 
 
97
 
                                </para>
98
 
                        </question>                     
99
 
                        <answer>
100
 
                                <para>
101
 
 
102
 
                                There is a bug in some versions of the Intel drivers that causes the driver to 'stall' when 
103
 
                                attempting to sync to vblank (as Clutter does by default). The fix is to either upgrade 
104
 
                                your drivers or set 'CLUTTER_VBLANK=none' when running Clutter applications.                                    
105
 
 
106
 
                                </para>
107
 
                        </answer>
108
 
                </qandaentry>           
109
 
                </qandaset>     
110
 
        </appendix>
111
 
 
112
 
        <appendix id="contrib">
113
 
            <title>Contributing to this document</title>
114
 
            <para>
115
 
 
116
 
                  This document is written in Docbook XML. The source file for it is located in the
117
 
                  subdirectory "doc/manual" of the source directory of Clutter.
118
 
 
119
 
            </para>
120
 
        </appendix>
121
 
 
 
10
        <bookinfo>
 
11
                <author>
 
12
                        <firstname>Matthew</firstname>
 
13
                        <surname>Allum</surname>
 
14
                        <address><email>&author_mail;</email></address>
 
15
                </author>
 
16
 
 
17
                <copyright>
 
18
                        <year>2007</year>
 
19
                </copyright>
 
20
 
 
21
                <legalnotice>
 
22
                        <para>This document is distributed under the terms of
 
23
                        the GNU General Public License as published by the Free
 
24
                        Software Foundation; either version 2 of the License,
 
25
                        or (at your option) any later version.</para>
 
26
                        <para>A copy of this license can be found in the file COPYING included with the source code of this program.</para>
 
27
                </legalnotice>
 
28
 
 
29
                <title>Clutter Application Developer Manual</title>
 
30
                <releaseinfo>for Clutter &apiversion;</releaseinfo>
 
31
        </bookinfo>
 
32
 
 
33
        <chapter id="intro">
 
34
                <title>Introduction</title>
 
35
                <section>
 
36
                        <title>About Clutter</title>
 
37
                        <para>FIXME</para>
 
38
                </section>
 
39
                <section>
 
40
                        <title>About this document</title>
 
41
                        <para>
 
42
                                This documentation is available in various formats like HTML, text and PDF. The latest version is
 
43
                                always available at <ulink url="&appurl;">&appurl;</ulink>.
 
44
                        </para>
 
45
                </section>
 
46
                <section>
 
47
                        <title>Where to get it</title>
 
48
                        <para>
 
49
                                You can obtain Clutter from <ulink url="&appurl;">&appurl;</ulink>
 
50
                                or perhaps from your distributor.
 
51
                        </para>
 
52
                </section>
 
53
                <section>
 
54
                        <title>License</title>
 
55
                        <para>
 
56
                                Clutter is distributed under the terms of the GNU Lesser General Public License as published
 
57
                                by the Free        Software Foundation; either version 2 of the License, or (at your option) any later version.
 
58
                                A copy of this license can be found in the file COPYING included with the source code of this
 
59
                                program.
 
60
                        </para>
 
61
                </section>
 
62
        </chapter>
 
63
 
 
64
        <chapter id="installation">
 
65
                <title>Installation</title>
 
66
                <section>
 
67
                        <title>Requirements</title>
 
68
                        <para>
 
69
                        </para>
 
70
                        <para>
 
71
                        </para>
 
72
                </section>
 
73
                <section id="binary_packages">
 
74
                        <title>Binary packages</title>
 
75
                        <para>
 
76
                        </para>
 
77
                </section>
 
78
        </chapter>
 
79
 
 
80
        <appendix id="FAQ">
 
81
                 <title>Frequently Asked Questions</title>
 
82
                <qandaset defaultlabel='qanda'>
 
83
                <qandaentry>
 
84
                        <question>
 
85
                                <para>Why do Clutter applications run <emphasis>really</emphasis> slowly on Intel cards even though direct rendering support is reported.</para>
 
86
                        </question>
 
87
                        <answer>
 
88
                                <para>There is a bug in some versions of the Intel drivers that causes the driver to 'stall' when attempting to sync to vblank (as Clutter does by default). The fix is to either upgrade your drivers or set 'CLUTTER_VBLANK=none' when running Clutter applications.</para>
 
89
                        </answer>
 
90
                </qandaentry>
 
91
                </qandaset>
 
92
        </appendix>
 
93
 
 
94
        <appendix id="contrib">
 
95
            <title>Contributing to this document</title>
 
96
            <para>This document is written in Docbook XML. The source file for it is located in the subdirectory "doc/manual" of the source directory of Clutter.</para>
 
97
        </appendix>
122
98
</book>