178 lines
5.8 KiB
Groff
178 lines
5.8 KiB
Groff
.\" 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 <urchlay@slackware.uk>, for the SlackBuilds.org project (but
|
|
it may be used by anyone).
|