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 is available:

   -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.

-external

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...

-clicktofocus

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:

a line beginning with sharp (#) is a comment
```
# this is a comment
```

any other line must be of the form

type/subtype    suffix1 suffix2

as in the example :

image/jpeg        jpeg jpg jpe

-nomodule

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/415 directory (415 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.

-fast

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.

Others

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