source: networking/netlibs/libsoup.xml@ bd57f160

10.0 10.1 11.0 9.0 9.1 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since bd57f160 was bd57f160, checked in by Douglas R. Reno <renodr@…>, 3 years ago

Update to libsoup-2.66.1
Update to gvfs-1.40.1
Update to vte-0.56.1
Update to gnome-desktop-3.32.1

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

  • Property mode set to 100644
File size: 6.3 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 libsoup-download-http
8 "&gnome-download-http;/libsoup/2.66/libsoup-&libsoup-version;.tar.xz">
9 <!ENTITY libsoup-download-ftp
10 "&gnome-download-ftp;/libsoup/2.66/libsoup-&libsoup-version;.tar.xz">
11 <!ENTITY libsoup-md5sum "5f04c09a06f6dbe4c4d3f003992145ce">
12 <!ENTITY libsoup-size "1.4 MB">
13 <!ENTITY libsoup-buildsize "22 MB (with tests)">
14 <!ENTITY libsoup-time "0.4 SBU (with tests)">
15]>
16
17<sect1 id="libsoup" xreflabel="libsoup-&libsoup-version;">
18 <?dbhtml filename="libsoup.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>libsoup-&libsoup-version;</title>
26
27 <indexterm zone="libsoup">
28 <primary sortas="a-libsoup">libsoup</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to libsoup</title>
33
34 <para>
35 The <application>libsoup</application> is a HTTP client/server library for
36 <application>GNOME</application>. It uses GObject and the GLib main loop
37 to integrate with <application>GNOME</application> applications and
38 it also has an asynchronous API for use in threaded applications.
39 </para>
40
41 &lfs84_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&libsoup-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&libsoup-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &libsoup-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &libsoup-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &libsoup-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &libsoup-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">libsoup Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Required</bridgehead>
80 <para role="required">
81 <xref linkend="glib-networking"/>,
82 <xref linkend="libpsl"/>,
83 <xref linkend="libxml2"/> and
84 <xref linkend="sqlite"/>
85 </para>
86
87 <bridgehead renderas="sect4">Recommended</bridgehead>
88 <para role="recommended">
89 <xref linkend="gobject-introspection"/> and
90 <xref linkend="vala"/>
91 </para>
92
93 <bridgehead renderas="sect4">Optional</bridgehead>
94 <para role="optional">
95 <xref linkend="apache"/> (required to run the test suite),
96 <xref linkend="curl"/> (required to run the test suite),
97 <xref linkend="mitkrb"/> (required to run the test suite),
98 <xref linkend="gtk-doc"/>,
99 <xref linkend="php"/> compiled with XMLRPC-EPI <!-- It seems that XMLRPC is part of PHP 5.4.10 -->
100 support (only used for the XMLRPC regression tests) and
101 <xref linkend="samba"/> (ntlm_auth is required to run the test suite).
102 </para>
103
104 <para condition="html" role="usernotes">
105 User Notes: <ulink url="&blfs-wiki;/libsoup"/>
106 </para>
107 </sect2>
108
109 <sect2 role="installation">
110 <title>Installation of libsoup</title>
111
112 <para>
113 Install <application>libsoup</application> by running the following
114 commands:
115 </para>
116
117<screen><userinput>mkdir build &amp;&amp;
118cd build &amp;&amp;
119
120meson --prefix=/usr -Dvapi=true -Dgssapi=false .. &amp;&amp;
121ninja</userinput></screen>
122
123 <para>
124 To test the results, issue: <command>ninja test</command>.
125 </para>
126
127 <para>
128 Now, as the <systemitem class="username">root</systemitem> user:
129 </para>
130
131<screen role="root"><userinput>ninja install</userinput></screen>
132
133 </sect2>
134
135 <sect2 role="commands">
136 <title>Command Explanations</title>
137
138 <para>
139 <option>-Dvapi=false</option>: use this if you have not installed
140 <application>Vala</application>, e.g. because you are not building
141 <application>GNOME</application>.
142 </para>
143
144 <para>
145 <option>-Ddoc=true</option>: Use this option if you want to build
146 the documentation. Note that you must have <xref linkend="gtk-doc"/> installed.
147 </para>
148
149 <para>
150 <option>-Dgssapi=false</option>: libsoup defaults to building with GSSAPI support,
151 which requires Kerberos (as does the test suite). If you are building GNOME or
152 have kerberos installed, remove this option.
153 </para>
154
155 </sect2>
156
157 <sect2 role="content">
158 <title>Contents</title>
159
160 <segmentedlist>
161 <segtitle>Installed Programs</segtitle>
162 <segtitle>Installed Libraries</segtitle>
163 <segtitle>Installed Directories</segtitle>
164
165 <seglistitem>
166 <seg>
167 None
168 </seg>
169 <seg>
170 libsoup-2.4.so and libsoup-gnome-2.4.so
171 </seg>
172 <seg>
173 /usr/include/libsoup-2.4,
174 /usr/include/libsoup-gnome-2.4 and
175 /usr/share/gtk-doc/html/libsoup-2.4 <!-- only installed if -Ddoc=true is
176 passed. -->
177 </seg>
178 </seglistitem>
179 </segmentedlist>
180
181 <variablelist>
182 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
183 <?dbfo list-presentation="list"?>
184 <?dbhtml list-presentation="table"?>
185
186 <varlistentry id="libsoup-2">
187 <term><filename class="libraryfile">libsoup-2.4.so</filename></term>
188 <listitem>
189 <para>
190 provides functions for asynchronous HTTP connections.
191 </para>
192 <indexterm zone="libsoup libsoup-2">
193 <primary sortas="c-libsoup-2">libsoup-2.4.so</primary>
194 </indexterm>
195 </listitem>
196 </varlistentry>
197
198 <varlistentry id="libsoup-gnome-2">
199 <term><filename class="libraryfile">libsoup-gnome-2.4.so</filename></term>
200 <listitem>
201 <para>
202 provides <application>GNOME</application> specific features.
203 </para>
204 <indexterm zone="libsoup libsoup-gnome-2">
205 <primary sortas="c-libsoup-gnome-2">libsoup-gnome-2.4.so</primary>
206 </indexterm>
207 </listitem>
208 </varlistentry>
209
210 </variablelist>
211
212 </sect2>
213
214</sect1>
Note: See TracBrowser for help on using the repository browser.