aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md32
1 files changed, 32 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..297eafb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,32 @@
+# pakku
+
+Pakku is a pacman wrapper with additional features, such as AUR support.
+
+## Description
+
+There are dozens of AUR helpers, but all of them have a fatal flaw:
+I didn't write them! So I made another useless AUR helper.
+Say hello to stillborn AUR helper written in stillborn programming language!
+
+Basically, pakku supports the following features:
+
+- Installing packages from AUR
+- Building packages from official repositories
+- Searching and querying AUR packages
+- Reading comments for AUR packages
+- Pacman integration
+
+In other words, it does the same things any AUR helper capable of.
+
+The following principles were the basis of the program:
+
+- Pacman-like user interface
+- Pacman options support (`--asdeps`, `--needed`, etc)
+- Pacman configuration support (output settings, ignored packages, etc)
+- Download, ask all questions, and only after that start building
+- No PKGBUILD sourcing
+
+## Examples
+
+- Build packages from sources: `pakku -S --build linux linux-headers`
+- Query all "dependency islands": `pakku -Qdttt`