]> Emmanuele Bassi

&ebassi_mail;

Elliot Smith

&elliot_mail;

2009, 2010 Intel Corporation Permission is granted to copy, distribute and/or modify this document under the terms of the Creative Commons Attribution-Non-Commercial-Share Alike 2.0 UK: England & Wales as published by Creative Commons. for Clutter &apiversion; This document is written in Docbook XML. The source files for this document are located in the subdirectory doc/cookbook inside the Clutter source directory. To maintain some degree of consistency, try to stick to the following broad guidelines about how to write Docbook for this cookbook: If adding a new recipe, use the recipe-template.xml XML file as a basis. You can find it in the <clutter source>/doc/cookbook/ directory. Try to indent your XML sensibly using 2 spaces per level (we're not too strict, but some indentation helps reading the source). Stick to a column width of around 80 characters. Use the <filename> element for file and directory names. Use the <property> element for property names (e.g. GObject properties). Use the <type> element for GObject class names. Use the <constant> element for C defines. Use the <keycap> element for keys, where you are referring to what's actually printed on the key, e.g. Shift. If you're referring to the key some other way (e.g. "the Control key"), don't use <keycap>. Use the <function> element for functions; the style adopted is to give the function name followed by empty brackets, e.g. clutter_actor_set_size(). Use the <note> element for asides which might otherwise interrupt the flow of the recipe. To include a video in a recipe, do the following: Make the video as short as is practical, and only include the relevant Clutter window(s). Use Ogg Theora for the encoding. Put the file into the <clutter source>/doc/cookbook/videos directory. The name should be in the format <section>-<recipe>-<identifier>.ogv. For example: animations-fading-fade-out.ogv. Add the name of the file to the in the cookbook's Makefile.am, e.g. This ensures it gets included in the distribution and installation. Use an <inlinemediaobject> to include it in the Docbook recipe file. It should look something like this: Video showing an actor fading in then out using ClutterState ]]> The <alt> tag provides the text which is presented as a link to the file for users whose browser doesn't support HTML 5 embedded video.