diff --git a/Makefile b/Makefile index 0ceb282..10e6f17 100644 --- a/Makefile +++ b/Makefile @@ -55,8 +55,10 @@ compton: $(OBJS) docs: # HTML documentation asciidoc man/compton.1.asciidoc + asciidoc man/compton-trans.1.asciidoc # man page a2x --format manpage man/compton.1.asciidoc + a2x --format manpage man/compton-trans.1.asciidoc install: compton @install -Dm755 compton "$(DESTDIR)$(BINDIR)"/compton diff --git a/man/compton-trans.1.asciidoc b/man/compton-trans.1.asciidoc new file mode 100644 index 0000000..2070cc5 --- /dev/null +++ b/man/compton-trans.1.asciidoc @@ -0,0 +1,82 @@ +compton-trans(1) +================ +:doctype: manpage +:man source: compton +:man version: nightly-20121105 +:man manual: LOCAL USER COMMANDS + +NAME +---- +compton-trans - an opacity setter tool + +SYNOPSIS +-------- + +*compton-trans* [-w 'WINDOW_ID'] [-n 'WINDOW_NAME'] [-c] [-s] [-o 'OPACITY'] + +DESCRIPTION +----------- + +*compton-trans* is a bash script that sets '_NET_WM_WINDOW_OPACITY' attribute of a window using standard X11 command-line utilities, including *xprop*(1) and *xwininfo*(1). It is similar to *transset*(1) or *transset-df*(1). + +OPTIONS +------- +*-w* 'WINDOW_ID':: +Specify the window id of the target window. + +*-n* 'WINDOW_NAME':: +Specify and try to match a window name. + +*-c*:: +Specify the currently active window as target. Only works if EWMH '_NET_ACTIVE_WINDOW' property exists on root window. + +*-s*:: +Select target window with mouse cursor. This is the default if no window has been specified. + +*-o* 'OPACITY':: +Specify the new opacity value for the window. This value can be anywhere from 1-100. If it is prefixed with a plus or minus (+/-), this will increment or decrement from the target window's current opacity instead. + +EXAMPLES +-------- + +* Set the opacity of the window with specific window ID to 75%: ++ +------------ +compton-trans -w "$WINDOWID" -o 75 +------------ + +* Set the opacity of the window with the name "urxvt" to 75%: ++ +------------ +compton-trans -n "urxvt" -o 75 +------------ + +* Set current window to opacity of 75%: ++ +------------ +compton-trans -c -o 75 +------------ + +* Select target window and set opacity to 75%: ++ +------------ +compton-trans -s -o 75 +------------ + +* Increment opacity of current active window for 5%: ++ +------------ +compton-trans -c -o +5 +------------ + +BUGS +---- +Please report any bugs you find to . + +AUTHORS +------- +Christopher Jeffrey (). + +SEE ALSO +-------- +link:compton.1.html[*compton*(1)], *xprop*(1), *xwininfo*(1) diff --git a/man/compton.1.asciidoc b/man/compton.1.asciidoc index b91a587..9c719ed 100644 --- a/man/compton.1.asciidoc +++ b/man/compton.1.asciidoc @@ -2,7 +2,7 @@ compton(1) ========== :doctype: manpage :man source: compton -:man version: nightly-20121101 +:man version: nightly-20121105 :man manual: LOCAL USER COMMANDS NAME @@ -137,8 +137,10 @@ OPTIONS Painting on X Composite overlay window instead of on root window. *--sw-opti*:: - Limit compton to repaint at most once every 1 / 'refresh_rate' - second to boost performance. Experimental. + Limit compton to repaint at most once every 1 / 'refresh_rate' second to boost performance. Experimental. + +*--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. FORMAT OF CONDITIONS --------------------