diff --git a/wgetpaste.1 b/wgetpaste.1 new file mode 100644 index 0000000..1206ce0 --- /dev/null +++ b/wgetpaste.1 @@ -0,0 +1,100 @@ +.TH WGETPASTE, "1" "November 2021" "wgetpaste, version 2.30" "User Commands" +.SH NAME +wgetpaste \- paste content to pastebin services from commandline +.SH SYNOPSIS +.B wgetpaste +[\fI\,options\/\fR] [\fI\,file\/\fR[\fI\,s\/\fR]] +.br +.B wgetpaste +[\fI\,options\/\fR] \fI\,-c COMMAND +.SH DESCRIPTION +wgetpaste automates pasting to a number of pastebin services and returns the URL. + +.B Important: +Don't paste sensitive or private data, most services create public links. + +.SH OPTIONS +.TP +\fB\-l\fR, \fB\-\-language\fR LANG +set language (defaults to "Plain Text") +.HP +\fB\-d\fR, \fB\-\-description\fR DESCRIPTION set description (defaults to "stdin" or filename) +.TP +\fB\-n\fR, \fB\-\-nick\fR NICK +set nick (defaults to your username) +.TP +\fB\-s\fR, \fB\-\-service\fR SERVICE +set service to use (defaults to "dpaste") +.TP +\fB\-e\fR, \fB\-\-expiration\fR EXPIRATION +set when it should expire (defaults to "1") +.TP +\fB\-S\fR, \fB\-\-list\-services\fR +list supported pastebin services +.TP +\fB\-L\fR, \fB\-\-list\-languages\fR +list languages supported by the specified service +.TP +\fB\-E\fR, \fB\-\-list\-expiration\fR +list expiration setting supported by the specified service +.TP +\fB\-u\fR, \fB\-\-tinyurl\fR URL +convert input url to tinyurl +.TP +\fB\-c\fR, \fB\-\-command\fR COMMAND +paste COMMAND and the output of COMMAND +.TP +\fB\-i\fR, \fB\-\-info\fR +append the output of `emerge \fB\-\-info\fR` +.TP +\fB\-I\fR, \fB\-\-info\-only\fR +paste the output of `emerge \fB\-\-info\fR` only +.TP +\fB\-x\fR, \fB\-\-xcut\fR +read input from clipboard (requires x11\-misc/xclip) +.TP +\fB\-X\fR, \fB\-\-xpaste\fR +write resulting url to the X primary selection buffer (requires x11\-misc/xclip) +.TP +\fB\-C\fR, \fB\-\-xclippaste\fR +write resulting url to the X clipboard selection buffer (requires x11\-misc/xclip) +.TP +\fB\-r\fR, \fB\-\-raw\fR +show url for the raw paste (no syntax highlighting or html) +.TP +\fB\-t\fR, \fB\-\-tee\fR +use tee to show what is being pasted +.TP +\fB\-v\fR, \fB\-\-verbose\fR +show wget stderr output if no url is received +.TP +\fB\-\-completions\fR +emit output suitable for shell completions (only affects \fB\-\-list\-\fR*) +.TP +\fB\-\-debug\fR +be *very* verbose (implies \fB\-v\fR) +.TP +\fB\-h\fR, \fB\-\-help\fR +show this help +.TP +\fB\-g\fR, \fB\-\-ignore\-configs\fR +ignore ""/etc/wgetpaste.conf, ~/.wgetpaste.conf etc. +.TP +\fB\-\-version\fR +show version information +.PP +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. +.PP +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...", or with gitlab snippets: +HEADER_snippets="PRIVATE\-TOKEN: 1234abc56789..." +.PP +You can also set PUBLIC_gists='false' if you want to default to secret instead of +public github gists. In the case of gitlab, you can set VISIBILITY_snippets= to +\&'public', 'private' or 'internal'" +.PP +To change your gitlab server, you can override the default API URL setting +URL_snippets='https://gitlab.[server].com/api/v4/snippets'