Create wgetpaste.1

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'