created new fluxbox-remote man page

3 files changed, 80 insertions, 1 deletions

diff --git a/doc/Makefile.am b/doc/Makefile.am
index ad34dad..afc6040 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -5,7 +5,7 @@ SUBDIRS = ru
 CLEANFILES = fluxbox.1 fluxstyle.1
 MAINTAINERCLEANFILES = Makefile.in
 man_MANS = fluxbox.1 fbsetroot.1 fbrun.1 fbsetbg.1 \
-        startfluxbox.1 fluxstyle.1 fbrun.1 fluxbox-keys.5 
+        startfluxbox.1 fluxstyle.1 fbrun.1 fluxbox-keys.5 fluxbox-remote.1
 EXTRA_DIST=fluxbox.1.in fbsetroot.1 fbrun.1 startfluxbox.1 fbsetbg.1 \
         fluxstyle.1.in CODESTYLE
 distclean-local:
diff --git a/doc/asciidoc/fluxbox-remote.txt b/doc/asciidoc/fluxbox-remote.txt
new file mode 100644
index 0000000..220f794
--- /dev/null
+++ b/doc/asciidoc/fluxbox-remote.txt
@@ -0,0 +1,40 @@
+fluxbox-remote(1)
+===============
+Mark Tiefenbruck <mark@fluxbox.org>
+v1.0.0, 6 August, 2008
+
+NAME
+----
+fluxbox-remote - command line access to key commands for fluxbox(1)
+
+SYNOPSIS
+--------
+*fluxbox-remote* 'command'
+
+DESCRIPTION
+-----------
+'fluxbox-remote(1)' is designed to allow scripts to execute most key commands from 'fluxbox(1)'. 'fluxbox-remote(1)' will only work with 'fluxbox(1)': its communications with 'fluxbox(1)' are not standardized in any way. It is recommended that a standards-based tool such as 'wmctrl(1)' be used whenever possible, in order for scripts to work with other window managers.
+
+CAVEATS
+-------
+'fluxbox-remote(1)' uses the X11 protocol to communicate with 'fluxbox(1)'.
+Therefore, it is possible for any user with access to the 'X(7)' server to use
+'fluxbox-remote(1)'. For this reason, several key commands have been disabled.
+Users should be aware of the security implications when enabling
+'fluxbox-remote(1)', especially when using a forwarded 'X(7)' connection.
+
+RESOURCES
+---------
+session.screen0.allowRemoteActions: <boolean>::
+      This resource in ~/.fluxbox/init must be set to `true' in order for
+      'fluxbox-remote(1)' to function. Please read the *CAVEATS* first.
+
+ENVIRONMENT
+-----------
+In order to communicate with 'fluxbox(1)', the DISPLAY environment variable must
+be set properly. Usually, the value should be `:0.0'.
+
+SEE ALSO
+--------
+fluxbox(1), fluxbox-keys(5), wmctrl(1)
+
diff --git a/doc/fluxbox-remote.1 b/doc/fluxbox-remote.1
new file mode 100644
index 0000000..0a7457c
--- /dev/null
+++ b/doc/fluxbox-remote.1
@@ -0,0 +1,39 @@
+.\"     Title: fluxbox-remote
+.\"    Author: 
+.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
+.\"      Date: 08/06/2008
+.\"    Manual: 
+.\"    Source: 
+.\"
+.TH "FLUXBOX\-REMOTE" "1" "08/06/2008" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+fluxbox-remote - command line access to key commands for fluxbox(1)
+.SH "SYNOPSIS"
+\fBfluxbox\-remote\fR \fIcommand\fR
+.sp
+.SH "DESCRIPTION"
+\fIfluxbox\-remote(1)\fR is designed to allow scripts to execute most key commands from \fIfluxbox(1)\fR\. \fIfluxbox\-remote(1)\fR will only work with \fIfluxbox(1)\fR: its communications with \fIfluxbox(1)\fR are not standardized in any way\. It is recommended that a standards\-based tool such as \fIwmctrl(1)\fR be used whenever possible, in order for scripts to work with other window managers\.
+.sp
+.SH "CAVEATS"
+\fIfluxbox\-remote(1)\fR uses the X11 protocol to communicate with \fIfluxbox(1)\fR\. Therefore, it is possible for any user with access to the \fIX(7)\fR server to use \fIfluxbox\-remote(1)\fR\. For this reason, several key commands have been disabled\. Users should be aware of the security implications when enabling \fIfluxbox\-remote(1)\fR, especially when using a forwarded \fIX(7)\fR connection\.
+.sp
+.SH "RESOURCES"
+.PP
+session\.screen0\.allowRemoteActions: <boolean>
+.RS 4
+This resource in ~/\.fluxbox/init must be set to `true\' in order for
+\fIfluxbox\-remote(1)\fR
+to function\. Please read the
+\fBCAVEATS\fR
+first\.
+.RE
+.SH "ENVIRONMENT"
+In order to communicate with \fIfluxbox(1)\fR, the DISPLAY environment variable must be set properly\. Usually, the value should be `:0\.0\'\.
+.sp
+.SH "SEE ALSO"
+fluxbox(1), fluxbox\-keys(5), wmctrl(1)
+.sp