source: general/prog/vala.xml@ 35400a4

elogind
Last change on this file since 35400a4 was 35400a4, checked in by DJ Lucas <dj@…>, 2 years ago

Merge to HEAD 21680.

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

  • Property mode set to 100644
File size: 7.9 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 vala-download-http "&gnome-download-http;/vala/&vala-major-version;/vala-&vala-version;.tar.xz">
8 <!ENTITY vala-download-ftp "&gnome-download-ftp;/vala/&vala-major-version;/vala-&vala-version;.tar.xz">
9 <!ENTITY vala-md5sum "0b2b537bb098843f892f138cbdf0c6df">
10 <!ENTITY vala-size "3.2 MB">
11 <!ENTITY vala-buildsize "170 MB (add 5 MB for tests)">
12 <!ENTITY vala-time "1.0 SBU (add 1.5 SBU for tests)">
13]>
14
15<sect1 id="vala" xreflabel="Vala-&vala-version;">
16 <?dbhtml filename="vala.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Vala-&vala-version;</title>
24
25 <indexterm zone="vala">
26 <primary sortas="a-Vala">Vala</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Vala</title>
31
32 <para>
33 <application>Vala</application> is a new programming language that
34 aims to bring modern programming language features to
35 <application>GNOME</application> developers without imposing any
36 additional runtime requirements and without using a different ABI
37 compared to applications and libraries written in C.
38 </para>
39
40 &lfs84_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&vala-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&vala-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &vala-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &vala-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &vala-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &vala-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75<!--
76 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
77 <itemizedlist spacing="compact">
78 <listitem>
79 <para>
80 Optional patch to allow building without graphviz.
81 <ulink url="&patch-root;/vala-&vala-version;-avoid_graphviz-1.patch"/>
82 </para>
83 </listitem>
84 </itemizedlist>
85-->
86 <bridgehead renderas="sect3">Vala Dependencies</bridgehead>
87
88 <bridgehead renderas="sect4">Required</bridgehead>
89 <para role="required">
90 <xref linkend="glib2"/>
91 </para>
92
93 <bridgehead renderas="sect4">Recommended</bridgehead>
94 <para role="recommended">
95 <xref linkend="graphviz"/> (Required for valadoc)
96 </para>
97
98 <bridgehead renderas="sect4">Optional</bridgehead>
99 <para role="optional">
100 <xref linkend="dbus"/> (Required for the tests),
101 <xref linkend="libxslt"/> (Required for generating the documentation),
102 <ulink url="https://ftp.gnu.org/gnu/help2man/">help2man</ulink>, and
103 <ulink url="https://weasyprint.org/">weasyprint</ulink>
104 </para>
105
106 <para condition="html" role="usernotes">User Notes:
107 <ulink url="&blfs-wiki;/vala"/>
108 </para>
109 </sect2>
110
111 <sect2 role="installation">
112 <title>Installation of Vala</title>
113
114 <para>Install <application>Vala</application> by running the following
115 commands:</para>
116<!--
117 <note>
118 <para>If the recommended dependency <xref linkend="graphviz"/> is not
119 installed, apply a patch. This will prevent building the valadoc program
120 and libraries that can be used to generate API documentation in HTML format
121 from Vala source code.
122 </para>
123
124<screen><userinput>patch -p1 -i ../vala-&vala-version;-avoid_graphviz-1.patch &amp;&amp;
125ACLOCAL= autoreconf -fiv</userinput></screen>
126 </note>
127-->
128<screen><userinput>./configure --prefix=/usr &amp;&amp;
129make</userinput></screen>
130
131 <para>
132 To test the results, issue: <command>make check</command>.
133 </para>
134
135 <para>
136 Now, as the <systemitem class="username">root</systemitem> user:
137 </para>
138
139<screen role="root"><userinput>make install</userinput></screen>
140
141 </sect2>
142
143 <sect2 role="commands">
144 <title>Command Explanations</title>
145
146 <para>
147 <option>--disable-valadoc</option>: This option is
148 required if <xref linkend="graphviz"/> is not installed.
149 </para>
150
151 </sect2>
152
153 <sect2 role="content">
154 <title>Contents</title>
155
156 <segmentedlist>
157 <segtitle>Installed Programs</segtitle>
158 <segtitle>Installed Library</segtitle>
159 <segtitle>Installed Directories</segtitle>
160
161 <seglistitem>
162 <seg>
163 vala,
164 vala-&vala-major-version;,
165 valac,
166 valadoc,
167 vala-gen-introspect, and
168 vapigen (symlinks);
169
170 valac-&vala-major-version;,
171 valadoc-&vala-major-version;,
172 vala-gen-introspect-&vala-major-version;, and
173 vapigen-&vala-major-version;
174 </seg>
175 <seg>
176 libvala-&vala-major-version;.so and
177 libvaladoc-&vala-major-version;.so
178 </seg>
179 <seg>
180 /usr/include/vala-&vala-major-version;,
181 /usr/include/valadoc-&vala-major-version;,
182 /usr/lib/vala-&vala-major-version;,
183 /usr/lib/valadoc,
184 /usr/share/vala,
185 /usr/share/valadoc,
186 /usr/share/devhelp/books/vala-&vala-major-version;, and
187 /usr/share/vala-&vala-major-version;
188 </seg>
189 </seglistitem>
190 </segmentedlist>
191
192 <variablelist>
193 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
194 <?dbfo list-presentation="list"?>
195 <?dbhtml list-presentation="table"?>
196
197 <varlistentry id="valac">
198 <term><command>valac</command></term>
199 <listitem>
200 <para>
201 is a compiler that translates <application>Vala</application>
202 source code into C source and header files.
203 </para>
204 <indexterm zone="vala valac">
205 <primary sortas="b-valac">valac</primary>
206 </indexterm>
207 </listitem>
208 </varlistentry>
209
210 <varlistentry id="vala-gen-introspect">
211 <term><command>vala-gen-introspect</command></term>
212 <listitem>
213 <para>
214 generates a GI file for GObject and
215 <application>GLib</application> based packages.
216 </para>
217 <indexterm zone="vala vala-gen-introspect">
218 <primary sortas="b-vala-gen-introspect">vala-gen-introspect</primary>
219 </indexterm>
220 </listitem>
221 </varlistentry>
222
223<!--
224 <varlistentry id="vapicheck">
225 <term><command>vapicheck</command></term>
226 <listitem>
227 <para>
228 verifies the generated bindings.
229 </para>
230 <indexterm zone="vala vapicheck">
231 <primary sortas="b-vapicheck">vapicheck</primary>
232 </indexterm>
233 </listitem>
234 </varlistentry>-->
235
236 <varlistentry id="vapigen">
237 <term><command>vapigen</command></term>
238 <listitem>
239 <para>
240 is an utility which generates <application>Vala</application> API
241 (VAPI) files from GI files.
242 </para>
243 <indexterm zone="vala vapigen">
244 <primary sortas="b-vapigen">vapigen</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="libvala">
250 <term><filename class="libraryfile">libvala-&vala-major-version;.so</filename></term>
251 <listitem>
252 <para>
253 contains the <application>Vala</application> API functions.
254 </para>
255 <indexterm zone="vala libvala">
256 <primary sortas="c-libvala">libvala-&vala-major-version;.so</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260
261 </variablelist>
262
263 </sect2>
264
265</sect1>
Note: See TracBrowser for help on using the repository browser.