summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMark Sayson <masayson@gmail.com>2017-08-20 12:30:13 -0700
committerArne Schwabe <arne@rfc2549.org>2018-01-26 19:10:25 +0100
commit181d59f8399858cfeb01d0c75bf4c8d1a576d64a (patch)
tree699894b9cff5fa9a461147b6c67670fd87023dd4 /doc
parentad8749e7b8384fb742b31831ca3bf0f6d975c687 (diff)
Updates to spelling/grammar in developer docs
Diffstat (limited to 'doc')
-rw-r--r--doc/README.txt44
1 files changed, 23 insertions, 21 deletions
diff --git a/doc/README.txt b/doc/README.txt
index 4c365913..736e368b 100644
--- a/doc/README.txt
+++ b/doc/README.txt
@@ -1,24 +1,24 @@
ATTENTION
================
-Before doing anything please read the first FAQ point in this file, espicially if
-you planing to build commercial software from this client. Also make sure you
-understand the licenses of the code. OpenVPN for Android is GPL licensed. You
+Before doing anything, please read the first FAQ point in this file, especially if
+you plan to build commercial software from this client. Also make sure you
+understand the licenses of the code. OpenVPN for Android is GPL-licensed. You
_CANNOT_ build a closed sourced custom UI application without acquiring a different
(paid) license for UI code.
The use of the AIDL API to control OpenVPN for Android from an external app is
not subject to the license. The remoteExample project is licensed under the Apache 2.0 license.
-When in doubt mail me about it.
+When in doubt, mail me about it.
-See the file todo.txt for ideas/not yet implemented features (and the bug tracker).
+See the file todo.txt for ideas/not-yet-implemented features (and the bug tracker).
Build instructions:
- Install sdk, ndk, cmake (e.g. with Android studio), swig (3.0+)
Fetch the git submodules (the default urls for the submodules use ssh,
-setup your own github ssh key or change the url to http in .gitmodules):
+set up your own GitHub ssh key or change the url to http in .gitmodules):
git submodule init
git submodule update
@@ -31,6 +31,7 @@ phase to 15 minutes for initial gradle sync are completely normal.
The native build should with Windows and Linux but is rarely tested
since my main development platform is Mac Os X
+
FAQ
Q: Why are you not answering my questions about modifying
@@ -39,13 +40,13 @@ Q: Why are you not answering my questions about modifying
A: There are many people building/wanting to build commercial VPN
clients on top of my of my client. These client often do not even
- honour the license my app or the license of OpenVPN. Even if these
- modified software does honour the license I don't like doing unpaid
- work/giving advise for free to commerical software developers.
-
- If you have a legitimate non commercial open source project I will
- gladly help you but please understand my initial reservations.
+ honour the license of my app or the license of OpenVPN. Even if
+ these modified software do honour the license, I don't like doing
+ unpaid work/giving advice for free to commercial software
+ developers.
+ If you have a legitimate non-commercial open source project, I will
+ gladly help you, but please understand my initial reservations.
Q: How is the OpenVPN version different from normal OpenVPN
@@ -53,15 +54,16 @@ A: OpenVPN for Android uses a OpenVPN master branch + dual stack
client patches. A git repository of the OpenVPN source code and
changes is under: https://github.com/schwabe/openvpn/
-Q: what is minivpn?
+Q: What is minivpn?
-A: minivpn is only a executable thats links against libopenvpn which
- is the normal openvpn build as library. It is done this way so the
- Android Play/Store apk will treat the library as normal library and
- update it on updates of the application. Also the application does
- not need to take care of keeping minivpn up to date because it
- contains no code. For almost all intents and purposes minivpn +
- libopenvpn.so is the same as the normal openvpn binary
+A: minivpn is only a executable that links against libopenvpn, which
+ is the normal openvpn built as a library. It is done this way so
+ the Android Play/Store apk will treat the library as a normal
+ library and update it on updates of the application. Also, the
+ application does not need to take care of keeping minivpn up to
+ date because it contains no code. For almost all intents and
+ purposes minivpn + libopenvpn.so is the same as the normal openvpn
+ binary.
Q: How do I start a VPN by name from an external app?
@@ -84,7 +86,7 @@ or from the shell:
am start -a android.intent.action.MAIN -n de.blinkt.openvpn/.LaunchVPN -e de.blinkt.openvpn.shortcutProfileName Home
-Q: How to control the app from an external app?
+Q: How can I control the app from an external app?
A: There is an AIDL interface. See src/de/blinkt/openvpn/api/IOpenVPNAPIService.aidl. See the normal Android documentation how to use AIDL.
See also the example project under remoteExample.