1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20pem(1)                      General Commands Manual                     pem(1)
21
22
23

NAME

25       pem - GNU personal expenses manager
26

SYNOPSIS

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

DESCRIPTION

31       GNU  Pem is a handy tool to help you keep track of your personal income
32       and expenses. Needless to say, using pem is extremely simple and  easy.
33       A command of the following form is all it takes
34
35           $ pem "Bus ticket" 10.75
36           $ pem -f myexpenses.txt Breakfast 20
37
38       Pem  stores these details in a CSV file, named after the current month,
39       and placed in the `~/.pem' directory under your  $HOME  directory.  You
40       may specify some other file using the `-f' option. Also, each amount is
41       considered as an expenditure unless indicated otherwise by `-e'.
42
43
44       Tags/Categories:
45       ================
46
47       From version 0.7.4, pem introduced support for  tags  &  categories  of
48       records. You can tag an income and/or expense record as
49
50           $ pem -c bills "Cell phone bill" 830.50
51           $ pem -c 'travel fun leisure' "Trip to Goa" 4500
52
53       These  are  saved  with the tags 'bills' & 'travel fun leisure' respec‐
54       tively.  Later, you can see very useful reports showing  your  category
55       wise  expense  traits.  Now  pem  also facilitates filtering of records
56       using tags and description. Note that,  while  filtering  records,  pem
57       first  looks  into  the  tags  and  when they don't match, goes for the
58       description field.  Ex. To see all your expenses on `travel',  you  can
59       say
60
61           $ pem -s travel
62           $ pem -m travel
63
64       While  the  first  will list all your `travel' expenses in a month; The
65       later will show the cumulative results for each month till date.  Other
66       than this, pem supports these following options
67
68

OPTIONS

70       -b --bare
71               show unformatted report
72
73       -c --category <name>
74               categorise/tag your expenses
75
76       -e --earned
77               indicates income
78
79       -f --file <name>
80               specify file name
81
82       -s [n]
83               show daily report with total after [n] days
84
85       -m [n]
86               show monthly report with total after [n] months
87
88       -C
89               show category/tag-wise report
90
91       -t --total
92              shows just the total when used it with -s
93
94       -M <mm>
95               select the start month (01 <= mm <= 12)
96
97       -N <mm>
98               select an end month (01 <= mm <= 12)
99
100       -Y <yy>
101               select an year (00 <= yy <= 99)
102
103       -h --help
104               show this help
105
106       -v --version
107              show version information
108
109

ENVIRONMENT

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

REPORTING BUGS

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

AUTHOR

122       Written by Prasad J Pandit
123
124       Initial category patch: John Westlund
125
126
127
128                                                                        pem(1)