summaryrefslogtreecommitdiffstats
path: root/accessibility/wgetpaste/wgetpaste.1
blob: d232592d17d1ef8441878b53aa1dd007f34fdc4b (plain)
.\" 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 "2015-01-25" "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"
.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)
.IP "\-s, \-\-service \s-1SERVICE\s0" 4
.IX Item "-s, --service SERVICE"
set service to use (defaults to \*(L"dpaste\*(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
.IP "\-L, \-\-list\-languages" 4
.IX Item "-L, --list-languages"
list languages supported by the specified service
.IP "\-E, \-\-list\-expiration" 4
.IX Item "-E, --list-expiration"
list expiration setting supported by the specified service
.IP "\-u, \-\-tinyurl \s-1URL\s0" 4
.IX Item "-u, --tinyurl URL"
convert input url to tinyurl
.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`
.IP "\-I, \-\-info\-only" 4
.IX Item "-I, --info-only"
paste the output of `wgetpaste_info` only
.IP "\-x, \-\-xcut" 4
.IX Item "-x, --xcut"
read input from clipboard (requires xclip)
.IP "\-X, \-\-xpaste" 4
.IX Item "-X, --xpaste"
write resulting url to the X primary selection buffer (requires xclip)
.IP "\-C, \-\-xclippaste" 4
.IX Item "-C, --xclippaste"
write resulting url to the X clipboard selection buffer (requires xclip)
.IP "\-r, \-\-raw" 4
.IX Item "-r, --raw"
show url for the raw paste (no syntax highlighting or html)
.IP "\-t, \-\-tee" 4
.IX Item "-t, --tee"
use tee to show what is being pasted
.IP "\-v, \-\-verbose" 4
.IX Item "-v, --verbose"
show wget stderr output if no url is received
.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
.IP "\-g, \-\-ignore\-configs" 4
.IX Item "-g, --ignore-configs"
ignore /etc/wgetpaste.conf, ~/.wgetpaste.conf etc.
.IP "\-\-version" 4
.IX Item "--version"
show version information
.PP
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 "BUGS"
.IX Header "BUGS"
\&\fBwgetpaste\fR works by hard-coding URLs and \s-1CGI\s0 parameters into
the script. This means that if a paste service's web site changes,
\&\fBwgetpaste\fR might stop working with that site. Currently (January 2015),
the \fBca\fR (http://pastebin.ca) and \fBbpaste\fR (http://bpaste.net) services
are broken, and the others have been tested and work \s-1OK.\s0
.SH "AUTHOR"
.IX Header "AUTHOR"
Copyright (c) 2007 Bo Ørsted Andresen <bo.andresen@zlin.dk>
.PP
Distributed as-is. With no warranties.
.PP
Man page created by B. Watson <yalhcru@gmail.com>, for the SlackBuilds.org project (but
it may be used by anyone).