Feature: trash-rm

TODO:
   
 - man pages:
    - add test for checking man page installation
    - add DONATION to all pages
    - make all BUGS to point to github
    - unificate "SEE ALSO" for all man pages
    - add a test for trash-put and method 1 trashdir
    - duplication:
       - remove duplication (man page example and actual behaviour)
       - remove duplication about BUGS in man page 

 - setup.py:
    - test is a setuptools keyword, it does not work with distutils
    - 'data_files' is a distutils keyword, it does not work with setuptools

Features backlog:
 - trash-list should handle .trashinfo from home trashdir that contains 
   relative path
 - trash-list should print also the orphan files
 - support alias rmdir=trash-put
 - don't use world writable trash
 - enable trash-put home fallback
 - trash-empty removes files until a certain amount of space has been restored
 - trash-list --raw
 - trash-list <directory-name>
 - trash-list -R <directory-name>                 # recursive
 - trash-restore <path>                           # restore the newest
 - trash-restore <path> <dest>                    # restore to a certain destination
 - trash-restore --trashed-on="Apr 15, 08" <path>
 - trash-restore --version
 - trash-empty --from=/.Trash
 - trash-rm '*.o'
 - trash-empty should empty even the mac trash directory
 - TRASH_DATE=2012-09-12 trash-put <file>

Test to be ported to nosetests:
 - trash-put:
    - trash in home trashcan
    - print version
    - trash in volume trashcan 1
    - trash in volume trashcan 2
 - it should trash to $topdir/.Trash-UID when $topdir/.Trash is not suitable
    - when $topdir/.Trash does not exists 
    - when $topdir/.Trash is a symlink
    - when $topdir/.Trash is not sticky
 - should refuse to create the $topdir/.Trash/$uid directory if the 
   $topdir/.Trash is not sticky

