[gnome-utils] [screenshot] add a manual page

[Cosimo Cecchi <cosimoc src gnome org>]

commit 31c0838ed60639fb6bcd45c9f066232d1f6d40f7
Author: Cosimo Cecchi <cosimoc gnome org>
Date:   Sun Jun 28 12:08:29 2009 +0200

    [screenshot] add a manual page
    
    Import an adapted manual page based on the Debian one.
    Close bug #587144.

 gnome-screenshot/Makefile.am        |    3 ++
 gnome-screenshot/gnome-screenshot.1 |   59 +++++++++++++++++++++++++++++++++++
 2 files changed, 62 insertions(+), 0 deletions(-)
---
diff --git a/gnome-screenshot/Makefile.am b/gnome-screenshot/Makefile.am
index 844a4d1..6e775db 100644
--- a/gnome-screenshot/Makefile.am
+++ b/gnome-screenshot/Makefile.am
@@ -40,6 +40,8 @@ gnome_screenshot_in_files = gnome-screenshot.desktop.in
 gnome_screenshot_DATA = $(gnome_screenshot_in_files:.desktop.in=.desktop)
 @INTLTOOL_DESKTOP_RULE@
 
+man_MANS = gnome-screenshot.1
+
 uidir = $(datadir)/gnome-screenshot
 ui_DATA =					\
 	gnome-screenshot.ui			\
@@ -48,6 +50,7 @@ ui_DATA =					\
 EXTRA_DIST =					\
 	$(schemas_in_files)			\
 	$(gnome_screenshot_in_files)		\
+	$(man_MANS)				\
 	$(ui_DATA)				\
 	$(NULL)
 
diff --git a/gnome-screenshot/gnome-screenshot.1 b/gnome-screenshot/gnome-screenshot.1
new file mode 100644
index 0000000..7619847
--- /dev/null
+++ b/gnome-screenshot/gnome-screenshot.1
@@ -0,0 +1,59 @@
+.\\" auto-generated by docbook2man-spec $Revision: 1.1 $
+.TH "GNOME-SCREENSHOT" "1" "June 28, 2009" "" ""
+.SH NAME
+gnome-screenshot \- capture the screen, a window, or an user-defined area and save the snapshot image to a file.
+.SH SYNOPSIS
+.sp
+\fBgnome-screenshot\fR [ \fB-w\fR ]  [ \fB-a\fR ]  [ \fB-b\fR ]  [ \fB-B\fR ]  [ \fB-d \fISECONDS\fB \fR ]  [ \fB-e \fIEFFECT\fB \fR ]  [ \fB-i\fR ]  [ \fB--display \fIDISPLAY\fB \fR ] 
+.SH "DESCRIPTION"
+.PP
+\fBgnome-screenshot\fR is a GNOME utility for taking
+screenshots of the entire screen, a window or an user-defined area of the screen, with optional beutifying
+border effects.
+.SH "OPTIONS"
+.TP
+\fB-w, --window\fR
+Grab the current active window instead of the entire
+screen.
+.TP
+\fB-a, --area\fR
+Grab an area of the screen instead of the entire screen.
+.TP
+\fB-b, --include-border\fR
+Include the window border within the screenshot.
+.TP
+\fB-B, --remove-border\fR
+Remove the window border from the screenshot.
+.TP
+\fB-d, --delay=\fISECONDS\fB,\fR
+Take the screenshot after the specified delay [in seconds].
+.TP
+\fB-e, --effect=\fIEFFECT\fB,\fR
+Add an effect to the outside of the screenshot border.
+\fIEFFECT\fR can be ``shadow'' 
+(adding drop shadow), ``border'' (adding rectangular
+space around the screenshot) or ``none'' (no effect).
+Default is ``none''.
+.TP
+\fB-i, --interactive\fR
+Interactively set options in a dialog.
+.TP
+\fB--display=\fIDISPLAY\fB\fR
+X display to use.
+.TP
+\fB-?, -h, --help\fR
+Show a summary of the available options.
+.PP
+In addition, the usual GTK+ and GNOME command line options apply.
+See the output of --help for details.
+.PP
+.SH "SEE ALSO"
+.PP
+gnome-options(7), gtk-options(7)
+.SH "AUTHOR"
+.PP
+This manual page was written by Christian Marillat <marillat debian org> for
+the Debian GNU/Linux system (but may be used by others).
+.PP
+Updated by Theppitak Karoonboonyanan
+<thep linux thai net>, Tom Feiner <feiner tom gmail com> and Cosimo Cecchi <cosimoc gnome org>