source: gnome/applications/cheese.xml@ 2a8945c4

11.0 ken/refactor-virt lazarus qt5new trunk upgradedb
Last change on this file since 2a8945c4 was 2a8945c4, checked in by Douglas R. Reno <renodr@…>, 6 months ago

Cheese: note that generating the documentation is broken due to an
incompatibility with gtk-doc.

  • Property mode set to 100644
File size: 7.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY cheese-download-http "&gnome-download-http;/cheese/&gnome-minor-38;/cheese-&cheese-version;.tar.xz">
8 <!ENTITY cheese-download-ftp "&gnome-download-ftp;/cheese/&gnome-minor-38;/cheese-&cheese-version;.tar.xz">
9 <!ENTITY cheese-md5sum "83b580b1451b27d43403d3ae5829e08c">
10 <!ENTITY cheese-size "1.0 MB">
11 <!ENTITY cheese-buildsize "21 MB">
12 <!ENTITY cheese-time "0.2 SBU (Using paralleism=4)">
13]>
14
15<sect1 id="cheese" xreflabel="Cheese-&cheese-version;">
16 <?dbhtml filename="cheese.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>Cheese-&cheese-version;</title>
23
24 <indexterm zone="cheese">
25 <primary sortas="a-Cheese">Cheese</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to Cheese</title>
30
31 <para>
32 <application>Cheese</application> is used to take
33 photos and videos with fun graphical effects.
34 </para>
35
36 &lfs101_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>
42 Download (HTTP): <ulink url="&cheese-download-http;"/>
43 </para>
44 </listitem>
45 <listitem>
46 <para>
47 Download (FTP): <ulink url="&cheese-download-ftp;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download MD5 sum: &cheese-md5sum;
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download size: &cheese-size;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Estimated disk space required: &cheese-buildsize;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated build time: &cheese-time;
68 </para>
69 </listitem>
70 </itemizedlist>
71
72 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
73 <itemizedlist spacing="compact">
74 <listitem>
75 <para>
76 Required patch:
77 <ulink url="&patch-root;/cheese-&cheese-version;-upstream_fixes-1.patch"/>
78 </para>
79 </listitem>
80 </itemizedlist>
81
82 <bridgehead renderas="sect3">Cheese Dependencies</bridgehead>
83
84 <bridgehead renderas="sect4">Required</bridgehead>
85 <para role="required">
86 <xref linkend="clutter-gst"/>,
87 <xref linkend="clutter-gtk"/>,
88 <xref linkend="gnome-desktop"/>,
89 <xref linkend="gst10-plugins-bad"/>,
90 <xref linkend="gst10-plugins-good"/> (built with <xref linkend="v4l-utils"/>),
91 <xref linkend="libcanberra"/>, and
92 <xref linkend="libgudev"/>
93 </para>
94
95 <bridgehead renderas="sect4">Recommended</bridgehead>
96 <para role="recommended">
97 <xref role="runtime" linkend="gnome-video-effects"/> (at runtime, for video effects),
98 <xref linkend="gobject-introspection"/> and
99 <xref linkend="vala"/>
100 </para>
101
102 <bridgehead renderas="sect4">Optional</bridgehead>
103 <para role="optional">
104 <xref linkend="gtk-doc"/>,
105 <xref linkend="libxslt"/>,
106 <ulink url="&appstream-glib-url;">appstream-glib</ulink>,
107 <ulink url="http://ltp.sourceforge.net/coverage/lcov.php"> LCOV </ulink>, and
108 <ulink url="&gnome-download-http;/nautilus-sendto/">Nautilus SendTo</ulink>
109 </para>
110
111 <para condition="html" role="usernotes">User Notes:
112 <ulink url="&blfs-wiki;/cheese"/>
113 </para>
114 </sect2>
115
116 <sect2 role="kernel" id="cheese-kernel">
117 <title>Kernel Configuration</title>
118
119 <para>
120 Depending on your camera, enable the appropriate options and recompile the
121 kernel if necessary:
122 </para>
123
124<screen><literal>Device Drivers ---&gt;
125 Multimedia support ---&gt;
126 &lt;*&gt; Autoselect ancillary drivers (tuners, sensors, i2c, spi, frontends) [CONFIG_MEDIA_SUBDRV_AUTOSELECT]
127 Media device types ---&gt;
128 &lt;*&gt; Cameras/video grabbers support [CONFIG_MEDIA_CAMERA_SUPPORT]
129 Media drivers ---&gt;
130 &lt;*&gt; Media USB Adapters ---&gt; [CONFIG_MEDIA_USB_SUPPORT]
131 Select device(s) as needed</literal></screen>
132
133 <indexterm zone="cheese cheese-kernel">
134 <primary sortas="d-cheese">cheese</primary>
135 </indexterm>
136 </sect2>
137
138 <sect2 role="installation">
139 <title>Installation of Cheese</title>
140
141 <para>
142 First, fix a problem generating the man page:
143 </para>
144
145<screen><userinput>sed -i "s/&amp;version;/&cheese-version;/" docs/reference/cheese{,-docs}.xml</userinput></screen>
146
147 <para>
148 Next, fix some build issues due to removed Vala functions:
149 </para>
150
151<screen><userinput remap="pre">patch -Np1 -i ../cheese-&cheese-version;-upstream_fixes-1.patch</userinput></screen>
152
153 <para>
154 Install <application>Cheese</application> by running the following
155 commands:
156 </para>
157
158<screen><userinput>mkdir build &amp;&amp;
159cd build &amp;&amp;
160
161meson --prefix=/usr -Dgtk_doc=false .. &amp;&amp;
162ninja</userinput></screen>
163
164 <para>
165 This package does not have a working testsuite.
166 </para>
167
168 <para>
169 Now, as the <systemitem class="username">root</systemitem> user:
170 </para>
171
172<screen role="root"><userinput>ninja install</userinput></screen>
173
174 </sect2>
175
176 <sect2 role="commands">
177 <title>Command Explanations</title>
178
179 <para>
180 <parameter>-Dgtk_doc=false</parameter>: This switch prevents the build
181 system from generating and installing the API documentation. Omit this
182 switch if you have <xref linkend="gtk-doc" role="nodep"/> installed
183 and wish to generate and install the API documentation. Building the
184 documentation is broken due to an incompatibility with gtk-doc.
185 </para>
186 </sect2>
187
188 <sect2 role="content">
189 <title>Contents</title>
190
191 <segmentedlist>
192 <segtitle>Installed Program</segtitle>
193 <segtitle>Installed Library</segtitle>
194 <segtitle>Installed Directories</segtitle>
195
196 <seglistitem>
197 <seg>
198 cheese
199 </seg>
200 <seg>
201 libcheese.so and libcheese-gtk.so
202 </seg>
203 <seg>
204 /usr/{include,share/gtk-doc/html,share/help/*}/cheese
205 </seg>
206 </seglistitem>
207 </segmentedlist>
208
209 <variablelist>
210 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
211 <?dbfo list-presentation="list"?>
212 <?dbhtml list-presentation="table"?>
213
214 <varlistentry id="cheese-prog">
215 <term><command>cheese</command></term>
216 <listitem>
217 <para>
218 is a webcam tool with graphical effects
219 </para>
220 <indexterm zone="cheese cheese-prog">
221 <primary sortas="b-cheese">cheese</primary>
222 </indexterm>
223 </listitem>
224 </varlistentry>
225
226 <varlistentry id="libcheese">
227 <term><filename class="libraryfile">libcheese.so</filename></term>
228 <listitem>
229 <para>
230 contains the <application>Cheese</application> API functions
231 </para>
232 <indexterm zone="cheese libcheese">
233 <primary sortas="c-libcheese">libcheese.so</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="libcheese-gtk">
239 <term><filename class="libraryfile">libcheese-gtk.so</filename></term>
240 <listitem>
241 <para>
242 contains the <application>Cheese</application>
243 <application>GTK+</application> widgets
244 </para>
245 <indexterm zone="cheese libcheese-gtk">
246 <primary sortas="c-libcheese-gtk">libcheese-gtk.so</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250
251 </variablelist>
252
253 </sect2>
254
255</sect1>
Note: See TracBrowser for help on using the repository browser.