From c76d0fc150bc38cf079e4b4cf454c2bb23101c5b Mon Sep 17 00:00:00 2001
From: Richard Grenville <pyxlcy@gmail.com>
Date: Mon, 5 Nov 2012 18:06:31 +0800
Subject: [PATCH] Misc: Asciidoc man page update

- Add man page for compton-trans in Asciidoc format.

- Add description of --use-ewmh-active-win to compton man page.
---
 Makefile                     |  2 +
 man/compton-trans.1.asciidoc | 82 ++++++++++++++++++++++++++++++++++++
 man/compton.1.asciidoc       |  8 ++--
 3 files changed, 89 insertions(+), 3 deletions(-)
 create mode 100644 man/compton-trans.1.asciidoc

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 <https://github.com/chjj/compton> .
+
+AUTHORS
+-------
+Christopher Jeffrey (<https://github.com/chjj>).
+
+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
 --------------------