add changes, improve docu, bump version number

CHANGES

@@ -0,0 +1,4 @@
+1.01    Better (and more accurate) documentation.
+        Tests to ensure non-existent variables return the empty string
+
+1.00    Initial release

MANIFEST

@@ -1,3 +1,4 @@
+CHANGES
 inc/Module/Install.pm
 inc/Module/Install/AuthorTests.pm
 inc/Module/Install/Base.pm

META.yml

@@ -24,5 +24,10 @@ requires:
   Test::More: 0
   perl: 5.6.0
 resources:
+  homepage: https://github.com/2shortplanks/Mac-KeyboardMaestro/tree
   license: http://dev.perl.org/licenses/
-version: 1.00
+  repository:
+    type: git
+    url: git://github.com/2shortplanks/Mac-KeyboardMaestro.git
+    web: https://github.com/2shortplanks/Mac-KeyboardMaestro/tree
+version: 1.01

README

@@ -26,22 +26,25 @@ DESCRIPTION
 
   Functions
     These functions can be imported, or you can use them fully qualified.
+    All functions throw exceptions if the AppleScript interface to Keyboard
+    Maestro returns an error.
 
     km_macro $macro_name
     km_macro $macro_uuid
-        Execute the named macro / macro with the passed uuid. Returns
-        nothing. Throws and exception if there's a problem.
+        Execute the named macro / macro with the passed uuid. Returns an
+        empty list.
 
     km_set $varname, $value
         Sets the value of the corrisponding Keyboard Macro variable. $value
-        will be automatically stringified.
+        will be automatically stringified. Returns an empty list.
 
     km_get $varname
         Gets the current value of the corrisponding Keyboard Macro variable.
-        Returns "undef" if no such variable exists.
+        Returns the empty string if the variable does not exist.
 
     km_delete $varname
-        Deletes the corrisponding Keyboard Macro variable
+        Deletes the corrisponding Keyboard Macro variable. Returns an empty
+        list.
 
 AUTHOR
     Written by Mark Fowler <mark@twoshortplanks.com>
@@ -53,8 +56,8 @@ COPYRIGHT
     under the same terms as Perl itself.
 
     Keyboard Maestro itself is copyright Stairways Software Pty Ltd. Neither
-    Mark Fowler nor this Perl library is not associated with Keyboard
-    Maestro or Stairways Software Pty Ltd.
+    Mark Fowler nor this Perl library is associated with Keyboard Maestro or
+    Stairways Software Pty Ltd.
 
 BUGS
     Bugs should be reported via this distribution's CPAN RT queue. This can

lib/Mac/KeyboardMaestro.pm

@@ -13,7 +13,7 @@ our @EXPORT_OK;
 use Mac::AppleScript qw(RunAppleScript);
 use Carp qw(croak);
 
-our $VERSION = "1.00";
+our $VERSION = "1.01";
 
 =head1 NAME
 
@@ -46,16 +46,17 @@ values as AppleScript by mistake.
 
 =head2 Functions
 
-These functions can be imported, or you can use them fully qualified.
+These functions can be imported, or you can use them fully qualified.  All
+functions throw exceptions if the AppleScript interface to Keyboard Maestro
+returns an error.
 
 =over
 
 =item km_macro $macro_name
 
 =item km_macro $macro_uuid
 
-Execute the named macro / macro with the passed uuid.  Returns nothing.  Throws
-and exception if there's a problem.
+Execute the named macro / macro with the passed uuid.  Returns an empty list.
 
 =cut
 
@@ -97,7 +98,7 @@ push @EXPORT_OK, 'km_macro';
 =item km_set $varname, $value
 
 Sets the value of the corrisponding Keyboard Macro variable.  C<$value> will
-be automatically stringified.
+be automatically stringified.  Returns an empty list.
 
 =cut
 
@@ -113,7 +114,7 @@ push @EXPORT_OK, 'km_set';
 =item km_get $varname
 
 Gets the current value of the corrisponding Keyboard Macro variable.  Returns
-C<undef> if no such variable exists.
+the empty string if the variable does not exist.
 
 =cut
 
@@ -127,7 +128,7 @@ push @EXPORT_OK, 'km_get';
 
 =item km_delete $varname
 
-Deletes the corrisponding Keyboard Macro variable
+Deletes the corrisponding Keyboard Macro variable.  Returns an empty list.
 
 =cut
 
@@ -153,7 +154,7 @@ This program is free software; you can redistribute it
 and/or modify it under the same terms as Perl itself.
 
 Keyboard Maestro itself is copyright Stairways Software Pty Ltd.  Neither Mark
-Fowler nor this Perl library is not associated with Keyboard Maestro or
+Fowler nor this Perl library is associated with Keyboard Maestro or
 Stairways Software Pty Ltd.
 
 =head1 BUGS

t/02vars.t

@@ -3,7 +3,7 @@
 use strict;
 use warnings;
 
-use Test::More tests => 2;
+use Test::More tests => 3;
 use Mac::KeyboardMaestro qw(km_set km_get km_delete);
 
 my $varname = "mackeyboardmaestrotestsuite";
@@ -13,3 +13,7 @@ km_set $varname => $unique;
 is km_get $varname, $unique, "variable was set";
 km_delete $varname;
 is km_get $varname, "", "variable is gone!";
+
+
+# check that a totally random variable returns the empty string
+is km_get "var".time.$$, "", "random var does not exist";