source: general/prog/vala.xml@ 7f80ece

10.0 10.1 11.0 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 7f80ece was 7f80ece, checked in by Pierre Labastie <pieere@…>, 4 years ago

Rmove installation of help2man from lsb_release, and reference GNU help2man
in packages that can use it (maybe not complete)

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

  • Property mode set to 100644
File size: 7.7 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 "37edd0467d056fd9e3937d0bbceda80b">
10 <!ENTITY vala-size "3.2 MB">
11 <!ENTITY vala-buildsize "153 MB (including tests)">
12 <!ENTITY vala-time "0.7 SBU (using parallelism=4; with 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 &lfs82_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 Required patch:
81 <ulink url="&patch-root;/vala-&vala-version;-upstream_fixes-2.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">Optional</bridgehead>
94 <para role="optional">
95 <xref linkend="dbus"/> (Required for the tests),
96 <xref linkend="graphviz"/> (Required for valadoc),
97 <xref linkend="libxslt"/> (Required for generating the documentation), and
98 <ulink url="https://ftp.gnu.org/gnu/help2man/">help2man</ulink>
99 </para>
100
101 <para condition="html" role="usernotes">User Notes:
102 <ulink url="&blfs-wiki;/vala"/>
103 </para>
104 </sect2>
105
106 <sect2 role="installation">
107 <title>Installation of Vala</title>
108
109 <para>Install <application>Vala</application> by running the following
110 commands:</para>
111
112 <note>
113 <para>The two sed commands and the autoreconf command below are required
114 if the optional dependency <xref linkend="graphviz"/> is not installed.
115 This will allow building the valadoc prgram and libraries that can be used
116 to generate API documentation in HTML format from Vala source code.
117 </para>
118 </note>
119
120<screen><userinput>sed -i '102d; 108,124d; 126,127d' configure.ac &amp;&amp;
121sed -i '/valadoc/d' Makefile.am &amp;&amp;
122ACLOCAL= autoreconf -fiv &amp;&amp;
123
124./configure --prefix=/usr &amp;&amp;
125make</userinput></screen>
126
127 <para>
128 To test the results, issue: <command>make check</command>.
129 </para>
130
131 <para>
132 Now, as the <systemitem class="username">root</systemitem> user:
133 </para>
134
135<screen role="root"><userinput>make install</userinput></screen>
136
137 </sect2>
138
139 <sect2 role="content">
140 <title>Contents</title>
141
142 <segmentedlist>
143 <segtitle>Installed Programs</segtitle>
144 <segtitle>Installed Library</segtitle>
145 <segtitle>Installed Directories</segtitle>
146
147 <seglistitem>
148 <seg>
149 vala,
150 vala-&vala-major-version;,
151 valac,
152 valadoc,
153 vala-gen-introspect,
154 vapicheck, and
155 vapigen (symlinks);
156
157 valac-&vala-major-version;,
158 valadoc-&vala-major-version;,
159 vala-gen-introspect-&vala-major-version;,
160 vapicheck-&vala-major-version;, and
161 vapigen-&vala-major-version;
162 </seg>
163 <seg>
164 libvala-&vala-major-version;.so and
165 libvaladoc-&vala-major-version;.so
166 </seg>
167 <seg>
168 /usr/include/vala-&vala-major-version;,
169 /usr/include/valadoc-&vala-major-version;,
170 /usr/lib/vala-&vala-major-version;,
171 /usr/lib/valadoc,
172 /usr/share/vala,
173 /usr/share/valadoc,
174 /usr/share/devhelp/books/vala-&vala-major-version;, and
175 /usr/share/vala-&vala-major-version;
176 </seg>
177 </seglistitem>
178 </segmentedlist>
179
180 <variablelist>
181 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
182 <?dbfo list-presentation="list"?>
183 <?dbhtml list-presentation="table"?>
184
185 <varlistentry id="valac">
186 <term><command>valac</command></term>
187 <listitem>
188 <para>
189 is a compiler that translates <application>Vala</application>
190 source code into C source and header files.
191 </para>
192 <indexterm zone="vala valac">
193 <primary sortas="b-valac">valac</primary>
194 </indexterm>
195 </listitem>
196 </varlistentry>
197
198 <varlistentry id="vala-gen-introspect">
199 <term><command>vala-gen-introspect</command></term>
200 <listitem>
201 <para>
202 generates a GI file for GObject and
203 <application>GLib</application> based packages.
204 </para>
205 <indexterm zone="vala vala-gen-introspect">
206 <primary sortas="b-vala-gen-introspect">vala-gen-introspect</primary>
207 </indexterm>
208 </listitem>
209 </varlistentry>
210
211 <varlistentry id="vapicheck">
212 <term><command>vapicheck</command></term>
213 <listitem>
214 <para>
215 verifies the generated bindings.
216 </para>
217 <indexterm zone="vala vapicheck">
218 <primary sortas="b-vapicheck">vapicheck</primary>
219 </indexterm>
220 </listitem>
221 </varlistentry>
222
223 <varlistentry id="vapigen">
224 <term><command>vapigen</command></term>
225 <listitem>
226 <para>
227 is an utility which generates <application>Vala</application> API
228 (VAPI) files from GI files.
229 </para>
230 <indexterm zone="vala vapigen">
231 <primary sortas="b-vapigen">vapigen</primary>
232 </indexterm>
233 </listitem>
234 </varlistentry>
235
236 <varlistentry id="libvala">
237 <term><filename class="libraryfile">libvala-&vala-major-version;.so</filename></term>
238 <listitem>
239 <para>
240 contains the <application>Vala</application> API functions.
241 </para>
242 <indexterm zone="vala libvala">
243 <primary sortas="c-libvala">libvala-&vala-major-version;.so</primary>
244 </indexterm>
245 </listitem>
246 </varlistentry>
247
248 </variablelist>
249
250 </sect2>
251
252</sect1>
Note: See TracBrowser for help on using the repository browser.