accessibility/wgetpaste: Added (CLI to various pastebins).

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>

4 files changed, 287 insertions, 70 deletions

diff --git a/accessibility/wgetpaste/wgetpaste.1 b/accessibility/wgetpaste/wgetpaste.1
index c90e11b84e19..5a5d0aa29441 100644
--- a/accessibility/wgetpaste/wgetpaste.1
+++ b/accessibility/wgetpaste/wgetpaste.1
@@ -1,85 +1,169 @@
-.TH WGETPASTE "1" "Dec 2012" "wgetpaste v2.20" "SlackBuilds.org"
-.SH NAME
+.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings.  \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+.    ds -- \(*W-
+.    ds PI pi
+.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
+.    ds L" ""
+.    ds R" ""
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds -- \|\(em\|
+.    ds PI \(*p
+.    ds L" ``
+.    ds R" ''
+.    ds C`
+.    ds C'
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.\"
+.\" Avoid warning from groff about undefined register 'F'.
+.de IX
+..
+.nr rF 0
+.if \n(.g .if rF .nr rF 1
+.if (\n(rF:(\n(.g==0)) \{
+.    if \nF \{
+.        de IX
+.        tm Index:\\$1\t\\n%\t"\\$2"
+..
+.        if !\nF==2 \{
+.            nr % 0
+.            nr F 2
+.        \}
+.    \}
+.\}
+.rr rF
+.\" ========================================================================
+.\"
+.IX Title "WGETPASTE 1"
+.TH WGETPASTE 1 "2014-08-18" "2.25" "SlackBuilds.org"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH "NAME"
 wgetpaste \- Command\-line interface to various pastebin sites
-.SH SYNOPSIS
-.B wgetpaste
-[\fIoptions\fR] [\fIfile\fR[\fIs\fR]]
-.SH OPTIONS
-.TP
-\fB\-l\fR, \fB\-\-language\fR LANG
-set language (defaults to "Plain Text")
-.HP
-\fB\-d\fR, \fB\-\-description\fR DESCRIPTION set description (defaults to "stdin" or filename)
-.TP
-\fB\-n\fR, \fB\-\-nick\fR NICK
+.SH "SYNOPSIS"
+.IX Header "SYNOPSIS"
+wgetpaste [options] [file[s]]
+.SH "OPTIONS"
+.IX Header "OPTIONS"
+.IP "\-l, \-\-language \s-1LANG\s0" 4
+.IX Item "-l, --language LANG"
+set language (defaults to \*(L"Plain Text\*(R")
+.IP "\-d, \-\-description \s-1DESCRIPTION\s0" 4
+.IX Item "-d, --description DESCRIPTION"
+set description (defaults to \*(L"stdin\*(R" or filename)
+.IP "\-n, \-\-nick \s-1NICK\s0" 4
+.IX Item "-n, --nick NICK"
 set nick (defaults to your username)
-.TP
-\fB\-s\fR, \fB\-\-service\fR SERVICE
-set service to use (defaults to "bpaste")
-.TP
-\fB\-e\fR, \fB\-\-expiration\fR EXPIRATION
-set when it should expire (defaults to "30 days")
-.TP
-\fB\-S\fR, \fB\-\-list\-services\fR
+.IP "\-s, \-\-service \s-1SERVICE\s0" 4
+.IX Item "-s, --service SERVICE"
+set service to use (defaults to \*(L"bpaste\*(R")
+.IP "\-e, \-\-expiration \s-1EXPIRATION\s0" 4
+.IX Item "-e, --expiration EXPIRATION"
+set when it should expire (defaults to \*(L"1 month\*(R")
+.IP "\-S, \-\-list\-services" 4
+.IX Item "-S, --list-services"
 list supported pastebin services
-.TP
-\fB\-L\fR, \fB\-\-list\-languages\fR
+.IP "\-L, \-\-list\-languages" 4
+.IX Item "-L, --list-languages"
 list languages supported by the specified service
-.TP
-\fB\-E\fR, \fB\-\-list\-expiration\fR
+.IP "\-E, \-\-list\-expiration" 4
+.IX Item "-E, --list-expiration"
 list expiration setting supported by the specified service
-.TP
-\fB\-u\fR, \fB\-\-tinyurl\fR URL
+.IP "\-u, \-\-tinyurl \s-1URL\s0" 4
+.IX Item "-u, --tinyurl URL"
 convert input url to tinyurl
-.TP
-\fB\-c\fR, \fB\-\-command\fR COMMAND
-paste COMMAND and the output of COMMAND
-.TP
-\fB\-i\fR, \fB\-\-info\fR
+.IP "\-c, \-\-command \s-1COMMAND\s0" 4
+.IX Item "-c, --command COMMAND"
+paste \s-1COMMAND\s0 and the output of \s-1COMMAND\s0
+.IP "\-i, \-\-info" 4
+.IX Item "-i, --info"
 append the output of `wgetpaste_info`
-.TP
-\fB\-I\fR, \fB\-\-info\-only\fR
+.IP "\-I, \-\-info\-only" 4
+.IX Item "-I, --info-only"
 paste the output of `wgetpaste_info` only
-.TP
-\fB\-x\fR, \fB\-\-xcut\fR
+.IP "\-x, \-\-xcut" 4
+.IX Item "-x, --xcut"
 read input from clipboard (requires xclip)
-.TP
-\fB\-X\fR, \fB\-\-xpaste\fR
+.IP "\-X, \-\-xpaste" 4
+.IX Item "-X, --xpaste"
 write resulting url to the X primary selection buffer (requires xclip)
-.TP
-\fB\-C\fR, \fB\-\-xclippaste\fR
+.IP "\-C, \-\-xclippaste" 4
+.IX Item "-C, --xclippaste"
 write resulting url to the X clipboard selection buffer (requires xclip)
-.TP
-\fB\-r\fR, \fB\-\-raw\fR
+.IP "\-r, \-\-raw" 4
+.IX Item "-r, --raw"
 show url for the raw paste (no syntax highlighting or html)
-.TP
-\fB\-t\fR, \fB\-\-tee\fR
+.IP "\-t, \-\-tee" 4
+.IX Item "-t, --tee"
 use tee to show what is being pasted
-.TP
-\fB\-v\fR, \fB\-\-verbose\fR
+.IP "\-v, \-\-verbose" 4
+.IX Item "-v, --verbose"
 show wget stderr output if no url is received
-.TP
-\fB\-\-completions\fR
-emit output suitable for shell completions (only affects \fB\-\-list\-\fR*)
-.TP
-\fB\-\-debug\fR
-be *very* verbose (implies \fB\-v\fR)
-.TP
-\fB\-h\fR, \fB\-\-help\fR
+.IP "\-\-completions" 4
+.IX Item "--completions"
+emit output suitable for shell completions (only affects \-\-list\-*)
+.IP "\-\-debug" 4
+.IX Item "--debug"
+be *very* verbose (implies \-v)
+.IP "\-h, \-\-help" 4
+.IX Item "-h, --help"
 show this help
-.TP
-\fB\-g\fR, \fB\-\-ignore\-configs\fR
+.IP "\-g, \-\-ignore\-configs" 4
+.IX Item "-g, --ignore-configs"
 ignore /etc/wgetpaste.conf, ~/.wgetpaste.conf etc.
-.TP
-\fB\-\-version\fR
+.IP "\-\-version" 4
+.IX Item "--version"
 show version information
 .PP
-Defaults (DEFAULT_{NICK,SERVICE,LANGUAGE,EXPIRATION}[_${SERVICE}]) can be overridden
-globally in /etc/wgetpaste.conf or /etc/wgetpaste.d/*.conf or per user in any of
-~/.wgetpaste.conf or ~/.wgetpaste.d/*.conf.
-.SH AUTHOR
+Defaults (DEFAULT_{\s-1NICK,LANGUAGE,EXPIRATION\s0}[_${\s-1SERVICE\s0}] and \s-1DEFAULT_SERVICE\s0)
+can be overridden globally in /etc/wgetpaste.conf or /etc/wgetpaste.d/*.conf or
+per user in any of ~/.wgetpaste.conf or ~/.wgetpaste.d/*.conf.
+.PP
+An additional http header can be passed by setting HEADER_${\s-1SERVICE\s0} in any of the
+configuration files mentioned above. For example, authenticating with github gist:
+HEADER_gists=\*(L"Authorization: token 1234abc56789...\*(R"
+.SH "AUTHOR"
+.IX Header "AUTHOR"
 Copyright (c) 2007 Bo Ørsted Andresen <bo.andresen@zlin.dk>
-.br
+.PP
 Distributed as-is. With no warranties.
 .PP
 Man page created by B. Watson <yalhcru@gmail.com>, for the SlackBuilds.org project (but
diff --git a/accessibility/wgetpaste/wgetpaste.SlackBuild b/accessibility/wgetpaste/wgetpaste.SlackBuild
index fb63ca5a1ee8..6dc2c2472ea2 100644
--- a/accessibility/wgetpaste/wgetpaste.SlackBuild
+++ b/accessibility/wgetpaste/wgetpaste.SlackBuild
@@ -6,8 +6,12 @@
 
 # Licensed under the WTFPL. See http://sam.zoy.org/wtfpl/ for details.
 
+# 20140818 bkw:
+# - Updated to 2.25.
+# - Rewrote man page in pod.
+
 PRGNAM=wgetpaste
-VERSION=${VERSION:-2.23}
+VERSION=${VERSION:-2.25}
 BUILD=${BUILD:-1}
 TAG=${TAG:-_SBo}
 
@@ -30,10 +34,10 @@ tar xvf $CWD/$PRGNAM-$VERSION.tar.bz2
 cd $PRGNAM-$VERSION
 chown -R root:root .
 find -L . \
- \( -perm 777 -o -perm 775 -o -perm 750 -o -perm 711 -o -perm 555 -o -perm 511 \) \
- -exec chmod 755 {} \; -o \
+ \( -perm 777 -o -perm 775 -o -perm 750 -o -perm 711 -o -perm 555 \
+  -o -perm 511 \) -exec chmod 755 {} \; -o \
  \( -perm 666 -o -perm 664 -o -perm 640 -o -perm 600 -o -perm 444 \
- -o -perm 440 -o -perm 400 \) -exec chmod 644 {} \;
+  -o -perm 440 -o -perm 400 \) -exec chmod 644 {} \;
 
 # x11-misc/xclip => xclip
 # 'emerge --info' => wgetpaste_info
diff --git a/accessibility/wgetpaste/wgetpaste.info b/accessibility/wgetpaste/wgetpaste.info
index 7937d1f55ae8..13b54ad2cff9 100644
--- a/accessibility/wgetpaste/wgetpaste.info
+++ b/accessibility/wgetpaste/wgetpaste.info
@@ -1,8 +1,8 @@
 PRGNAM="wgetpaste"
-VERSION="2.23"
+VERSION="2.25"
 HOMEPAGE="http://wgetpaste.zlin.dk/"
-DOWNLOAD="http://wgetpaste.zlin.dk/wgetpaste-2.23.tar.bz2"
-MD5SUM="e665b12f9c5224c2368586650e6b6878"
+DOWNLOAD="http://wgetpaste.zlin.dk/wgetpaste-2.25.tar.bz2"
+MD5SUM="073766b6185e2bd2b3ba0a2d44d32cf4"
 DOWNLOAD_x86_64=""
 MD5SUM_x86_64=""
 REQUIRES=""
diff --git a/accessibility/wgetpaste/wgetpaste.pod b/accessibility/wgetpaste/wgetpaste.pod
new file mode 100644
index 000000000000..d716d8bd38ad
--- /dev/null
+++ b/accessibility/wgetpaste/wgetpaste.pod
@@ -0,0 +1,129 @@
+# pod source for wgetpaste man page. Convert with:
+# pod2man --stderr -s1 -cSlackBuilds.org -r2.25 -u wgetpaste.pod > wgetpaste.1
+
+=pod
+
+=encoding utf8
+
+=head1 NAME
+
+wgetpaste - Command-line interface to various pastebin sites
+
+=head1 SYNOPSIS
+
+wgetpaste [options] [file[s]]
+
+=head1 OPTIONS
+
+=over 4
+
+=item -l, --language LANG
+
+set language (defaults to "Plain Text")
+
+=item -d, --description DESCRIPTION
+
+set description (defaults to "stdin" or filename)
+
+=item -n, --nick NICK
+
+set nick (defaults to your username)
+
+=item -s, --service SERVICE
+
+set service to use (defaults to "bpaste")
+
+=item -e, --expiration EXPIRATION
+
+set when it should expire (defaults to "1 month")
+
+=item -S, --list-services
+
+list supported pastebin services
+
+=item -L, --list-languages
+
+list languages supported by the specified service
+
+=item -E, --list-expiration
+
+list expiration setting supported by the specified service
+
+=item -u, --tinyurl URL
+
+convert input url to tinyurl
+
+=item -c, --command COMMAND
+
+paste COMMAND and the output of COMMAND
+
+=item -i, --info
+
+append the output of `wgetpaste_info`
+
+=item -I, --info-only
+
+paste the output of `wgetpaste_info` only
+
+=item -x, --xcut
+
+read input from clipboard (requires xclip)
+
+=item -X, --xpaste
+
+write resulting url to the X primary selection buffer (requires xclip)
+
+=item -C, --xclippaste
+
+write resulting url to the X clipboard selection buffer (requires xclip)
+
+=item -r, --raw
+
+show url for the raw paste (no syntax highlighting or html)
+
+=item -t, --tee
+
+use tee to show what is being pasted
+
+=item -v, --verbose
+
+show wget stderr output if no url is received
+
+=item --completions
+
+emit output suitable for shell completions (only affects --list-*)
+
+=item --debug
+
+be *very* verbose (implies -v)
+
+=item -h, --help
+
+show this help
+
+=item -g, --ignore-configs
+
+ignore /etc/wgetpaste.conf, ~/.wgetpaste.conf etc.
+
+=item --version
+
+show version information
+
+=back
+
+Defaults (DEFAULT_{NICK,LANGUAGE,EXPIRATION}[_${SERVICE}] and DEFAULT_SERVICE)
+can be overridden globally in /etc/wgetpaste.conf or /etc/wgetpaste.d/*.conf or
+per user in any of ~/.wgetpaste.conf or ~/.wgetpaste.d/*.conf.
+
+An additional http header can be passed by setting HEADER_${SERVICE} in any of the
+configuration files mentioned above. For example, authenticating with github gist:
+HEADER_gists="Authorization: token 1234abc56789..."
+
+=head1 AUTHOR
+
+Copyright (c) 2007 Bo Ørsted Andresen <bo.andresen@zlin.dk>
+
+Distributed as-is. With no warranties.
+
+Man page created by B. Watson <yalhcru@gmail.com>, for the SlackBuilds.org project (but
+it may be used by anyone).