X-Git-Url: http://repo.macrolet.net/gitweb/?a=blobdiff_plain;f=README.md;h=ec895e0fc5a182d73dbcc89e32c3921f617558fb;hb=HEAD;hp=50a36c8c3ebfc3f64a0e5f3d68879afed97f9cf0;hpb=2af219c661ec227fdf5dc28ddeb1110e29e60d2e;p=crypto-install.git

diff --git a/README.md b/README.md
index 50a36c8..ec895e0 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,9 @@
-crypto-install.py
+crypto-install - Baseline setup for GnuPG and OpenSSH
+
+# LICENSE
+
+This program is released under GNU General Public License v3 or any
+later version.
 
 # USAGE
 
@@ -14,11 +19,17 @@ it is always safe to do.
 - `--no-gpg` disables the GnuPG key generation and related setup
   routines
 - `--no-ssh` does the same for the OpenSSH setup
-- `--gpg-home` sets the directory for the GnuPG files
-- `--ssh-home` does the same for OpenSSH files
+- `--gpg-home` sets the directory for the GnuPG files (defaults to the
+  value of `GNUPGHOME` or `~/.gnupg`)
+- `--ssh-home` does the same for OpenSSH files (defaults to `~/.ssh`)
 
 There is also `-h/--help` and `-v/--version` as expected.
 
+# ENVIRONMENT
+
+- `FULLNAME`, `EMAIL`, `USER` are used to pre-fill the corresponding
+  fields
+
 # INSTALLATION
 
 Until I set up a better routine:
@@ -28,11 +39,10 @@ Until I set up a better routine:
     git clone git@github.com:Ferada/crypto-install.git
 
     cd crypto-install
-    make
-    cp build/crypto-install.py ~/bin # or wherever
+    python setup.py install
 
-Simply copy the built file into your path and possibly ensure execution
-permissions.
+Using `--prefix` with `install` the path may be changed to just locally
+install it for e.g. the current user.
 
 # DEVELOPMENT
 
@@ -47,3 +57,36 @@ installed, then the two hooks in `git_hooks` will run the tests and
 check for PEP8 compatibility before committing as well.  Run
 `git hooks --install` in the checked out folder to register the hooks
 initially.
+
+# LOCALISATION
+
+Currently working simultaneously on the English and German version.
+Patches welcome.
+
+To run with a different language set, use:
+
+    TEXTDOMAINDIR=locale LANGUAGE=de_DE ./crypto-install
+
+(I would really like to if that environment variable is okay to use
+here!)
+
+**TODO**: If the application is installed, you should only have to set
+the `LANGUAGE` environment variable instead, as the default locale
+directory will be set during the installation (to
+`prefix/share/locale` probably).
+
+To start off with a new translation, use:
+
+    cd po
+    msginit -l en_US # or whatever language code
+
+You'll have to confirm, or edit the email address and author.
+Afterwards, edit the new `.po` file as usual.
+
+Please read the `gettext` documentation (`info gettext`) for more
+details.
+
+# TODO
+
+- Tweak default parameters; it should also be possible to tweak them,
+  e.g. via a `--paranoid` setting.