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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
<?xml version='1.0' encoding='ISO-8859-1'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY dhfirstname "<firstname>Stephane</firstname>">
<!ENTITY dhsurname "<surname>Graber</surname>">
<!-- Please adjust the date whenever revising the manpage. -->
<!ENTITY dhdate "<date>May 1, 2024</date>">
<!ENTITY dhsection "<manvolnum>1</manvolnum>">
<!ENTITY dhemail "<email>stgraber@ubuntu.com</email>">
<!ENTITY dhusername "Stephane Graber">
<!ENTITY dhucpackage "<refentrytitle>PASTEBINIT</refentrytitle>">
<!ENTITY dhpackage "pastebinit">
<!ENTITY debian "<productname>Debian</productname>">
<!ENTITY gnu "<acronym>GNU</acronym>">
<!ENTITY gpl "&gnu; <acronym>GPL</acronym>">
]>
<refentry>
<refentryinfo>
<address>
&dhemail;
</address>
<copyright>
<year>2007-2014</year>
<holder>&dhusername;</holder>
</copyright>
&dhdate;
</refentryinfo>
<refmeta>
<refmiscinfo class="source">&dhpackage;</refmiscinfo>
<refmiscinfo class="manual">User Commands</refmiscinfo>
&dhucpackage;
&dhsection;
</refmeta>
<refnamediv>
<refname>&dhpackage;</refname>
<refpurpose>command-line pastebin client</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>&dhpackage;</command>
<arg rep="repeat"><emphasis>OPTION</emphasis></arg>
<arg rep="repeat"><emphasis>FILE</emphasis></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
<para>This manual page documents briefly the
<command>&dhpackage;</command> commands.</para>
<para><command>&dhpackage;</command> reads text and sends it to a
"pastebin" on the internet, returning the URL to the user.</para>
<para>It allows the text to be passed through a pipe (|) or from
files as arguments.</para>
</refsect1>
<refsect1>
<title>OPTIONS</title>
<refsect2>
<title>General arguments</title>
<variablelist>
<varlistentry>
<term><option>-b <arg>pastebin</arg></option>
(default is distro-specific with a fallback to bpa.st)</term>
</varlistentry>
<varlistentry>
<term><option>-i <arg>input file</arg></option></term>
</varlistentry>
<varlistentry>
<term><option>-l</option> List all supported pastebins</term>
</varlistentry>
<varlistentry>
<term><option>-E</option> Print the content to stdout too</term>
</varlistentry>
<varlistentry>
<term><option>-h</option> Print the help screen</term>
</varlistentry>
<varlistentry>
<term><option>-v</option> Print the version number</term>
</varlistentry>
<varlistentry>
<term><option>-V</option> Print verbose output to stderr</term>
</varlistentry>
</variablelist>
</refsect2>
<refsect2>
<title>Optional arguments (not supported by all pastebins)</title>
<variablelist>
<varlistentry>
<term><option>-a <arg>author</arg></option> (default: $USER)</term>
</varlistentry>
<varlistentry>
<term><option>-t <arg>title of paste</arg></option> (default: none)</term>
</varlistentry>
<varlistentry>
<term><option>-f <arg>format of paste</arg></option> (default: text)</term>
</varlistentry>
<varlistentry>
<term><option>-P <arg>private level</arg></option> (default: 1)</term>
</varlistentry>
<varlistentry>
<term><option>-e <arg>expiry of paste</arg></option> (default: none)</term>
</varlistentry>
<varlistentry>
<term><option>-u <arg>username</arg></option> (default: none)</term>
</varlistentry>
<varlistentry>
<term><option>-p <arg>password</arg></option> (default: none)</term>
</varlistentry>
</variablelist>
</refsect2>
</refsect1>
<refsect1>
<title>CONFIGURATION FILES</title>
<para>If a <emphasis>~/.pastebinit.xml</emphasis> file is found in the
user's home directory, <command>&dhpackage;</command> will use it for
its configuration.</para>
<para>Here's an example file:</para>
<programlisting language="xml">
<pastebinit>
<pastebin>paste.ubuntu.com</pastebin>
<author>Stephane Graber</author>
<format>text</format>
<private>1</private>
<expiry></expiry>
</pastebinit>
</programlisting>
<para>Similarly, pastebin configuration files can be put under a
<emphasis>~/.pastebin.d</emphasis> directory to override the specific
options of those.</para>
<para>XDG config and data locations are also supported for these two.</para>
</refsect1>
<refsect1>
<title>AUTHORS</title>
<para><command>&dhpackage;</command> is currently written by &dhfirstname; &dhsurname;.</para>
<para>username, password, format, title, arguments and redirect
support added by Daniel Bartlett.</para>
<para>Website: https://launchpad.net/pastebinit</para>
<para>E-mail: stgraber@ubuntu.com</para>
</refsect1>
</refentry>
|
