source: gnome/platform/gjs.xml@ a709780

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since a709780 was a709780, checked in by Douglas R. Reno <renodr@…>, 8 months ago

Tag GNOME Libraries, off to GNOME Desktop next.
Update test expectations for tracker*

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24294 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 6.2 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 gjs-download-http "&gnome-download-http;/gjs/1.66/gjs-&gjs-version;.tar.xz">
8 <!ENTITY gjs-download-ftp "&gnome-download-ftp;/gjs/1.66/gjs-&gjs-version;.tar.xz">
9 <!ENTITY gjs-md5sum "3c272f27a2ce18c82261698520b1147f">
10 <!ENTITY gjs-size "432 KB">
11 <!ENTITY gjs-buildsize "82 MB (with tests)">
12 <!ENTITY gjs-time "0.8 SBU (with tests)">
13]>
14
15<sect1 id="gjs" xreflabel="Gjs-&gjs-version;">
16 <?dbhtml filename="gjs.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Gjs-&gjs-version;</title>
24
25 <indexterm zone="gjs">
26 <primary sortas="a-Gjs">Gjs</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Gjs</title>
31
32 <para>
33 <application>Gjs</application> is a set of Javascript bindings for
34 <application>GNOME</application>.
35 </para>
36
37 &lfs101_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&gjs-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&gjs-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &gjs-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &gjs-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &gjs-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &gjs-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Gjs Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Required</bridgehead>
76 <para role="required">
77 <xref linkend="cairo"/>,
78 <xref linkend="dbus"/>,
79 <xref linkend="gobject-introspection"/>, and
80 <xref linkend="js78"/>
81 </para>
82
83 <bridgehead renderas="sect4">Recommended (required for GNOME)</bridgehead>
84 <para role="recommended">
85 <xref linkend="gtk3"/>
86 </para>
87
88 <bridgehead renderas="sect4">Optional</bridgehead>
89 <para role="optional">
90 <xref linkend="sysprof"/>,
91 <xref linkend="valgrind"/> (for tests),
92 <ulink url="http://dtrace.org/blogs/about">DTrace</ulink>,
93 <ulink url="https://wiki.gnome.org/Projects/GTK/Roadmap/GTK4">GTK+-4</ulink>,
94 <ulink url="http://ltp.sourceforge.net/coverage/lcov.php">LCOV</ulink>, and
95 <ulink url="https://sourceware.org/systemtap">Systemtap</ulink>
96 </para>
97
98 <para condition="html" role="usernotes">User Notes:
99 <ulink url="&blfs-wiki;/gjs"/>
100 </para>
101 </sect2>
102
103 <sect2 role="installation">
104 <title>Installation of Gjs</title>
105<!--
106 <para>
107 First, work around a bug in meson caused by support for Windows NT:
108 </para>
109
110 When scripting, 'ninja install' fails because the 'gjs' symlink is
111 generated before 'gjs-console' is installed. This seems to be due
112 to adding symbolic link support for Windows NT-based platforms.
113 This shouldn't affect us, so let's create the symlink manually
114 like we do in other packages.
115 Invalid with 1.64.3. Make sure you don't have DESTDIR
116 set, such as you'd do in an update script.
117
118<screen><userinput remap="pre">sed -i '/symlink-gjs.py/s/^/#/g' meson.build</userinput></screen>-->
119
120 <para>
121 Install <application>Gjs</application> by running the following
122 commands:
123 </para>
124
125<screen><userinput>mkdir gjs-build &amp;&amp;
126cd gjs-build &amp;&amp;
127
128meson --prefix=/usr .. &amp;&amp;
129ninja</userinput></screen>
130
131 <para>
132 To test the results, issue: <command>ninja test</command>. The
133 <application>GTK</application> and <application>Cairo</application>
134 tests will fail if not running in an Xorg session. <!--Additionally, four
135 tests are currently known to fail:
136 <filename>gjs:C / API tests</filename>,
137 <filename>gjs:JS / GIMarshalling</filename>,
138 <filename>gjs:JS / Regress</filename>, and
139 <filename>gjs:JS / Gtk3</filename>.-->
140 </para>
141
142 <para>
143 Now, as the <systemitem class="username">root</systemitem> user:
144 </para>
145
146<screen role="root"><userinput>ninja install &amp;&amp;
147ln -sfv gjs-console /usr/bin/gjs</userinput></screen>
148
149 </sect2>
150
151 <sect2 role="content">
152 <title>Contents</title>
153
154 <segmentedlist>
155 <segtitle>Installed Programs</segtitle>
156 <segtitle>Installed Library</segtitle>
157 <segtitle>Installed Directories</segtitle>
158
159 <seglistitem>
160 <seg>
161 gjs (symlink) and gjs-console
162 </seg>
163 <seg>
164 libgjs.so
165 </seg>
166 <seg>
167 /usr/include/gjs-1.0,
168 /usr/lib/gjs,
169 /usr/libexec/installed-tests/gjs,
170 /usr/share/gjs-1.0, and
171 /usr/share/installed-tests/gjs
172 </seg>
173 </seglistitem>
174 </segmentedlist>
175
176 <variablelist>
177 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
178 <?dbfo list-presentation="list"?>
179 <?dbhtml list-presentation="table"?>
180
181 <varlistentry id="gjs-console">
182 <term><command>gjs-console</command></term>
183 <listitem>
184 <para>
185 contains a console to run <application>JavaScript</application>
186 commands
187 </para>
188 <indexterm zone="gjs gjs-console">
189 <primary sortas="b-gjs-console">gjs-console</primary>
190 </indexterm>
191 </listitem>
192 </varlistentry>
193
194 <varlistentry id="libgjs">
195 <term><filename class="libraryfile">libgjs.so</filename></term>
196 <listitem>
197 <para>
198 contains the <application>GNOME</application> JavaScript bindings
199 </para>
200 <indexterm zone="gjs libgjs">
201 <primary sortas="c-libgjs">libgjs.so</primary>
202 </indexterm>
203 </listitem>
204 </varlistentry>
205
206 </variablelist>
207
208 </sect2>
209
210</sect1>
Note: See TracBrowser for help on using the repository browser.