source: gnome/platform/gjs.xml@ 45ab6c7

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 5 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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