NCSA Mosaic for the X Window System

# Creating a configurable Documents menu

Mosaic for X 2.0 provides the means for sites to create their own `Documents` menus with a "Documents Menu Specfile."

By default there is no `Documents` menu in the menu bar. Places to look in order of preference at program startup are:

- the value of the resource `documentsMenuSpecfile` (by default /usr/local/lib/mosaic/documents.menu)
- the value of the environment variable MOSAIC_DOCUMENTS_MENU_SPECFILE
- the value of the compile-time #define DOCUMENTS_MENU_SPECFILE (by default /usr/local/lib/mosaic/documents.menu).

The specfile itself consists of alternating lines of title and URL; a single line starting with two dashes ("--") between any two title/URL pairs counts as a separator. By default up to 80 things (title/URL pairs + separators) can be in a specfile (this can be increased in src/gui-menubar.c if necessary). An example specfile is distributed with the source code (but is not intended to be a default).

Back to top level Documentation Index