screen-profiles-export.1: manpage for new script

debian/changelog

@@ -12,11 +12,12 @@ screen-profiles (1.41) unreleased; urgency=low
   * licenses updated to GPLv3 (dropped "or later" clause)
   * screen-profiles-export: new script, for exporting a profile to systems
     where screen-profiles are not installed
+  * screen-profiles-export.1: manpage for new script
 
   [ James Wilcox ]
   * bin/updates-available: support SUSE's zypper
 
- -- Dustin Kirkland <kirkland@ubuntu.com>  Sat, 28 Mar 2009 11:30:38 -0500
+ -- Dustin Kirkland <kirkland@ubuntu.com>  Sat, 28 Mar 2009 11:45:36 -0500
 
 screen-profiles (1.40-0ubuntu1) jaunty; urgency=low
 

debian/rules

@@ -40,7 +40,7 @@ binary-indep: build install
 	dh_testdir -i
 	dh_testroot -i
 	dh_installdocs -X.bzr -i
-	dh_installman -i screen-launcher.1 screen-profiles.1 select-screen-profile.1 motd+shell.1
+	dh_installman -i screen-launcher.1 screen-profiles.1 select-screen-profile.1 motd+shell.1 screen-profiles-export.1
 	dh_installchangelogs -i
 	dh_installdebconf -i
 	dh_compress -i

screen-profiles-export

@@ -17,17 +17,6 @@
 #    You should have received a copy of the GNU General Public License
 #    along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-
-# Inputs needed:
-#   target tarball (-f)
-#     .tar
-#     .tar.bz2
-#     .tar.gz
-#   selected profile
-#     choose distro (-d)
-#     choose light/dark (-i)
-#     choose color (-c)
-
 PROG="screen-profiles"
 SHARE="/usr/share/$PROG"
 TMPDIR=`mktemp -d screen-profiles.XXXXXXXX` || error "Could not create a temporary directory"
@@ -177,9 +166,8 @@ while [ $# -gt 1 ]; do
 done
 
 [ -z "$file" ] && usage
-[ -e "$file" -o -e "$file.tar.gz" ] && error "File exists, please remove before running [$file]"
+echo "$file" | grep -qs "\.tar\.gz$" || error "Target file must be a '.tar.gz' archive"
-file=`echo "$file" | sed "s:\.tar.*$::"`
+[ -e "$file" ] && error "File exists, please remove before running [$file]"
-file="$file".tar.gz
 
 # Grab list of available distros and colors
 distros=`find $SHARE/profiles/ -type f | xargs -i basename {} | sed "s/-.*$//" | sort -u | grep -v "common" | grep -v "plain"`

screen-profiles-export.1

@@ -0,0 +1,31 @@
+.TH screen\-launcher 1 "28 Mar 2009" screen-profiles-export "screen-profiles"
+.SH NAME
+screen\-profiles\-export \- create a screen-profiles archive for export
+
+.SH SYNOPSIS
+.BI "screen\-profiles\-export [\-d DISTRO \-c COLOR] \-f TARGET.tar.gz"
+
+.SH OPTIONS
+.TP
+.B \-d DISTRO -c COLOR
+Optional parameters specifying the desired distro/color theme.  If omitted, the program will interactively prompt for both of these values.
+.TP
+.B \-f TARGET.tar.gz
+Required parameter for the target file to contain the output archive.
+
+.SH DESCRIPTION
+\fBscreen\-profiles\-export\fP is a program that creates a monolithic .screenrc profile, and copies the status notification scripts into an archive file.  This archive can then be extracted on a target system where \fBscreen\-profiles\fP is not installed (perhaps because the program is not packaged for that distribution, or perhaps because the administrator has not installed the package).
+
+.SH "SEE ALSO"
+.PD 0
+.TP
+\fBscreen\fP(1), \fBscreen\-profiles\fP(1)
+
+.TP
+\fIhttp://launchpad.net/screen-profiles\fP
+.PD
+
+.SH AUTHOR
+This manpage was written by Dustin Kirkland <kirkland@canonical.com> for Ubuntu systems (but may be used by others).  Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 published by the Free Software Foundation.
+
+On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.