path: root/accessibility/wgetpaste/wgetpaste.1
diff options
Diffstat (limited to 'accessibility/wgetpaste/wgetpaste.1')
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" ""
+.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
+.\" Standard preamble:
+.\" ======================================================================== Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+.. Vb \" Begin verbatim text
+.ft CW \\$1
+.. Ve \" End verbatim text
+.ft R
+.\" 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<>. \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' 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' ""
+. ds -- \|\(em\|
+. ds PI \(*p
+. ds L" ``
+. ds R" ''
+. ds C`
+. ds C'
+.\" Escape single quotes in literal strings from groff's Unicode transform. \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'. IX
+.. 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" ""
+.\" For nroff, turn off justification. Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
wgetpaste \- Command\-line interface to various pastebin sites
-.B wgetpaste
-[\fIoptions\fR] [\fIfile\fR[\fIs\fR]]
-\fB\-l\fR, \fB\-\-language\fR LANG
-set language (defaults to "Plain Text")
-\fB\-d\fR, \fB\-\-description\fR DESCRIPTION set description (defaults to "stdin" or filename)
-\fB\-n\fR, \fB\-\-nick\fR NICK
+.IX Header "SYNOPSIS"
+wgetpaste [options] [file[s]]
+.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)
-\fB\-s\fR, \fB\-\-service\fR SERVICE
-set service to use (defaults to "bpaste")
-\fB\-e\fR, \fB\-\-expiration\fR EXPIRATION
-set when it should expire (defaults to "30 days")
-\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
-\fB\-L\fR, \fB\-\-list\-languages\fR
+.IP "\-L, \-\-list\-languages" 4
+.IX Item "-L, --list-languages"
list languages supported by the specified service
-\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
-\fB\-u\fR, \fB\-\-tinyurl\fR URL
+.IP "\-u, \-\-tinyurl \s-1URL\s0" 4
+.IX Item "-u, --tinyurl URL"
convert input url to tinyurl
-\fB\-c\fR, \fB\-\-command\fR COMMAND
-paste COMMAND and the output of COMMAND
-\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`
-\fB\-I\fR, \fB\-\-info\-only\fR
+.IP "\-I, \-\-info\-only" 4
+.IX Item "-I, --info-only"
paste the output of `wgetpaste_info` only
-\fB\-x\fR, \fB\-\-xcut\fR
+.IP "\-x, \-\-xcut" 4
+.IX Item "-x, --xcut"
read input from clipboard (requires xclip)
-\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)
-\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)
-\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)
-\fB\-t\fR, \fB\-\-tee\fR
+.IP "\-t, \-\-tee" 4
+.IX Item "-t, --tee"
use tee to show what is being pasted
-\fB\-v\fR, \fB\-\-verbose\fR
+.IP "\-v, \-\-verbose" 4
+.IX Item "-v, --verbose"
show wget stderr output if no url is received
-emit output suitable for shell completions (only affects \fB\-\-list\-\fR*)
-be *very* verbose (implies \fB\-v\fR)
-\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
-\fB\-g\fR, \fB\-\-ignore\-configs\fR
+.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
-globally in /etc/wgetpaste.conf or /etc/wgetpaste.d/*.conf or per user in any of
-~/.wgetpaste.conf or ~/.wgetpaste.d/*.conf.
+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.
+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"
+.IX Header "AUTHOR"
Copyright (c) 2007 Bo ├śrsted Andresen <>
Distributed as-is. With no warranties.
Man page created by B. Watson <>, for the project (but