summaryrefslogtreecommitdiff
path: root/graphics/bm2font/README
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /graphics/bm2font/README
Initial commit
Diffstat (limited to 'graphics/bm2font/README')
-rw-r--r--graphics/bm2font/README131
1 files changed, 131 insertions, 0 deletions
diff --git a/graphics/bm2font/README b/graphics/bm2font/README
new file mode 100644
index 0000000000..44532faf61
--- /dev/null
+++ b/graphics/bm2font/README
@@ -0,0 +1,131 @@
+This is bm2font, a utility to convert pictures into TeX fonts, in C.
+
+
+This is the C port of the Pascal program of the same name by
+Friedhelm Sowa <tex@tex@dd0rud81.bitnet>
+
+It has been converted to C via p2c, the Pascal-to-C converter written
+by Dave Gillespie, <synaptx!daveg@uunet.UU.NET>
+and is up and running on NeXT, sun sparc (gcc) and rs6000 (gcc).
+For these three I provided cc lines in the Makefile
+
+New in the list is Mach I386 whatever this means
+
+
+Manifest:
+========
+
+You should have obtained bm2font.c, p2clib.c, loc.p2clib.c, p2c.h,
+and a Makefile.
+And the Gnu Public licence.
+
+There is a subdirectory "testpix" now, containing a selection of
+pictures, some of them out of Friedhelm's manual, by the author's
+permission, some others of my own choice, where you might experiment
+the different settings (particularly "carina" is extremely difficult!)
+and a selection of grayscales for testing.
+
+
+Changes against the PC version:
+==============================
+
+I took out the preview option (-s) and the pxl file option (-p)
+The former has been most PC specific, and would have to be
+handled by a bunch of library functions, and for the latter
+I don't see a real need today anymore (If you are still hooked,
+complain to your dope dealers)
+and I removed the interpretation of environment variables, which would
+make little sense in a Unix environment.
+So everything is handled locally, even if you call
+bm2font /pub/gifs/dobie.gif
+you will obtain ./dobiea.tfm, ./dobiea.300pk etc.
+(and see a fake)
+(NeXT and Sony addicts: I left it at 300 by default)
+
+
+Tiff Users Attention please
+===========================
+
+There seems to be some babel going on around the name "tiff".
+I had the opportunity to try out tifflib and SDSClib
+on tiffs, and found out that the current scanner software
+on PCs, as well as the examples talk a language entirely
+uncomprehensible to them and vice versa.
+
+So, if you have tiffs from, say, the Peoples collection, or some
+Icon, do convert it to gif before applying bm2font. There is
+enough of software ready to do the conversion. Try pbmplus.
+
+
+
+Compilation notes:
+=================
+
+The p2c stuff is intended to go with bm2font since they are modifications
+made while mating bm2font to p2c. Mille gracias to Dave for valuable
+suggestions.
+
+Do not put them into your installed p2c-version, nor replace
+them by your installed p2c versions.
+
+The sample CC lines that are in the Makefile may fail for you;
+the gccs I used may not be the same for you, nor the OS.
+
+The defines mentioned in the Makefile refer to entries in p2c.h,
+except one: -DINTEL which refers to order of significance stuff
+inside bm2font. Set that for intel machines.
+For the other defines, try p2c.h for reference.
+
+In particular, I know nothing about SysV-systems, so, try your luck.
+
+
+Manual:
+======
+
+There is no bm2font.1 yet, I do not speak troff.
+
+Friedhelm's manual applies to this version, except the changes
+mentioned above.
+I won't bundle it with this package since it is readily available
+on all TeX servers.
+
+For printing the manual, you must give to the supplied pks the extension
+*.300pk.
+
+Note to NeXT and Sony users: For printing the manual, you must give your
+dvi-printer the resolution 300. Sony will print it in smallprint,
+NeXT built-in PS interpreter scales it up again (and does a
+real good job, at that)
+
+
+Thanks to:
+=========
+
+Friedhelm Sowa, who constantly kept me posted to the latest updates
+and things yet to do. He was the one to point out that the INTEL switch
+was to be a cpp define switch instead a web switch.
+
+Dave Gillespie, the author of p2c, who suggested a good many changes
+to p2c instead of the fixes I did..
+
+Bart Childs and Heinz Werntges who were the first guinea pigs to
+test this out
+
+
+===========================================
+Well, erh, there are the copyright notices:
+
+bm2font is (C) 1991, 1992 by Friedhelm Sowa,
+p2c.h, p2clib.c, loc.p2clib.c is
+ (C) 1989, 1990, 1991 Free Software Foundation, Inc.
+and the Unix port is (A) by mahilata (All Rights Destroyed)
+
+..and
+#include <stddisclaim.h>
+Specifically, I do not guarantee that you will be able to print
+the Kascha series out of a.s.p--I did not keep them for testing:-)
+(Really, to me the lyaps out of Northern Norway are more exciting stuff,
+ but, perhaps I am a pervert)
+
+All complaints please direct to mahilata@vogon.mathi.uni-heidelberg.de
+who will most gladly pipe them to /dev/null