'\" t
.\"     Title: PASTEBINIT
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: August 26, 2022
.\"    Manual: User Commands
.\"    Source: pastebinit
.\"  Language: English
.\"
.TH "PASTEBINIT" "1" "August 26, 2022" "pastebinit" "User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pastebinit \- command\-line pastebin client
.SH "SYNOPSIS"
.HP \w'\fBpastebinit\fR\ 'u
\fBpastebinit\fR [\fIOPTION\fR...] [\fIFILE\fR...]
.SH "DESCRIPTION"
.PP
This manual page documents briefly the
\fBpastebinit\fR
commands\&.
.PP
\fBpastebinit\fR
reads text and sends it to a "pastebin" on the internet, returning the URL to the user\&.
.PP
It allows the text to be passed through a pipe (|) or from files as arguments\&.
.SH "OPTIONS"
.SS "General arguments"
.PP
\fB\-b \fR\fB[pastebin]\fR (default is distro\-specific with a fallback to dpaste\&.com)
.RS 4
.RE
.PP
\fB\-i \fR\fB[input\ file]\fR
.RS 4
.RE
.PP
\fB\-l\fR List all supported pastebins
.RS 4
.RE
.PP
\fB\-E\fR Print the content to stdout too
.RS 4
.RE
.PP
\fB\-h\fR Print the help screen
.RS 4
.RE
.PP
\fB\-v\fR Print the version number
.RS 4
.RE
.PP
\fB\-V\fR Print verbose output to stderr
.RS 4
.RE
.SS "Optional arguments (not supported by all pastebins)"
.PP
\fB\-a \fR\fB[author]\fR (default: $USER)
.RS 4
.RE
.PP
\fB\-t \fR\fB[title\ of\ paste]\fR (default: none)
.RS 4
.RE
.PP
\fB\-f \fR\fB[format\ of\ paste]\fR (default: text)
.RS 4
.RE
.PP
\fB\-j \fR\fB[jabberid]\fR (default: none)
.RS 4
.RE
.PP
\fB\-m \fR\fB[permatag]\fR (default: none)
.RS 4
.RE
.PP
\fB\-P \fR\fB[private\ level]\fR (default: 1)
.RS 4
.RE
.PP
\fB\-u \fR\fB[username]\fR (default: none)
.RS 4
.RE
.PP
\fB\-p \fR\fB[password]\fR (default: none)
.RS 4
.RE
.SH "CONFIGURATION FILES"
.PP
If a
\fI~/\&.pastebinit\&.xml\fR
file is found in the user\*(Aqs home directory,
\fBpastebinit\fR
will use it for its configuration\&.
.PP
Here\*(Aqs an example file:
.sp
.if n \{\
.RS 4
.\}
.nf
<pastebinit>
    <pastebin>paste\&.ubuntu\&.com</pastebin>
    <author>Stephane Graber</author>
    <jabberid>stgraber@stgraber\&.org</jabberid>
    <format>text</format>
    <private>1</private>
</pastebinit>
    
.fi
.if n \{\
.RE
.\}
.PP
Similarly, pastebin configuration files can be put under a
\fI~/\&.pastebin\&.d\fR
directory to override the specific options of those\&.
.PP
XDG config and data locations are also supported for these two\&.
.SH "AUTHORS"
.PP
\fBpastebinit\fR
is currently written by
Stephane
Graber\&.
.PP
username, password, format, title, arguments and redirect support added by Daniel Bartlett\&.
.PP
Website: https://launchpad\&.net/pastebinit
.PP
E\-mail: stgraber@ubuntu\&.com
.SH "COPYRIGHT"
.br
Copyright \(co 2007-2014 Stephane Graber
.br