source: networking/netlibs/neon.xml@ fdb76cd

11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since fdb76cd was fdb76cd, checked in by Thomas Trepl (Moody) <thomas@…>, 5 months ago

Do not recreate docs in neon

  • Property mode set to 100644
File size: 5.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 neon-download-http "http://www.webdav.org/neon/neon-&neon-version;.tar.gz"> -->
8 <!ENTITY neon-download-http "https://notroj.github.io/neon/neon-&neon-version;.tar.gz">
9 <!ENTITY neon-download-ftp " ">
10 <!ENTITY neon-md5sum "aa20818503e427ba1f4aa50c084a88c4">
11 <!ENTITY neon-size "860 KB">
12 <!ENTITY neon-buildsize "6.6 MB (additional 20 MB for the tests)">
13 <!ENTITY neon-time "0.1 SBU (additional 0.5 SBU for the tests)">
14]>
15
16<sect1 id="neon" xreflabel="neon-&neon-version;">
17 <?dbhtml filename="neon.html"?>
18
19 <sect1info>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>neon-&neon-version;</title>
24
25 <indexterm zone="neon">
26 <primary sortas="a-neon">neon</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to neon</title>
31
32 <para>
33 <application>neon</application> is an HTTP and WebDAV
34 client library, with a C interface.
35 </para>
36
37 &lfs110a_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&neon-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&neon-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &neon-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &neon-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &neon-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &neon-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">neon Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Optional</bridgehead>
76 <para role="optional">
77 <xref linkend="gnutls"/>,
78 <xref linkend="libxml2"/>,
79 <xref linkend="mitkrb"/>,
80 <ulink url="https://github.com/libproxy/libproxy">libproxy</ulink>, and
81 <ulink url="http://www.manyfish.co.uk/pakchois/">PaKChoiS</ulink>
82 </para>
83
84 <para condition="html" role="usernotes">User Notes:
85 <ulink url="&blfs-wiki;/neon"/>
86 </para>
87 </sect2>
88
89 <sect2 role="installation">
90 <title>Installation of neon</title>
91
92 <para>
93 The build mechanism tries to recreate the documentaion even
94 though its included in the archive. Recreating would require
95 <application>xmlto</application> to be installed. Apply the
96 following sed to not recreate the docs:
97 </para>
98
99<screen><userinput>sed 's/\(install-\(html\|man\):\).*/\1/' -i Makefile.in</userinput></screen>
100
101 <para>
102 Install <application>neon</application> by running the following
103 commands:
104 </para>
105
106<screen><userinput>./configure --prefix=/usr \
107 --with-ssl \
108 --enable-shared \
109 --disable-static &amp;&amp;
110make</userinput></screen>
111
112 <para>
113 To test the results, issue: <command>make check</command>.
114 </para>
115
116 <para>
117 Now, as the <systemitem class="username">root</systemitem> user:
118 </para>
119
120<screen role="root"><userinput>make install</userinput></screen>
121
122 </sect2>
123
124 <sect2 role="commands">
125 <title>Command Explanations</title>
126
127 <para>
128 <parameter>--with-ssl</parameter>: This switch enables SSL support
129 using <application>OpenSSL</application> or
130 <application>GnuTLS</application> respectively. To force
131 <application>GnuTLS</application> usage when it is are present,
132 simply pass <option>--with-ssl=gnutls</option> and
133 <option>--with-ca-bundle=/etc/pki/tls/certs/ca-bundle.crt</option> to the
134 <command>configure</command> script.
135 </para>
136
137 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
138 href="../../xincludes/static-libraries.xml"/>
139
140<!-- We have Expat in LFS now, so this really isn't applicable anymore.
141 <para>
142 <option>- -with-libxml2</option>: This switch forces the use of
143 <application>libxml2</application> instead of
144 <application>Expat</application>.
145 </para>
146-->
147
148 </sect2>
149
150 <sect2 role="content">
151 <title>Contents</title>
152
153 <segmentedlist>
154 <segtitle>Installed Program</segtitle>
155 <segtitle>Installed Library</segtitle>
156 <segtitle>Installed Directories</segtitle>
157
158 <seglistitem>
159 <seg>
160 neon-config
161 </seg>
162 <seg>
163 libneon.so
164 </seg>
165 <seg>
166 /usr/include/neon and
167 /usr/share/doc/neon-&neon-version;
168 </seg>
169 </seglistitem>
170 </segmentedlist>
171
172 <variablelist>
173 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
174 <?dbfo list-presentation="list"?>
175 <?dbhtml list-presentation="table"?>
176
177 <varlistentry id="neon-config">
178 <term><command>neon-config</command></term>
179 <listitem>
180 <para>
181 is a script that provide information about an installed copy
182 of the neon library
183 </para>
184 <indexterm zone="neon neon-config">
185 <primary sortas="b-neon-config">neon-config</primary>
186 </indexterm>
187 </listitem>
188 </varlistentry>
189
190 <varlistentry id="libneon">
191 <term><filename class="libraryfile">libneon.so</filename></term>
192 <listitem>
193 <para>
194 is used as a high-level interface to common HTTP and WebDAV
195 methods
196 </para>
197 <indexterm zone="neon libneon">
198 <primary sortas="c-libneon">libneon.so</primary>
199 </indexterm>
200 </listitem>
201 </varlistentry>
202
203 </variablelist>
204
205 </sect2>
206
207</sect1>
Note: See TracBrowser for help on using the repository browser.