NAME

       pem - GNU personal expenses manager

SYNOPSIS

       pem [OPTIONS] [<description> <amount> ...]

DESCRIPTION

       GNU  Pem  is  a  handy  tool  to help you keep track of your personal income and expenses.
       Needless to say, using pem is extremely simple and easy.  A command of the following  form
       is all it takes

           $ pem "Bus ticket" 10.75
           $ pem -f myexpenses.txt Breakfast 20

       Pem  stores  these details in a CSV file, named after the current month, and placed in the
       `~/.pem' directory under your $HOME directory. You may specify some other file  using  the
       `-f'  option. Also, each amount is considered as an expenditure unless indicated otherwise
       by `-e'.

       Tags/Categories:
       ================

       From version 0.7.4, pem introduced support for tags & categories of records. You  can  tag
       an income and/or expense record as

           $ pem -c bills "Cell phone bill" 830.50
           $ pem -c 'travel fun leisure' "Trip to Goa" 4500

       These are saved with the tags 'bills' & 'travel fun leisure' respectively.  Later, you can
       see very  useful  reports  showing  your  category  wise  expense  traits.  Now  pem  also
       facilitates  filtering  of  records using tags and description. Note that, while filtering
       records, pem first looks into the tags and when they don't match, goes for the description
       field.  Ex. To see all your expenses on `travel', you can say

           $ pem -s travel
           $ pem -m travel

       While  the  first will list all your `travel' expenses in a month; The later will show the
       cumulative results for each month till date. Other than this, pem supports these following
       options

OPTIONS

       -b --bare
               show unformatted report

       -c --category <name>
               categorise/tag your expenses

       -e --earned
               indicates income

       -f --file <name>
               specify file name

       -s [n]
               show daily report with total after [n] days

       -m [n]
               show monthly report with total after [n] months

       -C
               show category/tag-wise report

       -t --total
              shows just the total when used it with -s

       -M <mm>
               select the start month (01 <= mm <= 12)

       -N <mm>
               select an end month (01 <= mm <= 12)

       -Y <yy>
               select an year (00 <= yy <= 99)

       -h --help
               show this help

       -v --version
              show version information

ENVIRONMENT

       PEMTIME
              Pem  recognizes  the  PEMTIME  environment  variable. PEMTIME defines the format in
              which you want the `Date & Time' to  be  displayed.  For  example,  if  you  export
              PEMTIME="%F",  the  date  "May  31  2007" will be displayed as 2007-05-31. For more
              information/options please see strftime(3).

REPORTING BUGS

       Report bugs to <pj.pandit@yahoo.co.in>

AUTHOR

       Written by Prasad J Pandit

       Initial category patch: John Westlund

                                                                                           pem(1)