/usr/share/gtk-doc/html/clutter-cookbook/introduction.html is in libclutter-1.0-doc 1.16.4-0ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>Chapter 1. Preface</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="The Clutter Cookbook"><link rel="up" href="index.html" title="The Clutter Cookbook"><link rel="prev" href="index.html" title="The Clutter Cookbook"><link rel="next" href="ch01s02.html" title="2. About this document"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 1. Preface</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="introduction"></a>Chapter 1. Preface</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="introduction.html#idp42344548">1. About Clutter</a></span></dt><dt><span class="section"><a href="ch01s02.html">2. About this document</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s02.html#idp37485756">2.1. Compiling the examples</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s03.html">3. Acknowledgments</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s03.html#idp37489988">3.1. Acknowledgments from Emmanuele</a></span></dt><dt><span class="section"><a href="ch01s03.html#idp37490932">3.2. Acknowledgements from Elliot</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s04.html">4. Where to get Clutter</a></span></dt></dl></div><div class="epigraph"><p>Let me show you that easy way, so others may easily follow.</p><div class="attribution"><span>—<span class="attribution">The Perl Cookbook</span></span></div></div><p>There is a wonderful simile in the preface of the <span class="emphasis"><em>Perl
Cookbook</em></span>: approaching a programming problem is oftentimes
similar to balancing Columbus's egg. The initial difficulties of dealing
with, and more importantly solving, problems in the software engineering
field sometimes can only be overcome if somebody shows you how to use a
new tool. This is true for programming languages but also for programming
libraries.</p><p>This book has been written to try and give you a reference on
how to solve common issues that you might have to face when using
the Clutter toolkit.</p><p>This book is not meant to be a replacement for the Clutter API
reference, even though there will be descriptions of how Clutter works
and how its API looks like. We will require knowledge of the Clutter API,
but we will also point out where to find more information on the API that
examples have used.</p><p>Indeed, this book should be used as a companion to the API reference,
expanding its examples and showing how to achieve a specific result.</p><p>This is not a book for learning Clutter. This is also not a book
for learning C, or GObject or even GUI development.</p><p>Above all, this is a book for learning <span class="emphasis"><em>more</em></span>
about Clutter, and about how to use it in the most efficient and easiest
way. It is meant to help you move past the basic usage of Clutter.</p><p>This book is divided into chapters. Each chapter is dedicated to
a specific class, like ClutterTexture, or a specific area, like animations.
Each chapter starts with a short introduction, followed by different
<span class="emphasis"><em>recipes</em></span>. Each recipe starts with a problem, or a short
statement describing what we want to achieve; a solution, containing the
source code; and a discussion section, where the code is explained, where
alternative approaches might be useful, and where caveats and references to
the Clutter API for further studying can be found.</p><p>This book, in the cookbook spirit, can be accessed mostly at
random.</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idp42344548"></a>1. About Clutter</h2></div></div></div><p>Clutter is an free and open source software library for creating
portable, dynamic, compelling and fast graphical user interfaces.</p><p>Clutter uses OpenGL (and, optionally, OpenGL ES on mobile and
embedded platforms) for rendering the user interface elements, but
at the same time it exposes an application program interface that hides
the underlying complexity of the OpenGL state machine from the
developer.</p><p>The program interface of Clutter is intended to be easy to use,
efficient, flexible and as self-documenting as possible.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">The Clutter Cookbook </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 2. About this document</td></tr></table></div></body></html>
|