From 541f2f2d8edcedf7fcaf81beb8b847fc463aa343 Mon Sep 17 00:00:00 2001
From: Peter Oliver <github.com@mavit.org.uk>
Date: Thu, 3 May 2012 20:05:02 +0100
Subject: [PATCH] Add a description.

---
 README.pod | 12 +++++++++++-
 xsudo      | 12 +++++++++++-
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/README.pod b/README.pod
index 450a111..058ffb0 100644
--- a/README.pod
+++ b/README.pod
@@ -8,7 +8,17 @@ B<xsudo> I<sudo-arguments> ...
 
 =head1 DESCRIPTION
 
-FIXME
+Running X Window programs as a different user with sudo generally
+doesn't work because the target user can't authenticate with the X11
+server.
+
+This program copies your authorisation token into a temporary file
+readable by the target user.  Call it in place of sudo.
+
+In addition, you need to make sure that the DISPLAY and XAUTHORITY
+environment variables are passed to the program run by sudo.  See the
+C<env_keep> option in L<sudoers(5)> if you find that this is not the
+case.
 
 
 =cut
diff --git a/xsudo b/xsudo
index 8b91f3f..52df6ad 100755
--- a/xsudo
+++ b/xsudo
@@ -13,7 +13,17 @@ B<xsudo> I<sudo-arguments> ...
 
 =head1 DESCRIPTION
 
-FIXME
+Running X Window programs as a different user with sudo generally
+doesn't work because the target user can't authenticate with the X11
+server.
+
+This program copies your authorisation token into a temporary file
+readable by the target user.  Call it in place of sudo.
+
+In addition, you need to make sure that the DISPLAY and XAUTHORITY
+environment variables are passed to the program run by sudo.  See the
+C<env_keep> option in L<sudoers(5)> if you find that this is not the
+case.
 
 =cut