summaryrefslogtreecommitdiffstats
path: root/punani/README.md
diff options
context:
space:
mode:
authorEUcancER <root@euer.krebsco.de>2011-11-17 11:19:21 +0100
committerEUcancER <root@euer.krebsco.de>2011-11-17 11:19:21 +0100
commitd5c9e86506c4a62d75f958a1c82e943b1b33ad81 (patch)
treed7f890e09750f993aefe84260bb3d6d32a6de348 /punani/README.md
parent3877e5d8221d42811d376ddb560552684d34f5cc (diff)
//punani: add README describing the current functionality
Diffstat (limited to 'punani/README.md')
-rw-r--r--punani/README.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/punani/README.md b/punani/README.md
new file mode 100644
index 00000000..1b70eab7
--- /dev/null
+++ b/punani/README.md
@@ -0,0 +1,30 @@
+Overview
+=======
+Punani is a meta packagemanager comprising a server which resolves package
+requests and a client containing the logic to find the best suitable packer
+on the host system. Packagenames in Punani are binaries in the PATH. All
+library packages are named in the Principle of Least Surprise[1]. Different
+package names can resolve into the same package.
+
+If you want to install the `hostname` tool, the query is
+ punani install hostname
+on an archlinux this will result in the call :
+ pacman --noconfirm -Sy --needed inetutils
+
+[1] http://de.wikipedia.org/wiki/Principle_of_Least_Surprise
+
+Punani Client
+============
+The punani client will determine which packer are available on the system
+and then send a request to the punani server to find out how the given
+package is called with the given packer. In addition to that, the client
+will add flags to the packers call in order to install packages only when
+needed and disable user interaction.
+
+Punani Server
+============
+
+The punani server is a web-service which resolves request in the following
+manner:
+ localhost/$packer/$package
+The result is the package-name with the given packer or 404 if not found.