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

12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since e1e58be was 7b48540, checked in by Douglas R. Reno <renodr@…>, 8 months ago

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