source: gnome/applications/network-manager-applet.xml@ f13e902

10.0 10.1 11.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f13e902 was f13e902, checked in by Xi Ruoyao <xry111@…>, 22 months ago

n-m-a: dep on polkit-agent instead of polkit-gnome

Other agents work as well.

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

  • Property mode set to 100644
File size: 8.2 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.8/network-manager-applet-&network-manager-applet-version;.tar.xz">
9 <!ENTITY network-manager-applet-download-ftp
10 "&gnome-download-ftp;/network-manager-applet/1.8/network-manager-applet-&network-manager-applet-version;.tar.xz">
11 <!ENTITY network-manager-applet-md5sum "5c1bf351fde5adc12200345550516050">
12 <!ENTITY network-manager-applet-size "1.9 MB">
13 <!ENTITY network-manager-applet-buildsize "65 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 &lfs90_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="gcr"/>,
83 <xref linkend="gtk3"/>,
84 <xref linkend="iso-codes"/>,
85 <xref linkend="libsecret"/>,
86 <xref linkend="libnotify"/>, and
87 <xref linkend="NetworkManager"/>
88 </para>
89
90 <bridgehead renderas="sect4">Recommended</bridgehead>
91 <para role="recommended">
92 <xref linkend="gobject-introspection"/> and
93 <xref linkend="ModemManager"/>
94 </para>
95
96 <bridgehead renderas="sect4">Required (Runtime)</bridgehead>
97 <para role="required">
98 Since this package uses
99 <xref role="nodep" linkend="polkit"/> for authorization,
100 one <xref role="runtime" linkend="polkit-agent"/> should be
101 running when the functionality of this package is used.
102 </para>
103
104 <bridgehead renderas="sect4">Optional</bridgehead>
105 <para role="optional">
106 <xref linkend="gnome-bluetooth"/>,
107 <xref linkend="gtk-doc"/>,
108 <xref linkend="jansson"/>,
109 <ulink url="https://launchpad.net/libappindicator">libindicator</ulink>,
110 and <ulink url="&gnome-download-http;/mobile-broadband-provider-info">
111 mobile-broadband-provider-info</ulink> (runtime)
112 </para>
113
114 <para condition="html" role="usernotes">User Notes:
115 <ulink url="&blfs-wiki;/network-manager-applet"/>
116 </para>
117
118 </sect2>
119
120 <sect2 role="installation">
121 <title>Installation of NetworkManager Applet</title>
122
123 <para>
124 Install <application>NetworkManager Applet</application> by running
125 the following commands:
126 </para>
127
128<screen><userinput>mkdir build &amp;&amp;
129cd build &amp;&amp;
130
131meson --prefix=/usr \
132 --sysconfdir=/etc \
133 -Dselinux=false \
134 -Dteam=false \
135 -Dmobile_broadband_provider_info=false \
136 -Dgtk_doc=false .. &amp;&amp;
137ninja</userinput></screen>
138
139 <para>
140 To test the results, issue: <command>ninja test</command>.
141 </para>
142
143 <para>
144 Now, as the <systemitem class="username">root</systemitem> user:
145 </para>
146
147<screen role="root"><userinput>ninja install</userinput></screen>
148
149 </sect2>
150
151 <sect2 role="commands">
152 <title>Command Explanations</title>
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 <para>
166 <parameter>-Dmobile_broadband_provider_info=false</parameter>: This
167 switch forcibly disables Mobile Broadband Provider support because it
168 is not currently available in BLFS.
169 </para>
170 <para>
171 <parameter>-Dgtk_doc=false</parameter>: Remove this if you have
172 <xref linkend="gtk-doc"/> installed and want to rebuild the
173 documentation with it.
174 </para>
175
176 <para>
177 <option>-Dwwan=false</option>: This switch disables WWAN support.
178 Use this if you do not have <xref linkend="ModemManager"/> installed.
179 </para>
180 <para>
181 <option>-Dintrospection=false</option>: Use this if you do not have <xref linkend="gobject-introspection"/> installed.
182 </para>
183
184 </sect2>
185
186 <sect2 role="content">
187 <title>Contents</title>
188
189 <segmentedlist>
190 <segtitle>Installed Programs</segtitle>
191 <segtitle>Installed Libraries</segtitle>
192 <segtitle>Installed Directories</segtitle>
193
194 <seglistitem>
195 <seg>
196 nm-applet and nm-connection-editor
197 </seg>
198 <seg>
199 libnma.so <!-- and libnm-gtk.so -->
200 </seg>
201 <seg>
202 <!--/usr/include/{libnma,libnm-gtk},-->
203 /usr/include/libnma and /usr/share/gtk-doc/libnma
204 </seg>
205 </seglistitem>
206 </segmentedlist>
207
208 <variablelist>
209 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
210 <?dbfo list-presentation="list"?>
211 <?dbhtml list-presentation="table"?>
212
213 <varlistentry id="nm-connection-editor">
214 <term><command>nm-connection-editor</command></term>
215 <listitem>
216 <para>
217 allows users to view and edit network connection settings.
218 </para>
219 <indexterm zone="network-manager-applet nm-connection-editor">
220 <primary sortas="b-nm-connection-editor">nm-connection-editor</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="libnma">
226 <term><filename class="libraryfile">libnma.so</filename></term>
227 <listitem>
228 <para>
229 contains internal functions for the
230 <application>Network Manager GTK+ Interface</application>.
231 </para>
232 <indexterm zone="network-manager-applet libnma">
233 <primary sortas="c-libnma">libnma.so</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237<!--
238 <varlistentry id="libnm-gtk">
239 <term><filename class="libraryfile">libnm-gtk.so</filename></term>
240 <listitem>
241 <para>
242 contains the <application>NetworkManager</application>
243 <application>GTK+</application> bindings.
244 </para>
245 <indexterm zone="network-manager-applet libnm-gtk">
246 <primary sortas="c-libnm-gtk">libnm-gtk.so</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250-->
251
252 </variablelist>
253
254 </sect2>
255
256</sect1>
Note: See TracBrowser for help on using the repository browser.