Prev: Reserved words

m Properties File

Global behaviour of the m application is configured in the m properties. Selecting View→Properties opens a dialog to edit the properties.

The properties are stored in an 8-bit text file system.appdir+"mShell.prp" containing key-value pairs. Each pair is on a single line, the key and the value separated by an equal (=) character.

The following keys are recognized by m:

• autogo=path1,path2,...
  A comma separated list of scripts or executables to run when starting m. In conjunction with onboot, these are run when the phone is switched on.
• bgcolor=black|white|red|green|blue|yellow|cyan| magenta|#rrggbb
  The background color of console and editor. #rrggbb is a HTML-like hexadecimal notation, e.g. #ff00ff for magenta.
• encodings=bom|utf-8|utf-16le|utf-16be|8-bit
  The encoding to use for m source files and files loaded into and saved from the m editor. This setting does not change the behaviour of the I/O streams of module io.
  If set to bom, files read are expected to carry an initial Byte Order Mark (BOM, character 0xfeff) determining their encoding; files without BOM are treated as sequences of 8-bit characters. In this mode, files are saved in UTF-8 with initial BOM.
  If set to utf-8, files are read and saved in UTF-8. No BOM is expected or written.
  If set to utf-16le, files are read and saved in UTF-16 Little Endian. No BOM is expected or written.
  If set to utf-16be, files are read and saved in UTF-16 Big Endian. No BOM is expected or written.
  If set to 8-bit, files are read and saved considering only the lower eight bits of all characters. No BOM is expected or written.
• fgcolor=black|white|red|green|blue|yellow|cyan| magenta|#rrggbb
  The foreground (text) color of console and editor.
• keep=true|yes|y|1 | false|no|n|0 | busy
  If set to true, yes, y or 1, the m application cannot be exited automatically by the system, e.g. if it is running low on memory, or if m is to be removed because it is updated by a new installation.
  If set to busy, exiting is prevented if there are processes running or waiting for input.
  For all other values, m behaves like any other "well behaving" application, i.e. it can be exited at any time if the operating system requests it.
• libpath=dir1,dir2,...
  A comma separated list of directories to search for modules when compiling a use clause (see also * ()).
• mfont=typeface,points,bold,italic
  The font to use in the m console and editor. A leading star (*) on the typeface is ignored. points (integer), bold (boolean) and italic (boolean) are optional. See also ui.mfont.
• mpath=dir
  The m application's current folder (shown in the script list).
• outsize=charcount
  The maximum number of characters in the console output, before truncating at the beginning. Truncation happens in chunks of about 500 characters. Set to 0 for an unlimited output size. Handling large output output sizes slows m down.
• perms=permissions
  The permission bits, defining the permissions granted to m scripts. See section * (Library).
• phone=gsm.number
  Your own phone number, assigned to gsm.number.
• _filename=pos
  The last position of the cursor when editing file filename.

All other keys are silently ignored. This can be used to disable entries by just putting e.g. a hash mark in front of them.

A sample properties file might look as follows:

autogo=c:\documents\mShell\TrackMe.m,e:\PhoneMonitor.mex keep=busy mfont=Monospace,14,false,false mpath=c:\documents\mShell\ fgcolor=#008000 bgcolor=white outsize=10000 encoding=utf-8 perms=159 phone=+41791234567 _C:\documents\mShell\SmsService.m=133

---

Next: Footnotes

Navigation