          &dhemail;

2007-2014 &dhusername;
&dhdate;
&dhpackage; User Commands &dhucpackage; &dhsection;
&dhpackage; command-line pastebin client
`&dhpackage;` OPTION FILE

## DESCRIPTION

This manual page documents briefly the `&dhpackage;` commands.

`&dhpackage;` reads text and sends it to a "pastebin" on the internet, returning the URL to the user.

It allows the text to be passed through a pipe (|) or from files as arguments.

## OPTIONS

### General arguments

`-b pastebin` (default is distro-specific with a fallback to bpa.st)
`-i input file`
`-l` List all supported pastebins
`-E` Print the content to stdout too
`-h` Print the help screen
`-v` Print the version number
`-V` Print verbose output to stderr

### Optional arguments (not supported by all pastebins)

`-a author` (default: $USER)
`-t title of paste` (default: none)
`-f format of paste` (default: text)
`-P private level` (default: 1)
`-e expiry of paste` (default: none)
`-u username` (default: none)
`-p password` (default: none)

## CONFIGURATION FILES

If a ~/.pastebinit.xml file is found in the user's home directory, `&dhpackage;` will use it for its configuration.

Here's an example file:

    <pastebinit>
        <pastebin>paste.ubuntu.com</pastebin>
        <author>Stephane Graber</author>
        <format>text</format>
        <private>1</private>
        <expiry></expiry>
    </pastebinit>

Similarly, pastebin configuration files can be put under a ~/.pastebin.d directory to override the specific options of those.

XDG config and data locations are also supported for these two.

## AUTHORS

`&dhpackage;` is currently written by &dhfirstname; &dhsurname;.

username, password, format, title, arguments and redirect support added by Daniel Bartlett.

Website: https://launchpad.net/pastebinit

E-mail: stgraber@ubuntu.com