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

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

1 files changed, 147 insertions, 63 deletions

diff --git a/accessibility/wgetpaste/wgetpaste.1 b/accessibility/wgetpaste/wgetpaste.1
index c90e11b84e..5a5d0aa294 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