X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=README.md;h=1e45b22f5e51a9fe44d066077c57c45ed5b12fcd;hb=aba8d109d4ef59ccf3f42b4a120582b11693fc19;hp=f6a5bdb144c8519234ab133c19344dc817c524ab;hpb=3401494b339a79478d656f1ddcbe2bc963339ae6;p=deb_pkgs%2Fautorandr.git

diff --git a/README.md b/README.md
index f6a5bdb..1e45b22 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,63 @@
-# Tool: autorandr
-
+# autorandr 
 Automatically select a display configuration based on connected devices
 
-### Stefan Tomanek <[stefan.tomanek@wertarbyte.de](stefan.tomanek@wertarbyte.de)>
+## Branch information
+
+This is a compatible Python rewrite of
+[wertarbyte/autorandr](https://github.com/wertarbyte/autorandr).
+
+The original [wertarbyte/autorandr](https://github.com/wertarbyte/autorandr)
+tree is unmaintained, with lots of open pull requests and issues. I forked it
+and merged what I thought were the most important changes. If you are searching
+for that version, see the [`legacy` branch](https://github.com/phillipberndt/autorandr/tree/legacy).
+Note that the Python version is better suited for non-standard configurations,
+like if you use `--transform` or `--reflect`. If you use `auto-disper`, you
+have to use the bash version, as there is no disper support in the Python
+version (yet). Both versions use a compatible configuration file format, so
+you can, to some extent, switch between them.  I will maintain the `legacy`
+branch until @wertarbyte finds the time to maintain his branch again.
+
+If you are interested in why there are two versions around, see
+[#7](https://github.com/phillipberndt/autorandr/issues/7),
+[#8](https://github.com/phillipberndt/autorandr/issues/8) and
+especially
+[#12](https://github.com/phillipberndt/autorandr/issues/12)
+if you are unhappy with this version and would like to contibute to the bash
+version.
+
+## License information and authors
+
+autorandr is available under the terms of the GNU General Public License
+(version 3).
 
-# How to use:
+Contributors to this version of autorandr are:
+
+* Alexander Wirt
+* Chris Dunder
+* Daniel Hahler
+* Maciej Sitarz
+* Matthew R Johnson
+* Phillip Berndt
+* Rasmus Wriedt Larsen
+* Stefan Tomanek
+* Timo Bingmann
+* Tomasz Bogdal
+* Victor Häggqvist
+* stormc
+* tachylatus
+* andersonjacob
+
+## How to use
 
 Save your current display configuration and setup with:
-```autorandr --save mobile```
+```
+autorandr --save mobile
+```
 
 Connect an additional display, configure your setup and save it:
-```autorandr --save docked```
+```
+autorandr --save docked
+```
 
 Now autorandr can detect which hardware setup is active:
 ```
@@ -36,12 +83,14 @@ To change this behaviour and switch to a fallback configuration, specify
 `--default <profile>`.
 
 Another script called `postswitch` can be placed in the directory
-`~/.autorandr` as well as in all profile directories: The scripts are executed
+`~/.config/autorandr` (or `~/.autorandr` if you have an old installation) as well as in all profile directories: The scripts are executed
 after a mode switch has taken place and can notify window managers or other
 applications about it.
 
+All scripts can also be placed in any of the `$XDG_CONFIG_DIRS`. In addition to
+the script names themselves, any executables in subdirectories named
+`script_name.d` (e.g. `postswitch.d`) are executed as well. In scripts, some of
+autorandr's state is exposed as environment variables prefixed with `AUTORANDR_`.
+The most useful one is `$AUTORANDR_CURRENT_PROFILE`.
 
-While the script uses xrandr by default, calling it by the name __autodisper__
-or "auto-disper" forces it to use the "disper" utility, which is useful for
-controlling nvidia chipsets. The formats for fingerprinting the current setup
-and saving/loading the current configuration are adjusted accordingly.
+To install autorandr call `make install`.