summaryrefslogtreecommitdiff
path: root/accessibility/wgetpaste/wgetpaste.1
blob: d232592d17d1ef8441878b53aa1dd007f34fdc4b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
.\" 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).