summaryrefslogtreecommitdiff
path: root/accessibility/wgetpaste/wgetpaste.pod
blob: ae98dbd4872a9e628b16a99b3b338be87b2f252c (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
# pod source for wgetpaste man page. Convert with:
# pod2man --stderr -s1 -cSlackBuilds.org -r2.25 -u wgetpaste.pod > wgetpaste.1

=pod

=encoding utf8

=head1 NAME

wgetpaste - Command-line interface to various pastebin sites

=head1 SYNOPSIS

wgetpaste [options] [file[s]]

=head1 OPTIONS

=over 4

=item -l, --language LANG

set language (defaults to "Plain Text")

=item -d, --description DESCRIPTION

set description (defaults to "stdin" or filename)

=item -n, --nick NICK

set nick (defaults to your username)

=item -s, --service SERVICE

set service to use (defaults to "dpaste")

=item -e, --expiration EXPIRATION

set when it should expire (defaults to "1 month")

=item -S, --list-services

list supported pastebin services

=item -L, --list-languages

list languages supported by the specified service

=item -E, --list-expiration

list expiration setting supported by the specified service

=item -u, --tinyurl URL

convert input url to tinyurl

=item -c, --command COMMAND

paste COMMAND and the output of COMMAND

=item -i, --info

append the output of `wgetpaste_info`

=item -I, --info-only

paste the output of `wgetpaste_info` only

=item -x, --xcut

read input from clipboard (requires xclip)

=item -X, --xpaste

write resulting url to the X primary selection buffer (requires xclip)

=item -C, --xclippaste

write resulting url to the X clipboard selection buffer (requires xclip)

=item -r, --raw

show url for the raw paste (no syntax highlighting or html)

=item -t, --tee

use tee to show what is being pasted

=item -v, --verbose

show wget stderr output if no url is received

=item --completions

emit output suitable for shell completions (only affects --list-*)

=item --debug

be *very* verbose (implies -v)

=item -h, --help

show this help

=item -g, --ignore-configs

ignore /etc/wgetpaste.conf, ~/.wgetpaste.conf etc.

=item --version

show version information

=back

Defaults (DEFAULT_{NICK,LANGUAGE,EXPIRATION}[_${SERVICE}] and DEFAULT_SERVICE)
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_${SERVICE} in any of the
configuration files mentioned above. For example, authenticating with github gist:
HEADER_gists="Authorization: token 1234abc56789..."

=head1 BUGS

B<wgetpaste> works by hard-coding URLs and CGI parameters into
the script. This means that if a paste service's web site changes,
B<wgetpaste> might stop working with that site. Currently (January 2015),
the B<ca> (http://pastebin.ca) and B<bpaste> (http://bpaste.net) services
are broken, and the others have been tested and work OK.

=head1 AUTHOR

Copyright (c) 2007 Bo Ørsted Andresen <bo.andresen@zlin.dk>

Distributed as-is. With no warranties.

Man page created by B. Watson <urchlay@slackware.uk>, for the SlackBuilds.org project (but
it may be used by anyone).