summaryrefslogtreecommitdiff
path: root/accessibility/wgetpaste/wgetpaste.pod
blob: d716d8bd38adbdf2f2dfc49eb325b77ea03954ba (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
# 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 "bpaste")

=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 AUTHOR

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

Distributed as-is. With no warranties.

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