shorten(1)

1SHORTEN(1)            User Contributed Perl Documentation           SHORTEN(1)
2
3
4

NAME

6       shorten - CLI program to demonstrate use of WWW::Shorten
7

SYNOPSIS

9           # Default shortening service is Metamark
10           $ shorten books.perl.org/book/171
11           http://xrl.us/dv8
12
13           # Change with an environment variable
14           $ SHORTEN_SERVICE=TinyURL shorten books.perl.org/book/171
15           http://tinyurl.com/ye7gjf4
16
17           # Change with command line option
18           $ shorten --service=TinyURL books.perl.org/book/171
19           http://tinyurl.com/ye7gjf4
20
21           # Change using config file
22           $ cat ~/.shortenrc
23           service = TinyURL
24           $ shorten books.perl.org/book/171
25           http://tinyurl.com/ye7gjf4
26
27           # Lengthen a URL
28           $ shorten -l http://tinyurl.com/ye7gjf4
29

CONFIGURATION

31       The service used can be controlled in various ways. The program will
32       use the first of the following values that it finds:
33
34       ·   The value of the "--service" command line option.
35
36       ·   The value of the "SHORTEN_SERVICE" environment variable.
37
38       ·   The value of the "service" option from the configuration file (see
39           below).
40
41       ·   If none of the above options is found, the program defaults to
42           using Metamark.
43

CONFIGURATION FILE

45       As we use the "Config::Auto" module for configuration, shorten's fairly
46       flexible when it comes to format.
47
48       Configuration will be found in whichever of the following files comes
49       first.
50
51           shortenconfig
52           ~/shortenconfig
53           /etc/shortenconfig
54           shorten.config
55           ~/shorten.config
56           /etc/shorten.config
57           shortenrc
58           ~/shortenrc
59           /etc/shortenrc
60           .shortenrc
61           ~/.shortenrc
62           /etc/.shortenrc
63
64       Generally, I use the format:
65
66           service = MakeAShorterLink
67
68       which is simple and works. "service" is the only configuration keyword
69       at present. Its value should be a correctly capitalized service name as
70       per WWW::Shorten's documentation.
71

LICENSE AND COPYRIGHT

73       Copyright 2002 - 2010, Magnum Solutions Ltd. All rights reserved.
74
75       This library is free software; you can redistribute it and/or modify it
76       under the same terms as Perl itself.
77

AUTHOR

79       Iain Truskett <spoon@cpan.org>
80

CONTRIBUTORS

82       ·   Chase Whitener "capoeirab@cpan.org"
83
84       ·   Dave Cross <davecross@cpan.org>
85