WebShortcutUtil
===============

Perl module for reading and writing web shortcut files.
This module is part of the WebShortcutUtil suite.  For more details
see the main website at http://beckus.github.io/WebShortcutUtil/ .

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install



DEPLOYMENT TO CPAN

- Need to run these commands to set up environment (in Ubuntu):
  sudo apt-get install libperl-critic-perl libdevel-cover-perl
- Update version numbers in all pm files.
- Run unit tests: make test
- Get test coverage (this is not currently working?):
    cover -test
  Check coverage report:
    xdg-open cover_db/coverage.html
- Check man pages:
    make
    man blib/man3/WebShortcutUtil.3
    man blib/man3/WebShortcutUtil::Read.3
    man blib/man3/WebShortcutUtil::Write.3
- Try running code in documentation SYNOPSIS to make sure it works.
- Try installing (both in Linux and Windows):
    sudo make install
- Regenerate MANIFEST (if no files were added or removed this can be skipped):
    make manifest
  Scrub generated MANIFEST
- Tag the new version in github
- Go to github and download archive for the tag. (github only gives option
  to download zip?)
  Extract the archive.
  Rename the root folder from "WebShortcutUtil-Perl-version" to
  "WebShortcutUtil-version".
  Compress the root folder to "WebShortcutUtil-version.targ.gz".
- Login to the PAUSE website https://pause.perl.org/pause/.
  Upload the "WebShortcutUtil-version.targ.gz".



DEPENDENCIES

This module requires these other modules and libraries:

  Mac::PropertyList - Only required when reading/writing an Apple ".webloc" shortcut.

The "t/samples" folder contains samples from the following repository:
  http://github.com/beckus/WebShortcutSamples

I chose not to use a Git submodule for this - Github does not
include the submodule when creating the downloadable tar/zip file.
If the WebShortcutSamples repository is updated, the changes
need to be manually applied in the local folder.
Sample files that contain unicode (as well as special characters)
have been omitted from the MANIFEST file.  This prevents warnings
when building on a system with limited support for unicode.

COPYRIGHT AND LICENCE

Put the correct copyright and licence information here.

Copyright (C) 2013 by Andre Beckus

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