source: networking/netutils/network-manager-applet.xml@ 19613b0

10.0 10.1 11.0 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 19613b0 was 19613b0, checked in by Xi Ruoyao <xry111@…>, 16 months ago

meson: remove useless options, for untagged packages

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

  • Property mode set to 100644
File size: 8.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 network-manager-applet-download-http
8 "&gnome-download-http;/network-manager-applet/1.18/network-manager-applet-&network-manager-applet-version;.tar.xz">
9 <!ENTITY network-manager-applet-download-ftp
10 "&gnome-download-ftp;/network-manager-applet/1.18/network-manager-applet-&network-manager-applet-version;.tar.xz">
11 <!ENTITY network-manager-applet-md5sum "1db711d29207f750985511eb8ca0a706">
12 <!ENTITY network-manager-applet-size "1.9 MB">
13 <!ENTITY network-manager-applet-buildsize "53 MB (with tests)">
14 <!ENTITY network-manager-applet-time "0.3 SBU (with tests)">
15]>
16
17<sect1 id="network-manager-applet" xreflabel="network-manager-applet-&network-manager-applet-version;">
18 <?dbhtml filename="network-manager-applet.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>network-manager-applet-&network-manager-applet-version;</title>
26
27 <indexterm zone="network-manager-applet">
28 <primary sortas="a-network-manager-applet">network-manager-applet</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to NetworkManager Applet</title>
33
34 <para>
35 The <application>NetworkManager Applet</application> provides a tool and
36 a panel applet used to configure wired and wireless network connections
37 through GUI. It's designed for use with any desktop environment that uses
38 <application>GTK+</application>, such as <application>Xfce</application>
39 and <application>LXDE</application>.
40 </para>
41
42 &lfs91_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>
48 Download (HTTP): <ulink url="&network-manager-applet-download-http;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download (FTP): <ulink url="&network-manager-applet-download-ftp;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download MD5 sum: &network-manager-applet-md5sum;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download size: &network-manager-applet-size;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated disk space required: &network-manager-applet-buildsize;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated build time: &network-manager-applet-time;
74 </para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">NetworkManager Applet Dependencies</bridgehead>
79
80 <bridgehead renderas="sect4">Required</bridgehead>
81 <para role="required">
82 <xref linkend="gtk3"/>,
83 <xref linkend="libnma"/>,
84 <xref linkend="libnotify"/>, and
85 <xref linkend="libsecret"/>
86 </para>
87
88 <bridgehead renderas="sect4">Recommended</bridgehead>
89 <para role="recommended">
90 <xref linkend="gobject-introspection"/> and
91 <xref linkend="ModemManager"/>
92 </para>
93
94 <bridgehead renderas="sect4">Required (Runtime)</bridgehead>
95 <para role="required">
96 Since this package uses
97 <xref role="nodep" linkend="polkit"/> for authorization,
98 one <xref role="runtime" linkend="polkit-agent"/> should be
99 running when the functionality of this package is used.
100 </para>
101
102 <bridgehead renderas="sect4">Optional</bridgehead>
103 <para role="optional">
104 <xref linkend="gnome-bluetooth"/>,
105 <xref linkend="jansson"/>, and
106 <ulink url="https://launchpad.net/libappindicator">libindicator</ulink>
107 </para>
108
109 <para condition="html" role="usernotes">User Notes:
110 <ulink url="&blfs-wiki;/network-manager-applet"/>
111 </para>
112
113 </sect2>
114
115 <sect2 role="installation">
116 <title>Installation of NetworkManager Applet</title>
117
118 <para>
119 Install <application>NetworkManager Applet</application> by running
120 the following commands:
121 </para>
122
123<screen><userinput>mkdir build &amp;&amp;
124cd build &amp;&amp;
125
126meson --prefix=/usr \
127 -Dappindicator=no \
128 -Dselinux=false \
129 -Dteam=false .. &amp;&amp;
130ninja</userinput></screen>
131
132 <para>
133 To test the results, issue: <command>ninja test</command>.
134 </para>
135
136 <para>
137 Now, as the <systemitem class="username">root</systemitem> user:
138 </para>
139
140<screen role="root"><userinput>ninja install</userinput></screen>
141
142 </sect2>
143
144 <sect2 role="commands">
145 <title>Command Explanations</title>
146
147 <para>
148 <parameter>-Dappindicator=no</parameter>: This switch disables
149 AppIndicator support in network-manager-applet because it
150 requires libindicator, which is not in BLFS. The build will fail
151 without this option.
152 </para>
153
154 <para>
155 <parameter>-Dteam=false</parameter>: This switch disables the team
156 configuration editor since it requires <xref linkend="jansson"/>. If
157 you have Jansson installed, remove this option or set it to "true".
158 </para>
159
160 <para>
161 <parameter>-Dselinux=false</parameter>: This switch forcibly
162 disables <application>SELinux</application> support since it is not
163 currently in BLFS and the build will fail without it.
164 </para>
165
166 <!-- no longer needed as of 1.16.0
167 <para>
168 <parameter>-Dmobile_broadband_provider_info=false</parameter>: This
169 switch forcibly disables Mobile Broadband Provider support because it
170 is not currently available in BLFS.
171 </para>
172 <para>
173 <parameter>-Dgtk_doc=false</parameter>: Remove this if you have
174 <xref linkend="gtk-doc"/> installed and want to rebuild the
175 documentation with it.
176 </para>
177 -->
178
179 <para>
180 <option>-Dwwan=false</option>: This switch disables WWAN support.
181 Use this if you do not have <xref linkend="ModemManager"/> installed.
182 </para>
183
184 <!-- Same as above
185 <para>
186 <option>-Dintrospection=false</option>: Use this if you do not have <xref linkend="gobject-introspection"/> installed.
187 </para>
188 -->
189
190 </sect2>
191
192 <sect2 role="content">
193 <title>Contents</title>
194
195 <segmentedlist>
196 <segtitle>Installed Programs</segtitle>
197 <segtitle>Installed Libraries</segtitle>
198 <segtitle>Installed Directories</segtitle>
199
200 <seglistitem>
201 <seg>
202 nm-applet and nm-connection-editor
203 </seg>
204 <seg>
205 <!--libnma.so-->
206 None
207 </seg>
208 <seg>
209 <!--/usr/include/{libnma,libnm-gtk},-->
210 <!--/usr/include/libnma and /usr/share/gtk-doc/libnma-->
211 None
212 </seg>
213 </seglistitem>
214 </segmentedlist>
215
216 <variablelist>
217 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
218 <?dbfo list-presentation="list"?>
219 <?dbhtml list-presentation="table"?>
220
221 <varlistentry id="nm-connection-editor">
222 <term><command>nm-connection-editor</command></term>
223 <listitem>
224 <para>
225 allows users to view and edit network connection settings.
226 </para>
227 <indexterm zone="network-manager-applet nm-connection-editor">
228 <primary sortas="b-nm-connection-editor">nm-connection-editor</primary>
229 </indexterm>
230 </listitem>
231 </varlistentry>
232
233 <!--
234 <varlistentry id="libnma">
235 <term><filename class="libraryfile">libnma.so</filename></term>
236 <listitem>
237 <para>
238 contains internal functions for the
239 <application>Network Manager GTK+ Interface</application>.
240 </para>
241 <indexterm zone="network-manager-applet libnma">
242 <primary sortas="c-libnma">libnma.so</primary>
243 </indexterm>
244 </listitem>
245 </varlistentry>
246Moved to a separate library, libnma, in 1.16.0
247-->
248<!--
249 <varlistentry id="libnm-gtk">
250 <term><filename class="libraryfile">libnm-gtk.so</filename></term>
251 <listitem>
252 <para>
253 contains the <application>NetworkManager</application>
254 <application>GTK+</application> bindings.
255 </para>
256 <indexterm zone="network-manager-applet libnm-gtk">
257 <primary sortas="c-libnm-gtk">libnm-gtk.so</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261-->
262
263 </variablelist>
264
265 </sect2>
266
267</sect1>
Note: See TracBrowser for help on using the repository browser.