kindleclip(1) [debian man page]

kindleclip(1)						      General Commands Manual						     kindleclip(1)

NAME

       kindleclip - User interface for managing Amazon Kindle's My Clippings.txt file

SYNOPSIS

       kindleclip [clippings_file]

DESCRIPTION

       Amazon  Kindle  devices	store  a My Clippings.txt file, where the bookmarks, highlights and notes are kept. This application allows you to
       search within the clippings, filter the contents, and copy and paste to other applications.  This program is in no way  endorsed,  promoted
       or should be associated with Amazon. It is not -and does not aim to be- an official Kindle project.

OPTIONS

       kindleclip  accepts  as	its only argument the path to the My Clippings.txt file to use; if none is provided, it will try to open it in the
       current directory, and exit with an error message if it does not exist.

AUTHOR

       This program was written by Gunnar Wolf <gwolf@gwolf.org>.

								    09 Aug 2011 						     kindleclip(1)

Amazon::SQS::Simple(3pm)				User Contributed Perl Documentation				  Amazon::SQS::Simple(3pm)

NAME

       Amazon::SQS::Simple - OO API for accessing the Amazon Simple Queue Service

SYNOPSIS

	   use Amazon::SQS::Simple;

	   my $access_key = 'foo'; # Your AWS Access Key ID
	   my $secret_key = 'bar'; # Your AWS Secret Key

	   # Create an SQS object
	   my $sqs = new Amazon::SQS::Simple($access_key, $secret_key);

	   # Create a new queue
	   my $q = $sqs->CreateQueue('queue_name');

	   # Send a message
	   $q->SendMessage('Hello world!');

	   # Retrieve a message
	   my $msg = $q->ReceiveMessage();
	   print $msg->MessageBody() # Hello world!

	   # Delete the message
	   $q->DeleteMessage($msg->ReceiptHandle());

	   # Delete the queue
	   $q->Delete();

INTRODUCTION

       Amazon::SQS::Simple is an OO API for the Amazon Simple Queue Service.

IMPORTANT

       This version of Amazon::SQS::Simple defaults to work against version 2009-02-01 of the SQS API.

       Earlier API versions may or may not work.

CONSTRUCTOR

       new($access_key, $secret_key, [%opts])
	 Constructs a new Amazon::SQS::Simple object

	 $access_key is your Amazon Web Services access key. $secret_key is your Amazon Web Services secret key. If you don't have either of these
	 credentials, visit <http://aws.amazon.com/>.

	 Options for new:

	 Timeout => SECONDS
	     Set the HTTP user agent's timeout (default is 180 seconds)

	 Version => VERSION_STRING
	     Specifies the SQS API version you wish to use. E.g.:

	      my $sqs = new Amazon::SQS::Simple($access_key, $secret_key, Version => '2008-01-01');

METHODS

       GetQueue($queue_endpoint)
	 Gets the queue with the given endpoint. Returns a "Amazon::SQS::Simple::Queue" object. (See Amazon::SQS::Simple::Queue for details.)

       CreateQueue($queue_name, [%opts])
	 Creates a new queue with the given name. Returns a "Amazon::SQS::Simple::Queue" object. (See Amazon::SQS::Simple::Queue for details.)

	 Options for CreateQueue:

	 DefaultVisibilityTimeout => SECONDS
	     Set the default visibility timeout for this queue

       ListQueues([%opts])
	 Gets a list of all your current queues. Returns an array of "Amazon::SQS::Simple::Queue" objects. (See Amazon::SQS::Simple::Queue for
	 details.)

	 Options for ListQueues:

	 QueueNamePrefix => STRING
	     Only those queues whose name begins with the specified string are returned.

FUNCTIONS

       No functions are exported by default; if you want to use them, export them in your use line:

	   use Amazon::SQS::Simple qw( timestamp );

       timestamp($seconds)
	 Takes a time in seconds since the epoch and returns a formatted timestamp suitable for using in a Timestamp or Expires optional method
	 parameter.

STANDARD OPTIONS

       The following options can be supplied with any of the listed methods.

       AWSAccessKeyId => STRING
	 The AWS Access Key Id to use with the method call. If not provided, Amazon::SQS::Simple uses the value passed to the constructor.

       SecretKey => STRING
	 The Secret Key to use with the method call. If not provided, Amazon::SQS::Simple uses the value passed to the constructor.

       Timestamp => TIMESTAMP
	 All methods are automatically given a timestamp of the time at which they are called, but you can override this value if you need to. The
	 value for this key should be a timestamp as returned by the Amazon::SQS::Simple::timestamp() function.

	 You generally do not need to supply this option.

       Expires => TIMESTAMP
	 All methods are automatically given a timestamp of the time at which they are called.	You can alternatively set an expiry time by
	 providing an Expires option. The value for this key should be a timestamp as returned by the "Amazon::SQS::Simple::timestamp()" function.

	 You generally do not need to supply this option.

ACKNOWLEDGEMENTS

       Bill Alford wrote the code to support basic functionality of older API versions in release 0.9.

AUTHOR

       Copyright 2007-2008 Simon Whitaker <swhitaker@cpan.org>

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.10.1							    2010-03-31						  Amazon::SQS::Simple(3pm)