.\" Man page generated from reStructeredText.
.
.TH SURL 1 "2011-01-06" "0.7" "text processing"
.SH NAME
surl \- a URL shortening application, supports various sites
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.\" Created using rst2man (python-docutils)
.
.SH SYNOPSIS
.sp
surl [OPTION]
.sp
Modes: stdin or \-f (default: stdin)
.SH DESCRIPTION
.sp
surl is a command line application that can transform links and shorten them.
.sp
The idea is to input a huge amount of text and/or links.
.sp
The input can be in two modes:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
.
stdin (standard input or piped command, \fCdefault\fP)
.IP \(bu 2
.
read input from a text file (using the \-f option)
.UNINDENT
.UNINDENT
.UNINDENT
.SH OPTIONS
.INDENT 0.0
.TP
.B \-h,  \-\-help
.
This help message
.TP
.B \-v,  \-\-version
.
Prints version info
.TP
.BI \-c,  \-\-url \ <url>
.
URL to shorten
.TP
.BI \-a,  \-\-api\-key \ <key>
.
Use an API key
.TP
.BI \-f,  \-\-file \ <filename>
.
Read input from filename
.TP
.B \-i,  \-\-in\-place
.
Save changes to file directly (Requires: \-f)
.TP
.B \-l,  \-\-links\-only
.
Output only a list of links (old_url => shortened_url)
.TP
.BI \-o,  \-\-output \ <filename>
.
Output to file
.TP
.BI \-p,  \-\-password \ <password>
.
Your password
.TP
.B \-q,  \-\-quiet
.
Suppress any extra messages
.TP
.BI \-t,  \-\-title \ <title>
.
Title (short custom name/alias) for the url
.TP
.BI \-u,  \-\-username \ <username>
.
Your username
.TP
.BI \-s,  \-\-service \ <service>
.
The URL shortening service to use (Default: tinyurl.com)
.TP
.BI \-r,  \-\-script \ <path>
.
The surlscript to execute
.UNINDENT
.SH SUPPORTED SERVICES
.sp
surl supports a vast range of url shortening services.
.sp
You can view the full list by typing: \fCsurl \-\-help\fP
.SH EXAMPLES
.INDENT 0.0
.IP \(bu 2
.
\fCecho \(aqhttp://google.co.uk\(aq | surl \-a myapikey123 \-u example \-s bit.ly\fP
.IP \(bu 2
.
\fCecho \(aqhttp://www.google.com\(aq | surl \-s tr.im\fP
.IP \(bu 2
.
\fCsurl \-c http://www.google.com \-s tr.im\fP
.IP \(bu 2
.
\fCsurl \-f example.txt \-i \-s tr.im\fP
.UNINDENT
.SH BUGS
.sp
Should you find any bugs, report them at: \fIhttps://bugs.launchpad.net/surl\fP
.SH AUTHOR
Savvas Radevic <vicedar@gmail.com>,
Ahmed El-Mahdawy <aa.mahdawy.10@gmail.com>
.SH COPYRIGHT
Copyright © 2009-2011 Savvas Radevic <vicedar@gmail.com>,
Copyright © 2009-2010 Ahmed El-Mahdawy <aa.mahdawy.10@gmail.com>
.\" Generated by docutils manpage writer.
.\" 
.