Misc: Documentation updates
Update README.md and two Asciidoc man pages. Remove the options and examples section in README.md.
This commit is contained in:
Richard Grenville
parent
62ea373ee5
commit
09c10c227c
132
README.md
132
README.md
|
|
@ -72,135 +72,31 @@ $ make install
|
||||||
|
|
||||||
(Compton does include a `_CMakeLists.txt` in the tree, but we haven't decided whether we should switch to CMake yet. The `Makefile` is fully usable right now.)
|
(Compton does include a `_CMakeLists.txt` in the tree, but we haven't decided whether we should switch to CMake yet. The `Makefile` is fully usable right now.)
|
||||||
|
|
||||||
## Example Usage
|
## Known issues
|
||||||
|
|
||||||
``` bash
|
* VSync does not work too well. It's widely reported that tearing still happens on the top of the screen. I do not know how to fix the issue.
|
||||||
$ compton -cC -i 0.6 -e 0.6 -f
|
|
||||||
$ compton --config ~/compton.conf
|
|
||||||
```
|
|
||||||
|
|
||||||
### Options and Configuration
|
* If `--unredir-if-possible` is enabled, when compton redirects/unredirects windows, the screen may flicker. Using `--paint-on-overlay` minimizes the problem from my observation, yet I do not know if there's a cure.
|
||||||
|
|
||||||
```
|
* compton may not track focus correctly in all situations. The focus tracking code is experimental. `--use-ewmh-active-win` might be helpful.
|
||||||
compton [-d display] [-r radius] [-o opacity]
|
|
||||||
[-l left-offset] [-t top-offset]
|
|
||||||
[-i opacity] [-e opacity] [-cCfFSdG]
|
|
||||||
[--config path] [--shadow-red value]
|
|
||||||
[--shadow-green value] [--shadow-blue value]
|
|
||||||
[--inactive-opacity-override] [--inactive-dim value]
|
|
||||||
[--mark-wmwin-focused] [--shadow-exclude condition]
|
|
||||||
[--mark-ovredir-focused] [--no-fading-openclose]
|
|
||||||
[--shadow-ignore-shaped] [--detect-round-corners]
|
|
||||||
```
|
|
||||||
|
|
||||||
* `-d` __display__:
|
* Compton may give ugly shadow to windows with ARGB background if `-z` is enabled, because compton cannot determine their real shapes. One may have to disable shadows on those windows with window-type-specific settings in configuration file or `--shadow-exclude`.
|
||||||
Which display should be managed.
|
|
||||||
* `-r` __radius__:
|
|
||||||
The blur radius for shadows. (default 12)
|
|
||||||
* `-o` __opacity__:
|
|
||||||
The translucency for shadows. (default .75)
|
|
||||||
* `-l` __left-offset__:
|
|
||||||
The left offset for shadows. (default -15)
|
|
||||||
* `-t` __top-offset__:
|
|
||||||
The top offset for shadows. (default -15)
|
|
||||||
* `-I` __fade-in-step__:
|
|
||||||
Opacity change between steps while fading in. (default 0.028)
|
|
||||||
* `-O` __fade-out-step__:
|
|
||||||
Opacity change between steps while fading out. (default 0.03)
|
|
||||||
* `-D` __fade-delta-time__:
|
|
||||||
The time between steps in a fade in milliseconds. (default 10)
|
|
||||||
* `-m` __opacity__:
|
|
||||||
The opacity for menus. (default 1.0)
|
|
||||||
* `-c`:
|
|
||||||
Enabled client-side shadows on windows.
|
|
||||||
* `-C`:
|
|
||||||
Avoid drawing shadows on dock/panel windows.
|
|
||||||
* `-z`:
|
|
||||||
Zero the part of the shadow's mask behind the window (experimental).
|
|
||||||
* `-f`:
|
|
||||||
Fade windows in/out when opening/closing and when opacity
|
|
||||||
changes, unless --no-fading-openclose is used.
|
|
||||||
* `-F`:
|
|
||||||
Equals -f. Deprecated.
|
|
||||||
* `-i` __opacity__:
|
|
||||||
Opacity of inactive windows. (0.1 - 1.0)
|
|
||||||
* `-e` __opacity__:
|
|
||||||
Opacity of window titlebars and borders. (0.1 - 1.0)
|
|
||||||
* `-G`:
|
|
||||||
Don't draw shadows on DND windows
|
|
||||||
* `-b`:
|
|
||||||
Daemonize/background process.
|
|
||||||
* `-S`:
|
|
||||||
Enable synchronous operation (for debugging).
|
|
||||||
* `--config` __path__:
|
|
||||||
Look for configuration file at the path.
|
|
||||||
* `--shadow-red` __value__:
|
|
||||||
Red color value of shadow (0.0 - 1.0, defaults to 0).
|
|
||||||
* `--shadow-green` __value__:
|
|
||||||
Green color value of shadow (0.0 - 1.0, defaults to 0).
|
|
||||||
* `--shadow-blue` __value__:
|
|
||||||
Blue color value of shadow (0.0 - 1.0, defaults to 0).
|
|
||||||
* `--inactive-opacity-override`:
|
|
||||||
Inactive opacity set by -i overrides value of _NET_WM_OPACITY.
|
|
||||||
* `--inactive-dim` __value__:
|
|
||||||
Dim inactive windows. (0.0 - 1.0, defaults to 0)
|
|
||||||
* `--mark-wmwin-focused`:
|
|
||||||
Try to detect WM windows and mark them as active.
|
|
||||||
* `--shadow-exclude` __condition__:
|
|
||||||
Exclude conditions for shadows.
|
|
||||||
* `--mark-ovredir-focused`:
|
|
||||||
Mark over-redirect windows as active.
|
|
||||||
* `--no-fading-openclose`:
|
|
||||||
Do not fade on window open/close.
|
|
||||||
* `--shadow-ignore-shaped`:
|
|
||||||
Do not paint shadows on shaped windows.
|
|
||||||
* `--detect-rounded-corners`:
|
|
||||||
Try to detect windows with rounded corners and don't consider
|
|
||||||
them shaped windows.
|
|
||||||
|
|
||||||
### Format of a condition:
|
* There are two sets of man pages in the repository: the man pages in groff format (`man/compton.1` & `man/compton-trans.1`) and the man pages in Asciidoc format (`man/compton.1.asciidoc` & `man/compton-trans.1.asciidoc`). The Asciidoc man pages are much more up-to-date than the groff ones, and it is viewable online. As chjj has not yet expressed his attitude towards switching to Asciidoc man pages, I kept both versions. By default the groff version is installed, unless you run `make docs`.
|
||||||
|
|
||||||
`condition = <target>:<type>[<flags>]:<pattern>`
|
## Usage
|
||||||
|
|
||||||
`<target>` is one of `"n"` (window name), `"i"` (window class
|
Please refer to the Asciidoc man pages (`man/compton.1.asciidoc` & `man/compton-trans.1.asciidoc`) for more details and examples.
|
||||||
instance), and `"g"` (window general class)
|
|
||||||
|
|
||||||
`<type>` is one of `"e"` (exact match), `"a"` (match anywhere),
|
Note a sample configuration file `compton.sample.conf` is included in the repository.
|
||||||
`"s"` (match from start), `"w"` (wildcard), and `"p"` (PCRE
|
|
||||||
regular expressions, if compiled with the support).
|
|
||||||
|
|
||||||
`<flags>` could be a series of flags. Currently the only defined
|
## Support
|
||||||
flag is `"i"` (ignore case).
|
|
||||||
|
|
||||||
`<pattern>` is the actual pattern string.
|
* Bug reports and feature requests should go to the "Issues" section above.
|
||||||
|
|
||||||
### Configuration
|
* Our (semi?) official IRC channel is #compton on FreeNode.
|
||||||
|
|
||||||
A more robust
|
* Some information is available on the wiki, including (and presently, only includes) a FAQ.
|
||||||
[sample configuration file](https://raw.github.com/chjj/compton/master/compton.sample.conf)
|
|
||||||
is available in the repository.
|
|
||||||
|
|
||||||
#### Example
|
|
||||||
|
|
||||||
~/compton.conf:
|
|
||||||
|
|
||||||
```
|
|
||||||
# Shadows
|
|
||||||
shadow = true;
|
|
||||||
|
|
||||||
# Opacity
|
|
||||||
inactive-opacity = 0.8;
|
|
||||||
frame-opacity = 0.7;
|
|
||||||
|
|
||||||
# Fades
|
|
||||||
fading = true;
|
|
||||||
```
|
|
||||||
|
|
||||||
Run with:
|
|
||||||
|
|
||||||
``` bash
|
|
||||||
$ compton --config ~/compton.conf
|
|
||||||
```
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
|
|
@ -216,4 +112,4 @@ for this particular tree is something like:
|
||||||
|
|
||||||
Not counting the tens of people who forked it in between.
|
Not counting the tens of people who forked it in between.
|
||||||
|
|
||||||
See LICENSE for more info.
|
Compton is distributed under MIT license, as far as I (richardgv) know. See LICENSE for more info.
|
||||||
|
|
|
||||||
|
|
@ -2,7 +2,7 @@ compton-trans(1)
|
||||||
================
|
================
|
||||||
:doctype: manpage
|
:doctype: manpage
|
||||||
:man source: compton
|
:man source: compton
|
||||||
:man version: nightly-20121105
|
:man version: nightly-20121114
|
||||||
:man manual: LOCAL USER COMMANDS
|
:man manual: LOCAL USER COMMANDS
|
||||||
|
|
||||||
NAME
|
NAME
|
||||||
|
|
@ -12,7 +12,7 @@ compton-trans - an opacity setter tool
|
||||||
SYNOPSIS
|
SYNOPSIS
|
||||||
--------
|
--------
|
||||||
|
|
||||||
*compton-trans* [-w 'WINDOW_ID'] [-n 'WINDOW_NAME'] [-c] [-s] [-o 'OPACITY']
|
*compton-trans* [-w 'WINDOW_ID'] [-n 'WINDOW_NAME'] [-c] [-s] 'OPACITY'
|
||||||
|
|
||||||
DESCRIPTION
|
DESCRIPTION
|
||||||
-----------
|
-----------
|
||||||
|
|
@ -42,31 +42,37 @@ EXAMPLES
|
||||||
* Set the opacity of the window with specific window ID to 75%:
|
* Set the opacity of the window with specific window ID to 75%:
|
||||||
+
|
+
|
||||||
------------
|
------------
|
||||||
compton-trans -w "$WINDOWID" -o 75
|
compton-trans -w "$WINDOWID" 75
|
||||||
------------
|
------------
|
||||||
|
|
||||||
* Set the opacity of the window with the name "urxvt" to 75%:
|
* Set the opacity of the window with the name "urxvt" to 75%:
|
||||||
+
|
+
|
||||||
------------
|
------------
|
||||||
compton-trans -n "urxvt" -o 75
|
compton-trans -n "urxvt" 75
|
||||||
------------
|
------------
|
||||||
|
|
||||||
* Set current window to opacity of 75%:
|
* Set current window to opacity of 75%:
|
||||||
+
|
+
|
||||||
------------
|
------------
|
||||||
compton-trans -c -o 75
|
compton-trans -c 75
|
||||||
------------
|
------------
|
||||||
|
|
||||||
* Select target window and set opacity to 75%:
|
* Select target window and set opacity to 75%:
|
||||||
+
|
+
|
||||||
------------
|
------------
|
||||||
compton-trans -s -o 75
|
compton-trans -s 75
|
||||||
------------
|
------------
|
||||||
|
|
||||||
* Increment opacity of current active window for 5%:
|
* Increment opacity of current active window by 5%:
|
||||||
+
|
+
|
||||||
------------
|
------------
|
||||||
compton-trans -c -o +5
|
compton-trans -c +5
|
||||||
|
------------
|
||||||
|
|
||||||
|
* Decrement opacity of current active window by 5%:
|
||||||
|
+
|
||||||
|
------------
|
||||||
|
compton-trans -c -- -5
|
||||||
------------
|
------------
|
||||||
|
|
||||||
BUGS
|
BUGS
|
||||||
|
|
|
||||||
|
|
@ -142,6 +142,9 @@ OPTIONS
|
||||||
*--use-ewmh-active-win*::
|
*--use-ewmh-active-win*::
|
||||||
Use EWMH '_NET_ACTIVE_WINDOW' to determine currently focused window, rather than listening to 'FocusIn'/'FocusOut' event. Might have more accuracy, provided that the WM supports it. Experimental.
|
Use EWMH '_NET_ACTIVE_WINDOW' to determine currently focused window, rather than listening to 'FocusIn'/'FocusOut' event. Might have more accuracy, provided that the WM supports it. Experimental.
|
||||||
|
|
||||||
|
*--unredir-if-possible*::
|
||||||
|
Unredirect all windows if a full-screen opaque window is detected, to maximize performance for full-screen windows. Known to cause flickering when redirecting/unredirecting windows. *--paint-on-overlay* may make the flickering less obvious. Experimental.
|
||||||
|
|
||||||
FORMAT OF CONDITIONS
|
FORMAT OF CONDITIONS
|
||||||
--------------------
|
--------------------
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue