MMM : command line options
Note: MMM is usually run from a shell-script configured during
installation, which, in turn, runs one of the MMM binaries
installed on your system. The shell-script may give default values to
some of these options.
List of options
This list is obtained by running mmm -help.
In the following, characters < and > are part of the notation, and
must of course not be typed in.
-proxy <hostname> Proxy host
-port <port> Proxy port
-d <foo:0> Display
-display <foo:0> Display
-suffixes <file> Suffix file
-external Accept remote command (mmm_remote <url>)
-lang <lang> I18n language
-msgfile <file> I18n message file
-prefs <file> Preference File
-helpurl <url> Help URL
-palette <color> Tk Palette
-nomodule Don't load initial modules
-clicktofocus Click to Focus mode (default is Focus Follows Mouse)
-geometry <wxh+x+y> Initial geometry for the first navigator
If MMM was run from the shell-script, as recommended, another option
-fast Native Version
Description of options
- -d <display>
- -display <display>
- Indicates the X display on which MMM should render
(e.g.: -display foo:0).
- -geometry <WxH+X+Y>
- Indicates the geometry of MMM's initial window. See here for an elegant way to integrate MMM
in your desktop.
- Indicates that MMM should accept requests from its companion program
mmm_remote. Communications between the two programs take place in a
named pipe $HOME/.mmm/remote.
- -prefs <file>
- Indicates the name of the preference file to use in this sessions.
If this option is not specified, MMM will use
$HOME/.mmm/MMM.ad as default value.
This name is combined with the language given with the
-lang option. For example, with -lang fr,
MMM will take $HOME/.mmm/MMM.ad.fr for preference file if it
exists, or else $HOME/.mmm/MMM.ad.
- -palette <color>
- Indicates the base color of MMM's palette.
Default is a "traditionnal" gray. Some prefer white, ocre, etc...
- Indicates that the user should first click in a window to get keyboard
events directed to it (Macintosh way), instead of the default mode, where
keyboard events are (most of the time) directed at the window which contains
the mouse cursor.
- -suffixes <file>
- Indicates the name of the file describing the association of a MIME
type to a given file suffix (e.g. foo.gif is of type image/gif).
The default is $HOME/.mmm/mime.types. If this file does not exists,
MMM will only recognize a number of predefined suffixes.
The syntax of this file is as follows:
- Desactivate the automatic loading of MMM extensions.
By default, during the initialisation, MMM (bytecode version only)
loads any .cmo file found in the $HOME/.mmm/418 directory
(418 being the version number). This files are Caml applets
extending MMM (new viewers, extensions of the HTML display machine, ...)
- -lang <language>
- Indicates the language wished for displaying text in buttons, menus and
various messages. By default, this value is the environment variable
$LANG if it exists. If MMM has no definitions for the chosen
language, English is used. This option also affects the choice of the
preference file, as described above.
- -msgfile <file>
- Indicates the name of the file containing the messages
translations. This option is usually configured once and for all in the
MMM launching shell-script.
- -proxy <machine>
- -port <port number>
- Indicates the Web proxy. These options are usually configured in the
MMM launching script. The user can later modify the definitions
in the preferences control panel, and thus need not use these options.
- -helpurl <URL>
- Indicates the address of the help documents (the ones you are currently
reading), accessible in MMM from the Help menu.
This is usually set up in the MMM launch script.
- Indicates that the native version (ie. compiled with ocamlopt)
of MMM should be used. In that case, applets are not
available (neither MMM extensions loaded during initialisation).
Apart from applets, both versions of MMM are in principal identical.
The native version is a bit faster.
- Initial Url
- Finally, this last (facultative) option is the address of the document
to be displayed in the initial window. It may be an URL (http: etc...) or
simply a file name.
- Variable WWW_HOME
- The environment variable WWW_HOME, if defined, indicates the
address of the document displayed when then Home menu is invoked.
- Variable MMM_MAIL
- See external programs