.\" Copyright © 2003 by George Williams.
.ds Ps P\s-2OST\s+2S\s-2CRIPT\s+2
.TH MENSIS 1 "13 October 2003"
.SH NAME
.B mensis - To or for, by with or from TrueType tables
.SH SYNOPSIS
.B mensis
.RB [ \-cmap
.IR maptype ]
.RB [ \-depth
.IR pixeld ]
.RB [ \-display
.IR str ]
.RB [ \-help ]
.RB [ \-keyboard
.IR ktype ]
.RB [ \-nosplash
.RB [ \-script
.IR file ]
.RB [ \-sync
.RB [ \-usage ]
.RB [ \-vc
.IR vclass ]
.RB [ \-version ]
.I fontfile ...
.SH DESCRIPTION
The program
.I mensis
allows you to examine and modify some of the tables in a truetype or opentype font.
.LP
If the argument list contains a font file name (or several),
.I pfaedit
opens a
.B table view
window for each font displaying all the tables in that font
In the absence of options or arguments,
the program opens a file-picker window,
allowing you to browse your disk to find a font file.
.LP
This manual page is intended only as a rudimentary overview;
see the HTML Users Manual for more complete information.
\fChttp://mensis.sourceforge.net/\fP
.SH OPTIONS
.TP
.B \-cmap maptype 
Employ the specified method to control 8-bit colormaps,
where
.I maptype
assumes one of these three values:
.RS
.TP
.B current
Attempt to allocate colors in the current (shared) colormap.
The program will likely not find everything it requires.
.TP
.B copy
Allocate what can be allocated, then copy the current colormap;
it can thus make use of cells other programs are using.
.TP
.B private
Create a new colormap and fill it with the required colors.
.RE
.TP
.BI \-depth " pixeld" 
Attempt to employ a visual that matches the specified pixel depth,
.IR pixeld .
.TP
.BI \-display " str" 
Employ the X display specified by the string
.I str
(for example: localhost:0).
.TP
.B \-help
Display the usage description
and start a web client displaying the online documentation.
.TP
.BI \-keyboard " ktype" 
Alter the displayed menus to employ modifier keys appropriate
to the specified keyboard type,
where
.I ktype
assumes one of the following four values:
.RS
.TP
.B ibm
IBM PC type keyboard.
.TP
.B mac
Apple Macintosh keyboard.
.TP
.B sun
Sun workstation keyboard.
.TP
.B ppc
Macintosh keyboard, but on a system running SuSe linux
(the mappings differ from those used under MacOS X).
.RE
.TP
.B \-nosplash
Suppress display of the splash screen.
.TP
.BI \-script " file"
Execute the script named
.IR file .
Does not open the X display.
This must be the first argument passed to mensis. Any other arguments are
handled by the scriptfile itself.
Any other command line arguments will be passed to the script.
The program contains a command interpreter which allows access to
most but not all of its interactive features.
If a scriptfile is executable, and if its first line contains
the string "mensis", then the argument
.BI \-script
may be omitted. This means that mensis can be used as an interpreter.
.TP
.B \-sync
Make X synchronous.
Used primarily for debugging, this option slows X down.
.TP
.B \-usage
Display the usage description.
.TP
.B \-vc vclass 
Attempt to use a visual that matches the class,
.IR vclass ,
specified as either the name of a visual class
or an integer enumerating a visual class.
.TP
.B \-version
Display the current version
(a six digit string containing the date stamp of the source files).
.SH ENVIRONMENT
If any of the following environment variables exist,
they are used:
.TP
.B BROWSER
Specifies the name of a browser program for examining documentation.
.TP
.B MENSIS_VERBOSE
Turns on verbose mode in scripting. Each statement is printed as it is executed.
.SH FILES
.TP
.B /usr/local/share/mensis/*.ui
translations for the user interface
.TP
.B /usr/local/share/doc/mensis/*.html
optional location for online documentation.
.\"
.SH "SEE ALSO"
.BR pfaedit (1)
.LP
The HTML version of the
.I mensis
manual,
available online at:
.TP
\fChttp://mensis.sourceforge.net/\fP.
.\" .SH STANDARDS
.\" .SH HISTORY
.SH AUTHOR
Copyright (C) 2001-2003 by George Williams (gww@silcom.com).
.SH BUGS
Undoubtedly many, but unknown and ever changing.
See
.IP
\fChttp://mensis.sourceforge.net/#known-bugs\fP
for a current list.
.\" end of file
.\"