From 3401494b339a79478d656f1ddcbe2bc963339ae6 Mon Sep 17 00:00:00 2001 From: mtahmed Date: Sun, 12 May 2013 08:29:18 -0400 Subject: [PATCH 1/2] Rename README -> README.md. Use markdown for README.md. --- README => README.md | 29 +++++++++++++++-------------- 1 file changed, 15 insertions(+), 14 deletions(-) rename README => README.md (64%) diff --git a/README b/README.md similarity index 64% rename from README rename to README.md index 9b54600..f6a5bdb 100644 --- a/README +++ b/README.md @@ -1,46 +1,47 @@ -Tool: "autorandr" +# Tool: autorandr Automatically select a display configuration based on connected devices -Stefan Tomanek +### Stefan Tomanek <[stefan.tomanek@wertarbyte.de](stefan.tomanek@wertarbyte.de)> -How to use: +# 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: +``` $ autorandr mobile docked (detected) +``` -To automatically reload your setup, just append --change to the command line +To automatically reload your setup, just append `--change` to the command line -To manually load a profile, you can use the --load option. +To manually load a profile, you can use the `--load ` option. autorandr tries to avoid reloading an identical configuration. To force the -(re)configuration, apply --force. +(re)configuration, apply `--force`. -To prevent a profile from being loaded, place a script call "block" in its +To prevent a profile from being loaded, place a script call _block_ in its directory. The script is evaluated before the screen setup is inspected, and in case of it returning a value of 0 the profile is skipped. This can be used to query the status of a docking station you are about to leave. If no suitable profile can be identified, the current configuration is kept. To change this behaviour and switch to a fallback configuration, specify ---default +`--default `. -Another script called "postswitch "can be placed in the directory -~/.autorandr as well as in all profile directories: The scripts are executed +Another script called `postswitch` can be placed in the directory +`~/.autorandr` 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. -While the script uses xrandr by default, calling it by the name "autodisper" +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. - From 71eab77f43c7015d5d1db5dffc576f310c86e2fe Mon Sep 17 00:00:00 2001 From: mtahmed Date: Sun, 12 May 2013 08:33:46 -0400 Subject: [PATCH 2/2] Make the README.md a bit cleaner. --- README.md | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index f6a5bdb..d09b386 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,20 @@ -# Tool: autorandr +# autorandr Automatically select a display configuration based on connected devices -### Stefan Tomanek <[stefan.tomanek@wertarbyte.de](stefan.tomanek@wertarbyte.de)> +Stefan Tomanek <[stefan.tomanek@wertarbyte.de](stefan.tomanek@wertarbyte.de)> -# How to use: +## 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: ``` @@ -41,7 +45,8 @@ after a mode switch has taken place and can notify window managers or other applications about it. -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. +While the script uses xrandr by default, calling it by the name `autodisper` +or `auto-disper` forces it to use the [disper](http://willem.engen.nl/projects/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.