plasma/plasma-nm/README.md

0001 Plasma-nm
0002 ========================
0003
0004 Plasma applet written in QML for managing network connections
0005
0006 Dependencies:
0007 -------------
0008   * networkmanager-qt
0009   * modemmanager-qt
0010   * NetworkManager 0.9.10 and newer
0011
0012 Optional dependencies:
0013 ---------------------
0014   * openconnect
0015     - if you want to build the OpenConnect VPN plugin
0016
0017   * NetworkManager-fortisslvpn|iodine|l2tp|libreswan|openconnect|openvpn|pptp|ssh|sstp|strongswan|vpnc
0018     - these are runtime dependencies for VPN plugins
0019
0020 Compiling:
0021 ----------
0022 **Recommended method**
0023 The best way to develop for KDE is to use [kdesrc-build](https://kdesrc-build.kde.org/), a KDE supported tool chain to manage installation and compilation of KDE applications and dependencies. Please refer to the following guide when developing, building, and testing `plasma-nm`:
0024
0025 https://community.kde.org/Get_Involved/development#Iterating_on_a_single_project
0026
0027 **Expert method (quick and dirty)**
0028 :warning: **The following method is for experienced developers. developers should use the above mentioned recommmended method when developing for KDE. This expert method will install files on your system that may not align with your specific OS best practices and may cause issues.** :warning:
0029
0030 ```sh
0031   mkdir build
0032   cd build
0033   cmake ../ -DCMAKE_INSTALL_PREFIX=/usr [-DDISABLE_MODEMMANAGER_SUPPORT=true]
0034   make
0035   # As root:
0036   make install
0037 ```
0038
0039 BUGS:
0040 -----
0041 Submit bugs and feature requests to KDE bugzilla, product plasma-nm:
0042
0043 https://bugs.kde.org/describecomponents.cgi?product=plasma-nm
0044
0045
0046 NetworkManager specification:
0047 ------------------------------
0048 https://developer.gnome.org/NetworkManager/stable/
0049 https://developer.gnome.org/NetworkManager/stable/ref-settings.html
0050 https://www.freedesktop.org/software/ModemManager/api/latest/