improve docs

bin/gist

@@ -7,23 +7,26 @@ use App::gist;
 
 =head1 NAME
 
-gist - GitHub Gist creator
+gist - Gist command-line tool
 
 =cut
 
 =head1 SYNOPSIS
 
  gist [OPTIONS] FILE
 
- Options:
-   --description, -d  DESCRIPTION
-   --update, -u       GIST_ID
-   --private, -p
-   --web, -w
+=over
+
+=item Create a new gist from a file
 
- Examples:
    $ gist script.pl
-   $ cat script | gist
+
+=item Create a new gist from a pipe with a description
+
+   $ cat script | gist -d 'some script'
+
+=item Create a new gist and copy the web URL in the clipboard
+
    $ echo "something" | gist -w | xclip
    $ echo "something" | gist -w | pbcopy # on Mac OS X
 

lib/App/gist.pm

@@ -11,16 +11,11 @@ use Class::Load qw(try_load_class);
 
 =head1 NAME
 
-App::gist - Command-line GitHub's gist client
+App::gist - Gist command-line tool
 
 =head1 SYNOPSIS
 
-    use App::gist;
-
-    use strict;
-    use warnings;
-
-    App::gist -> run;
+   $ gist script.pl
 
 =cut