summaryrefslogtreecommitdiffstats
path: root/fb.pod
diff options
context:
space:
mode:
authorFlorian Pritz <bluewind@xssn.at>2010-10-23 22:21:03 +0200
committerFlorian Pritz <bluewind@xssn.at>2010-10-23 22:21:03 +0200
commitb05f4cd4197beefdc059a071b9207b2b61a77888 (patch)
tree6bba830860ca1f83bbee82598ebb6280d5b84445 /fb.pod
parent3150df7b02f54a6d184e5e3422f82ff20a3facbb (diff)
add documentation
Signed-off-by: Florian Pritz <bluewind@xssn.at>
Diffstat (limited to 'fb.pod')
-rw-r--r--fb.pod68
1 files changed, 68 insertions, 0 deletions
diff --git a/fb.pod b/fb.pod
new file mode 100644
index 0000000..c5203df
--- /dev/null
+++ b/fb.pod
@@ -0,0 +1,68 @@
+=head1 NAME
+
+C<fb> - a client for http://paste.xinu.at
+
+=head1 SYNOPSIS
+
+fb [switches] [options] [<file(s)|ID(s)|folder(s)>]
+
+=head1 DESCRIPTION
+
+C<fb> is a client to http://paste.xinu.at which allows the user to easily upload,
+delete or download files.
+
+By default, files will be uploaded as-is and a link to the file will be printed
+to stdout after each upload. At the end C<fb> will try to copy all links into the
+X clipboard if xclip is installed.
+
+Folders will be tar'ed and the resulting upload.tar file will be uploaded.
+
+If no arguments are given, C<fb> will read data from stdin into a temporary file
+which will be uploaded once EOF is received.
+
+If the file being uploaded is bigger than 10MB C<fb> will query the server for the
+maximum upload size and abort the upload in case the file would be rejected.
+
+=head1 SWITCHES
+
+-d
+ Delete the IDs. You can no longer upload files in this mode.
+
+-g
+ Download the IDs and output on stdout. Please take care when using this,
+ as binary data can cause unexpected results when being output directly
+ to a terminal. You can no longer upload files in this mode.
+
+-t
+ Upload a tar file containing all files and directories specified on the
+ command line.
+
+-h
+ Display a short help message.
+
+
+=head1 OPTIONS
+
+-e <extension>
+ Change the extension used for highlighting. You can also do this if you
+ have already uploaded the file by appending the extension to the URL.
+ http://paste.xinu.at/<ID>/bash will change the syntax highlighting to bash.
+
+-c
+ Enable compression of the uploaded files. This affects all files including
+ piped content and folders.
+
+ Specify this option once to use gzip or two times to use xz.
+
+=head1 EXAMPLES
+
+fb -tc <folder> <file>
+ This will create a .tar archive containing the folder and the file and compress
+ it using gzip and upload one archive.
+
+fb -c <folder> <file>
+ This will create a .tar archive of the folder only, compress both using gzip, the archive
+ and the file and upload both independently.
+
+fb -cc <folder>
+ This will create a .tar archive containing only the folder and compress it using xz.