183 lines
6.3 KiB
Groff
183 lines
6.3 KiB
Groff
.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
|
|
.\"
|
|
.\" 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 >0, 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 "2023-12-20" "2.33" "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 "\fB\-l\fR, \fB\-\-language\fR \fIlang\fR" 4
|
|
.IX Item "-l, --language lang"
|
|
set language (defaults to \*(L"Plain Text\*(R")
|
|
.IP "\fB\-d\fR, \fB\-\-description\fR \fIdescription\fR" 4
|
|
.IX Item "-d, --description description"
|
|
set description (defaults to \*(L"stdin\*(R" or filename)
|
|
.IP "\fB\-n\fR, \fB\-\-nick\fR \fInick\fR" 4
|
|
.IX Item "-n, --nick nick"
|
|
set nick (defaults to your username)
|
|
.IP "\fB\-s\fR, \fB\-\-service\fR \fIservice\fR" 4
|
|
.IX Item "-s, --service service"
|
|
set service to use (defaults to \fIbpaste\fR)
|
|
.IP "\fB\-e\fR, \fB\-\-expiration\fR \fIexpiration\fR" 4
|
|
.IX Item "-e, --expiration expiration"
|
|
set when it should expire (defaults to \*(L"1 month\*(R")
|
|
.IP "\fB\-S\fR, \fB\-\-list\-services\fR" 4
|
|
.IX Item "-S, --list-services"
|
|
list supported pastebin services
|
|
.IP "\fB\-L\fR, \fB\-\-list\-languages\fR" 4
|
|
.IX Item "-L, --list-languages"
|
|
list languages supported by the specified service
|
|
.IP "\fB\-E\fR, \fB\-\-list\-expiration\fR" 4
|
|
.IX Item "-E, --list-expiration"
|
|
list expiration setting supported by the specified service
|
|
.IP "\fB\-u\fR, \fB\-\-tinyurl\fR \fIurl\fR" 4
|
|
.IX Item "-u, --tinyurl url"
|
|
convert input url to tinyurl
|
|
.IP "\fB\-c\fR, \fB\-\-command\fR \fIcommand\fR" 4
|
|
.IX Item "-c, --command command"
|
|
paste \s-1COMMAND\s0 and the output of \s-1COMMAND\s0
|
|
.IP "\fB\-i\fR, \fB\-\-info\fR" 4
|
|
.IX Item "-i, --info"
|
|
append the output of `wgetpaste_info`
|
|
.IP "\fB\-I\fR, \fB\-\-info\-only\fR" 4
|
|
.IX Item "-I, --info-only"
|
|
paste the output of `wgetpaste_info` only
|
|
.IP "\fB\-x\fR, \fB\-\-xcut\fR" 4
|
|
.IX Item "-x, --xcut"
|
|
read input from clipboard (requires \fBxclip\fR(1))
|
|
.IP "\fB\-X\fR, \fB\-\-xpaste\fR" 4
|
|
.IX Item "-X, --xpaste"
|
|
write resulting url to the X primary selection buffer (requires \fBxclip\fR(1))
|
|
.IP "\fB\-C\fR, \fB\-\-xclippaste\fR" 4
|
|
.IX Item "-C, --xclippaste"
|
|
write resulting url to the X clipboard selection buffer (requires \fBxclip\fR(1))
|
|
.IP "\fB\-N\fR, \fB\-\-no\-ansi\fR" 4
|
|
.IX Item "-N, --no-ansi"
|
|
strip \s-1ANSI\s0 codes such as colors before pasting (requires \fBansifilter\fR(1))
|
|
.IP "\fB\-r\fR, \fB\-\-raw\fR" 4
|
|
.IX Item "-r, --raw"
|
|
show url for the raw paste (no syntax highlighting or html)
|
|
.IP "\fB\-t\fR, \fB\-\-tee\fR" 4
|
|
.IX Item "-t, --tee"
|
|
use tee to show what is being pasted
|
|
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
|
|
.IX Item "-v, --verbose"
|
|
show wget stderr output if no url is received
|
|
.IP "\fB\-\-completions\fR" 4
|
|
.IX Item "--completions"
|
|
emit output suitable for shell completions (only affects \fB\-\-list\-*\fR)
|
|
.IP "\fB\-\-debug\fR" 4
|
|
.IX Item "--debug"
|
|
be *very* verbose (implies \fB\-v\fR)
|
|
.IP "\fB\-h\fR, \fB\-\-help\fR" 4
|
|
.IX Item "-h, --help"
|
|
show this help
|
|
.IP "\fB\-g\fR, \fB\-\-ignore\-configs\fR" 4
|
|
.IX Item "-g, --ignore-configs"
|
|
ignore /etc/wgetpaste.conf, ~/.wgetpaste.conf etc.
|
|
.IP "\fB\-\-version\fR" 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 (December
|
|
2023), the \fI0x0\fR, \fIdpaste\fR, \fIsprunge\fR, \fIbpaste\fR (default) services
|
|
are working, the \fIcodepad\fR and \fIix_io\fR services are not working,
|
|
and \fIgists\fR and \fIsnippets\fR are untested because they require user
|
|
account creation.
|
|
.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).
|