In this chapter you will learn how to use Emma.
The general command for running Emma looks like this:
emma [-imodule] [-pscript] [datafile]
Using -i you can import a python module at startup. The -p option let you parse a python script file. Additionally you can specify on the command line a file to open.You can control configuration of emma through preferences dialog. You can set following things:
The file to open at startup.
The default limit (to be applied when a file is opened).
The default depth to which the accounts chart will be expanded when a file is opened.
The date format. To know more about available format conventions look at the figure below. (default date format is deduced from your locale settings).
Figure 3-1. Date format conversion specifiers
The following list shows conversion specifiers for date format as in glibc-2.1.1. For more info type info --node "(libc) Formatting Date and Time"
The abbreviated weekday name according to the current locale.
The full weekday name according to the current locale.
The abbreviated month name according to the current locale.
The full month name according to the current locale.
The century of the year. This is equivalent to the greatest integer not greater than the year divided by 100.
The day of the month as a decimal number (range `01' through '31').
The date using the format `%m/%d/%y'.
The day of the month like with `%d', but padded with blank (range ` 1' through `31').
The date using the format `%Y-%m-%d'. This is the form specified in the ISO 8601 standard and is the preferred form for all uses.
The year corresponding to the ISO week number, but without the century (range `00' through `99'). This has the same format and value as `%y', except that if the ISO week number (see `%V') belongs to the previous or next year, that year is used instead.
The year corresponding to the ISO week number. This has the same format and value as `%Y', except that if the ISO week number (see `%V') belongs to the previous or next year, that year is used instead.
The abbreviated month name according to the current locale. The action is the same as for `%b'.
The day of the year as a decimal number (range `001' through `366').
The month as a decimal number (range `01' through `12').
The day of the week as a decimal number (range `1' through `7'), Monday being `1'.
The week number of the current year as a decimal number (range `00' through `53'), starting with the first Sunday as the first day of the first week. Days preceding the first Sunday in the year are considered to be in week `00'.
The ISO 8601:1988 week number as a decimal number (range `01' through `53'). ISO weeks start with Monday and end with Sunday. Week `01' of a year is the first week which has the majority of its days in that year; this is equivalent to the week containing the year's first Thursday, and it is also equivalent to the week containing January 4. Week `01' of a year can contain days from the previous year. The week before week `01' of a year is the last week (`52' or `53') of the previous year even if it contains days from the new year.
The day of the week as a decimal number (range `0' through `6'), Sunday being `0'.
The week number of the current year as a decimal number (range `00' through `53'), starting with the first Monday as the first day of the first week. All days preceding the first Monday in the year are considered to be in week `00'.
The preferred date representation for the current locale, but without the time.
The year without a century as a decimal number (range `00' through `99'). This is equivalent to the year modulo 100.
The year as a decimal number, using the Gregorian calendar. Years before the year `1' are numbered `0', `-1', and so on.
A literal `%' character.
Emma does the following things at startup:
First of all Emma loads its preferences. This makes several settings available for other stages.
Then it starts up python interface and seeks for the following files (and processes them in that order):
/usr/share/emma/emma.py
/usr/local/share/emma/emma.py
$HOME/.emma.py
After that it parses command line options.
And at the last stage Emma tries to open a preferences-specified file or the file given on the command line (which takes precedence over preferences settigns).