aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLucas C. Villa Real <lucasvr@gmail.com>2017-01-01 19:19:42 -0200
committerLucas C. Villa Real <lucasvr@gmail.com>2017-01-01 19:19:42 -0200
commita58c78b9ebe743b0add0d2ed2fd1900a827e54c1 (patch)
treeee47c2c80dd1b8a0d8e9ebd73a50e6c901ea6962
parent923b826989315fb0d0b292d72524bc3a442dd4dc (diff)
parent60d2ffbab0cf3a86ee8f2d89db6a5d822a5b1a95 (diff)
downloadThirdPartyInstallers-a58c78b9ebe743b0add0d2ed2fd1900a827e54c1.tar.xz
Merge branch 'master' of github.com:gobolinux/ThirdPartyInstallers
-rw-r--r--README.md22
1 files changed, 22 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b2fbc3c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+# ThirdPartyInstallers
+
+This is a collection of utilities to handle the installation of packages in non-native formats such as RPM and DEB.
+
+Packages are unpacked under `/Programs`. The contents of `/opt`, when present, are flattened under the new program entry
+and compatibility symlinks are created at /opt pointing back to the new entry at `/Programs`.
+
+# Caveats
+
+Note that running packages built for other distributions is a best-effort task. There are many features that won't
+work out of the box and that are outside the scope of `ThirdPartyInstallers`. For instance, init scripts, tasks files,
+and reliance on other distro-specific components may preclude the installed package from working as expected.
+
+# Usage
+
+Installing a single RPM file:
+
+`$ InstallPackage-RPM libfoo-2.1-3.x86_64.rpm`
+
+Merging multiple RPMs under a single entry at `/Programs`:
+
+`$ InstallPackage-RPM --app-name "LibreOffice" --version-number 5.2.3.3 *.rpm`