slackbuilds_ponce/accessibility/wgetpaste/wgetpaste.1
B. Watson 8aa9f6dac2
accessibility/wgetpaste: Updated for version 2.33.
Signed-off-by: B. Watson <urchlay@slackware.uk>
2023-12-30 07:33:39 +07:00

182 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).