              +-------------------------------------------------+
              |            GMEFont 1.0 for HP49G(+)             |
              |  Greek & Math Enhanced size 8 font and minifont |
              +-------------------------------------------------+

COPYRIGHT & DISCLAIMER
======================
The files and documents in the package are copyright of the author:

(c) 2004 Federico Marziali <federico.marziali@tiscali.it>

You may distribute the ENTIRE and UNMODIFIED package freely; in no case you  can
charge anything for these programs, which MUST remain free. All the programs and
informations in  this text  file are  provided "as  is" without  warranty of any
kind, either expressed or implied. In no event will the author (me) be liable to
you for any damages, including incidental or consequential damages, arising  out
of the use of the programs, even if the author was advised of the possibility of
such damages.


FEEDBACK
========
I  appreciate  all feedbacks,  from  "your program sucks!"  to  "your program is
great!". Please report any bug, suggestion or improvement.  If you want to  play
with  the  code  feel free to do it, but I suggest you to make at least a BACKUP
before: MASD dislikes Minifont and Font objects! :o)


PACKAGE CONTENTS
================
The packages containt the following file:
 - GMEFont.txt        This text file.
 - GMEFont.gif        The entire redesigned charmap.
 - GMEFont8           The GMEFont8 object itself. FontSize: 8.
 - GMEMinifont        The Minifont object designed to work with GMEFont8.
 - GMtog              A smart toggler between GMEFont8/Minifont and the  default
                      System Font8 and Minifont.
 - GMasn              A  smart key-assigner for the Alpha+RighShift(Hold)  plane
                      of  the calculator, which becames the default for  writing
                      greek letters.
 - GreekLetters.pdf   A  document  showing the ancient lowercase  and  uppercase
                      greek  letters  along  with  their  latin  equivalent  and
                      pronunciation. Copyright for this document: Neil Porter.


INSTALLATION
============
The files contained in the package are HP49G(+) objects and binary programs, not
libraries, so you don't have to follow any "special installation"  instructions.
Just  copy the objects you want in your  HP49G(+) ans save them in any  variable
you like. I recommend to "install  the fonts" by using  GMtog and  to get useful
assignments using GMasn. See their descriptions for further details.
All the  objects and  programs have  been tested  in HP49G  with ROM 1.19-6  and
HP49G+ with ROM 1.23.


THE FONT
========
GMEFont is designed primarly with the  intent to supply the HP49G(+) users  with
all the ancient greek letters, because they are used a lot in mathematics. More,
it gives you a sample of glyphs useful in engineering, physics and mathematics.
To accomplish  this "task", the multi-language support of the  builtin font  was
sacrificed: the only preserved letter was the uppercase A with a circle above it
(CHR 197) because  it is the  Armstrong Unit symbol.  For compatibility reasons,
the character map has been redesigned  only to some extend: you can  explore the
characters with the HP49G(+) built-in  browser (RightShift+CAT) to see what  was
added/changed, and where, or simply look to the GIF image in the package.

THE TOGGLER: GMtog
==================
Even  if you can setup fonts by  yourself executing the commands  '\->FONT'  and
'\->MINIFONT' on the GMFont8 and GMEMinifont objects respectively, it is  useful
to have a program that  automatically toggles between System Font8/Minifont  and
the GME Font8/Minifont. For this GMtog is provided.
NOTE: the  HP49G(+) has  not a  Minifont command  equivalent to  FONT8, FONT7 or
      FONT6 to restore the default minifont: if you want to manually  substitute
      it, I suggest you to save it before with the 'MINIFONT\->' command.


THE KEYS ASSIGNER: GMasn
========================
As  you probably  still know,  to enter  lowercase letters  you always  use the
combination Alpha+LeftShift+"buttons with letters".
Since in the original font set of  the 49 there were not all the  greek letters,
only some Alpha+RightShift combinations were designed to enter greek letters. To
be  honest,  some  of  them are quite strange: e.g. I  can't  realize  why  they
designed  Alpha+RightShift+F6  (F  letter)  to  enter  the  'rho'  greek letter!
Starting  from  this,  I've  thinked  that it  will  be  good  to  have all  the
Alpha+RightShift  plane  assigned  to  enter  lowercase  greek  letter  and  the
Alpha+RightShiftHOLD plane to enter uppercase greek letters.
To easily do this, the program GMasn is provided, which automates the User  Keys
assignment  process.  "Connection"  between  letters  on  the  keyboard  and the
corresponding greek letters is done on a phonetic base (see the GreekLetters.pdf
document for the pronunciation of greek letters).
NOTE  that  the GMasn  program  will overwrite  most  of the  previous  User Key
assignments  for  the  buttons   with  letters  for  the   Alpha+RightShift  and
Alpha+RightShiftHOLD  plane! If  you like,  you can  manually save  them  before
proceeding.  Obviously, these assignments may have no sense if you have  another
font in use.
REMEMBER  that  User Keys - and so their assignments! - are active only  if  the
User Keyboard  is active  (system flag  62 set:  use LeftShift+Alpha  one or two
times, depending on system flag 61).

Alpha+RightShift plane (lowercase greek letters): 24 keys assignments
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
a = alpha
b = beta
c = chi
d = delta
e = epsilon
f = phi (glyph 1)
g = gamma
h = phi (glyph 2)
i = iota
j = eta
k = cappa
l = lambda
m = mu
n = ni
o = >NONE< (lowercase omicron greek letter is identical to lowercase latin 'o')
p = pi
q = theta
r = ro
s = sigma
t = tau
u = upsilon
v = >NONE<
w = omega
x = csi
y = psi
z = zeta

Alpha+RightShiftHOLD plane (uppercase greek letters): 10 keys assignments
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
f = PHI
d = DELTA
g = GAMMA
l = LAMBDA
p = PI
q = THETA
s = SIGMA
w = OMEGA
x = CSI
y = PSI

Alpha+RightShiftHOLD  combinations  are  less  than  those  for  lowercase greek
letters because most of uppercase greek letters are identical to uppercase latin
letters (so you can simply use the Alpha plane for most of them).


CREDITS
=======
I  want to thank Wolfgang Rautenberg for  his OT49  library, which helped me  to
easily compile these little programs  containing fonts - MASD has  some problems
with  them  - via  the  '3tog' command  and  to compress  them  via the  '~'  BZ
-compressor implementation. Also I want to thank P. Pamart for his pretty  'MNF'
minifont editor, which I used to make the minifont.