README

   1 gbdfed 1.6
   2
   3 INTRO
   4 -----
   5
   6 gbdfed is a GTK-based BDF font editor with the following features:
   7
   8   o  Multiple fonts can be loaded from the command line.
   9   o  Multiple fonts can be open at the same time.
  10   o  Cutting and pasting glyphs between fonts.
  11   o  Multiple glyph bitmap editors can be open at the same time.
  12   o  Cutting and pasting between glyph bitmap editors.
  13   o  Export of XBM files from glyph bitmap editors.
  14   o  Automatic correction of certain metrics when a font is loaded.
  15   o  Generation of XLFD font names for fonts without XLFD names.
  16   o  Update an XLFD font name from the font properties.
  17   o  Update the font properties from an XLFD font name.
  18   o  Font property editor.
  19   o  Font comment editor.
  20   o  Supports unencoded glyphs (ENCODING of -1).
  21   o  Display of glyph encodings in octal, decimal, or hex.
  22   o  Builtin on-line help.
  23   o  Imports PK/GF fonts.
  24   o  Imports HBF (Han Bitmap Font) fonts.
  25   o  Imports Linux console fonts (PSF, CP, and FNT).
  26   o  Imports Sun console fonts (vfont format).
  27   o  Imports fonts from the X server.
  28   o  Imports Windows FON/FNT fonts.
  29   o  Imports OpenType/TrueType fonts and collections.
  30   o  Exports PSF fonts.
  31   o  Exports HEX fonts.
  32
  33 A few things missing from this font editor:
  34
  35   o  No way to create space glyphs in monowidth or character cell fonts.
  36   o  No support for scaling fonts.
  37   o  Fonts with right-to-left direction (negative widths) not supported.
  38   o  No way to edit comments appearing in the properties list.
  39
  40 Known problems:
  41
  42   o  Selecting the original font editor from the "Windows" menu does not
  43      deiconify, set focus, and place it on top like it should.
  44   o  Deleting glyphs from or inserting glyphs into a font grid do not update
  45      the glyph editors if they happen to be editing a deleted glyph or a glyph
  46      that moved due to an insertion.
  47
  48 COMMAND LINE OPTIONS
  49 --------------------
  50   gbdfed [options] [font1 font2 ...]
  51
  52   -nc      - do not preserve comments
  53   -nu      - do not preserve unencoded glyphs
  54   -nm      - do not make metrics corrections
  55   -np      - do not pad character-cell bitmaps
  56   -bp      - allow blank pages
  57   -ed      - do not present the "Really Exit?" dialog
  58   -ps n    - set default point size
  59   -hres n  - set default horizontal resolution
  60   -vres n  - set default vertical resolution
  61   -res n   - set both default resolutions
  62   -sp s    - set font spacing ("p" for proportional, "m" for monospace,
  63              or "c" for charcell).
  64   -eol e   - set the default end-of-line char(s) ("u" for Unix, "d" for DOS,
  65              or "m" for Mac).
  66   -g code  - set the initial glyph code (in decimal, hex or octal).
  67   -cb base - set the code base for display of glyph codes, can be "octal,"
  68              "decimal," or "hexadecimal." The first letter of these names
  69              work as well.
  70
  71   By default, gbdfed will set its point size to 12, the horizontal and
  72   vertical resolution to that of the display (e.g. 90x90 dpi for Sun's), and
  73   the font spacing to proportional.  Also by default, gbdfed will preserve
  74   comments, preserve unencoded glyphs, and make metrics corrections when
  75   loading fonts.
  76
  77 COMPILING
  78 ---------
  79
  80 To build gbdfed, GTK 2.6 or greater is required. It may be that versions as
  81 early as 2.3 will work, but only various versions of 2.7 through 2.20 have been
  82 tested.
  83
  84 Optional:
  85
  86   Freetype2 support is optional and can be found at:
  87
  88     http://www.freetype.org
  89
  90 Step 1.
  91
  92   Run the "configure" script to generate the Makefile. By default, the program
  93   installs in /usr/local. You can change that by using the --prefix option of
  94   the "configure" script.
  95
  96   To disable the File->Import->X Server Font feature, use the --without-x
  97   command line option to the "configure" script.
  98
  99 Step 2.
 100
 101   Compile the program
 102
 103 WARNINGS
 104 --------
 105
 106 1. When compiling on HP/UX, the htext.h file has long concatenated strings that
 107    require the -H option (noted by W. Chao).
 108
 109 2. Compiling with the gcc -pedantic option complains about strings being too
 110    long in the help text file. The help system will be changed in later
 111    versions.
 112
 113 ACKNOWLEDGEMENTS
 114 ----------------
 115
 116 Thanks go to the following people:
 117
 118   Ross Patterson for his HBF code.
 119
 120   der Mouse for his "getbdf" code.
 121
 122   K. Carothers and A. Korobka for their "fnt2bdf" code in Wine.
 123
 124   Mike Stroyan <mike_stroyan@fc.hp.com> for patches.
 125
 126   Primoz Peterlin <primoz.peterlin@biofiz.mf.uni-lj.si> for the man page and
 127   some changes for building on HP/UX.
 128
 129   Danny Backx <u27113@kb.be> for the LessTif Imakefile.
 130
 131   Donald Page <donaldp@sco.com> for patches.
 132
 133   Michal Szymanski <msz@sirius.astrouw.edu.pl> for problem reports.
 134
 135   Werner Lemberg <a7971428@unet.univie.ac.at> for pointing out a problem
 136   with the HBF code and other problem reports.
 137
 138   William F. Maton <wmaton@enterprise.ic.gc.ca> for pointing out a
 139   problem with padding character cell fonts.
 140
 141   Ivan Nejgebauer <ian@uns.ns.ac.yu> for reporting a problem with glyph
 142   names on imported console fonts.
 143
 144   Solofo <solofo@mpi-sb.mpg.de> for reporting a problem when creating an
 145   XLFD name.  The old name was saved in the FONT property and some
 146   versions of "mkfontdir" use that instead of the first FONT field.  Also
 147   for recommending that the Ctrl+F4 accelerator be configurable if
 148   it does not suit the user.
 149
 150   Dave Bodenstab <imdave@mcs.net> for providing a patch for a problem
 151   with the HBF code that was not allowing gzipped HBF files to be
 152   loaded, and a patch to get rid of some extraneous code.  Also a patch to fix
 153   some size problems with GlyphEditors.
 154
 155   W. Chao <wchao@HRZ.Uni-Bielefeld.DE> for providing the Makefile changes
 156   needed to compile on HP/UX and pointing out a problem with the builtin
 157   documentation.
 158
 159   Andreas Reuter <ar205@bonzo.geowiss.nat.tu-bs.de> for pointing out a problem
 160   with importing TrueType fonts.
 161
 162   Leonard Dickens <leonard@saul.hipgraphics.com> for providing the Makefile
 163   changes needed for IRIX 6.3.
 164
 165   Markus Kuhn <Markus.Kuhn@cl.cam.ac.uk> for a handful of good suggestions.
 166
 167   Jim Knoble <jmknoble@pobox.com> for some geometry improvements in some
 168   dialogs.
 169
 170   Darren Stuart Embry <dsembr01@ox.slug.louisville.edu> for the donation of
 171   another HP/UX 10.20 X11R6 compilation setup.
 172
 173   Vladimir Volovich <vvv@vvv.vsu.ru> for pointing out something I forgot to
 174   test.
 175
 176   Ben Fry <fry@media.mit.edu> for IRIX 6.5.2 variables for the Makefile.
 177
 178   J.H.M. Dassen (Ray) <jdassen@debian.org> for fixing bugs with the PK/GF
 179   import feature.
 180
 181   Robert Brady <rwb197@ecs.soton.ac.uk> for pointing out a problem with the
 182   length of _XFREE86_GLYPH_RANGES properties and an Exceed font compiler.
 183
 184   Stefan Monnier <monnier@cs.yale.edu> for a bug report on highlight thickness
 185   of 0.
 186
 187   Humphrey Clerx <humphrey.clerx@eurocontrol.be> for pointing out some
 188   compilation problem on Digit Unix 4.0 and some compilation problems with
 189   Traditional C compilers.
 190
 191   Rudolf Cejka <cejkar@dcse.fee.vutbr.cz> for providing patches to fix
 192   problems with grabbing fonts from the X server and alerting me to
 193   uninitialized variable warnings.
 194
 195   Baruch Even <baruch@ev-en.org> for providing a fix for a bug that should
 196   have shown up long ago dealing with font properties.
 197
 198   Sergey Vlasov <vsu@mivlgu.murom.ru> for pointing out a serious problem with
 199   naming glyphs from the Unicode Character Database and for providing a fix
 200   for a potential buffer overflow problem.
 201
 202   Daniel Neuburger <daniel.neuburger@lmco.com> for providing a patch that
 203   fixes a display problem in the Font Grid.
 204
 205   Pierre HANSER <Pierre.Hanser@sxb.bsf.alcatel.fr> for a patch to fix a
 206   problem loading font names that are not NULL terminated from the end of
 207   FON/FNT files.
 208
 209   Patrick Hagglund <patrik.hagglund@bredband.net> for providing the patches to
 210   use FreeType 2.
 211
 212   James Cloos <cloos@jhcloos.com> for finding problems with gbdfed.
 213
 214   Ming Hua <minghua@rice.edu> for locating a problem with editing glyphs.
 215
 216   Sergio Martins <smartins@students.dei.uc.pt> for finding a typo and several
 217   dialog related bugs.
 218
 219   Viktor Urban <viktor@icc-atcsolutions.com> for locating a problem when
 220   saving and moving to the next or previous glyph.
 221
 222   Jiri "BlueBear" Dluhos <modry.medved@seznam.cz> for producing crash fixes on
 223   64-bit machines.
 224
 225   Jan Engelhardt <jengelh@linux01.gwdg.de> for providing an improvement on the
 226   help text, a missing prototype, and an improvement in Makefile.in.
 227
 228   Daniel Richard G. <skunk@iSKUNK.ORG> for diagnosing problems on 64-bit
 229   architectures.
 230
 231   Baruch Even <baruch@ev-en.org> for diagnosing problems on 64-bit
 232   architectures.
 233
 234   Ming Hua <minghua.debian@gmail.com> for pointing out a warning about testing
 235   a NULL region.
 236
 237   Ryan Hill <dirtyepic@gentoo.org> for pointing out a crashing problem with
 238   filename filters when the import dialog was popped up multiple times.
 239
 240   Don Knuth for reporting problems with the documentation and a highlighting
 241   problem (https://bugs.launchpad.net/ubuntu/+source/gbdfed/+bug/172836).
 242
 243   Tim Allen <screwtape@froup.com> for reporting an obscure bug with glyph
 244   spacing which led to fixing another spacing related bug. Also for the idea
 245   of preserving device width offsets.
 246
 247   Daniel Quarras <dqarras@yahoo.com> for discovering that deleting PSF
 248   unicode map entries was being ignored.
 249
 250   Bertrand Janin <tamentis@neopulsar.org> for adding glyph navigation buttons
 251   to the GlyphEditors.
 252
 253   Peter Volkov <pva@gentoo.org> for fixing a name collision with Glib 2.10.
 254
 255   Tom "spot" Callaway <tcallawa@redhat.com> for the configuration addition
 256   that fixes a problem with implicit dynamic linking that showed up with newer
 257   versions of gcc.
 258
 259 AUTHOR
 260 ------
 261   Mark Leisher <mleisher@gmail.com>
 262   15 April 2010