home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / printer / hwgpost / readme.first < prev    next >
Encoding:
Text File  |  1995-02-27  |  11.9 KB  |  320 lines
  1.  
  2. Users of previous HWGPOST versions, please note: This text has changed in
  3. some places. Please read it again.
  4.  
  5.  
  6. What is this?
  7. =============
  8.  
  9. What you get here is the fourth version of HWGPOST that is publically
  10. available. It is _extremely_ raw, very incomplete, and probably buggy as
  11. hell. My intention is to abuse you as beta tester. ;^)
  12.  
  13. HWGPOST is project that I started because I had some problems with
  14. post.library 1.7 (and 1.86 where post.library stayed the same) not handling
  15. some PostScript code correctly. So I built on the post 1.7 source. HWGPOST
  16. is IMHO a major step towards PostScript Level 2 already and as time and
  17. motivation permits it will hopefully become a R&W book compliant PostScript
  18. Level 2 interpreter library with maybe some Display PostScript extensions.
  19.  
  20. Currently this archive is probably mostly useful to users of post.library
  21. up to 1.7.
  22.  
  23. Major new features for HWGPOST beta 4
  24. =====================================
  25.  
  26.     - image operators support files as source.
  27.     - startjob/exitserver.
  28.     - execform.
  29.     - composite font support.
  30.     - setsystemparams (pretty much a dummy though).
  31.  
  32. Sorry, setpagedevice has to wait.
  33.  
  34.  
  35. Requirements
  36. ============
  37.  
  38. OS:      >=V37 (= KS2.04)
  39.  
  40. Memory: As much as possible. HWGPOST tends to need noticeable more memory
  41.         than post.library 1.7 for complex PostScript files. You should have
  42.         at least 2MB to have fun with it.
  43.  
  44. HD:     Suggested
  45.  
  46.  
  47. Compatibility
  48. =============
  49.  
  50. HWGPOST should be compatible to all applications using post.library 1.7
  51. with the exception of the "callextfunc" and some other special non standard
  52. operators, e.g. I have found no problems with PostView. If you have any
  53. compatibility problems, please report them to me.
  54.  
  55.     AmigaTeX
  56.  
  57.         The AmigaTeX postscript files installPSfont.pro, psfilt.pro, and
  58.         pstopk.pro (in TEX:ps) contain definitions of the "findfont"
  59.         operator. If you comment out these definitions and replace the
  60.         init.ps, AmigaTeX works well with HWGPOST.
  61.  
  62.  
  63. Legal stuff/Distribution/bla
  64. ============================
  65.  
  66. I need to explain something first. I built on the post 1.7 sources by Adrian
  67. Aylward. He did an amazing job with post up to and including 1.7.  I do not
  68. claim to having put it all together myself from the the very first byte.
  69. But I have thrown out or reworked almost every single line of it and there
  70. is not much left that is not replaced or truly unchanged. Adrian
  71. Aylward set up many useful concepts. I reworked most of them and threw
  72. some out completely for going towards PostScript Level 2.
  73.  
  74. While it may not look so from the outside, HWGPOST is a major step away from
  75. its origins, and so I claim the right to have something new here. Note that I
  76. did not take over any code from other sources than post 1.7 except for
  77. some fixes to post 1.7 that people sent me (Thanks especially to Tom
  78. Rokicki for his fixes and other unrelated things). No GNU code, no IBM
  79. code, nor anything else. To be honest I tried to look at some ghostscript
  80. code once for a particular feature, but I found it so ugly that I threw it
  81. out faster than you can say "out" (I never even found the code for the
  82. feature I was looking for). This means, that all that you read in the
  83. history file is only related to my work.
  84.  
  85. Because of all the above, there will be different rules on HWGPOST that
  86. start out right _now_ even with this beta version:
  87.  
  88.     - Unlike with post 1.7, I am restricting commercial use somewhat:
  89.  
  90.           For use in commercial products or claims of compatibilty to
  91.           HWGPOST to enhance the value of a commercial product, you need to
  92.           contact me first to work something out.
  93.  
  94.           (Except for Tom Rokicki. He may use HWGPOST whenever he finds it
  95.            acceptable for AmigaTeX)
  96.  
  97.     - If you are just a user of HWGPOST, consider it Giftware. I like
  98.       money, too, but it doesn't have to be money. Anything nice will do.
  99.       Books, A3k-Accelerator/Networking boards, Ax000s, HDs, SW, non
  100.       technical things, whatever. If you intend to use HWGPOST and forget
  101.       about me intentionally, don't expect any support or bug fixes.
  102.  
  103.     - If you want to use HWGPOST commercially (e.g. to make money by using
  104.       it in your office), I feel that you should consider this very fact
  105.       when thinking about a gift. If you think HWGPOST to be good enough to
  106.       support you making a living, you should value it as such.
  107.  
  108.     - Starting with HWGPOST beta 2, ANY USER OF HWGPOST IS REQUIRED TO
  109.       REGISTER the use of HWGPOST with me via email or smail.
  110.  
  111. All (important) rights reserved, so to speak. This is currently a private
  112. undertaking for fun, but I have not yet lost hope that there is maybe some
  113. reward in it for me, too. :-)
  114.  
  115. If you don't like the above, I don't want you to use HWGPOST. In fact I
  116. dare to declare use of HWGPOST then outright illegal. You should live with
  117. post 1.7 or something else then.
  118.  
  119. Oh well, if you are one of those using pirated [KS/WB] SW, don't bother
  120. asking for help. I won't help you and I specifically _don't_ allow you to use
  121. HWGPOST either in this case.
  122.  
  123.  
  124.  
  125. Why this beta?
  126. ==============
  127.  
  128. A lot of stuff is in place within HWGPOST already even though it is
  129. probably still far from completion. Actually it is so much that I hope to
  130. find bugs with your help now. I do not have test cases and PostScript files
  131. anymore to test all that PostScript Level 2. You will read some "untested"
  132. comments in the history file. I have checked for basic functionality with
  133. all my changes, but nobody knows where the bugs hide yet. So I am asking
  134. you for bug reports to make HWGPOST get better.
  135.  
  136. I am interested in:
  137.  
  138.     - Enforcer hits, mungwall problems, reproducable crashes
  139.     - deviation of behaviour compared to Adobe Level 2 products
  140.     - Short and precise PostScript example files that break with HWGPOST
  141.  
  142. and I need your complete computer and OS configuration with any bug report
  143. including any non C= WB things that you run like
  144. MagicMenu/ReqTools/CpuBlit.
  145.  
  146. I am also interested in a short note if you have files using specific
  147. Level 2 features available with HWGPOST that _don't_ break.
  148.  
  149. Thank you for your help!
  150.  
  151.  
  152. Common Problems, Q&A
  153. ====================
  154.  
  155. This will evolve into a list of problems people run into that are
  156. definitely not a problem with HWGPOST.
  157.  
  158.     Problem: PS files fail because the name "SymbolEncoding" is not known.
  159.  
  160.     Solution: Throw out the "Symbol" font you have, buy the Adobe Type
  161.               Manager and/or install a working Symbol font. You are using a
  162.               Symbol font that violates Adobe PostScript specs by relying
  163.               on an external definition of SymbolEncoding. This name does
  164.               not exist in the standard. Your current Symbol font is broken.
  165.  
  166.     Problem: A font does not work right or causes errors.
  167.  
  168.     Solution: Have you preregistered it correctly in HWGPOSTResources? If
  169.               you depend on the PATH_FONT feature, is the name truly
  170.               correct including case? Have you double checked?
  171.  
  172.               NOTE: If there is a bug with fonts, I will need the font
  173.                     to fix it. If it is a commercial font, you have to
  174.                     smail me one legal copy for my own use if I don't have
  175.                     it already. I won't and can't buy fonts just to get
  176.                     your problems fixed.
  177.  
  178.  
  179. What should a bug report look like?
  180. ===================================
  181.  
  182. I prefer bug reports created with the C= 'report' tool. Any bug report
  183. _must_ contain step by step instructions to reproduce the bug on a standard
  184. WB setup. Telling me "You need to install this pack of special OS hacks to
  185. make the bug appear" usually leads to no result. If it is a bug related to
  186. a PostScript program, I'd need a short example program to reproduce it. If
  187. the bug is dependent on the exact layout of the program (e.g. with eexec
  188. problems), you should think about using lha and uuencode to preserve any
  189. spaces, tabs, newlines, or other special characters in the file that might
  190. otherwise be lost in email.
  191.  
  192. _AN_ABSOLUTE_MUST_ is the output of C:VERSION FULL (or a version comment in
  193. the file or printed in a window if C:VERSION does not yield useful
  194. results) _and_ C:LIST for any program involved. This includes but is not
  195. limited to:
  196.  
  197.     - The OS (Use ShowConfig)
  198.     - The frontend (post, postband, postview, etc)
  199.     - The library post.library
  200.     - The support files init.ps, HWGPOSTResources
  201.     - For printing, the printer driver
  202.  
  203. If you don't give me this information with each bug report, I might decline
  204. to look at it.
  205.  
  206. Oh, and please don't swamp me with hundreds of kilobytes email without
  207. asking first. Thank you.
  208.  
  209.  
  210. What is included?
  211. =================
  212.  
  213.     - README.FIRST      (This file)
  214.  
  215.     - post.library      (Using C= IEEE libs for all Amigas)
  216.  
  217.     - post.library.20   (Compiled for >=68020 using inline coprocessor math)
  218.  
  219.     - History           (Informal overview on the changes since post 1.7)
  220.  
  221.     - init.ps           (A new init.ps. You _will_ have to use it)
  222.  
  223.     - HWGPOSTResources  (Example declaration of available external
  224.                          resources, e.g. fonts. Referenced by init.ps)
  225.  
  226.     - PATH_FONT         (Example file to demonstrate automatic font lookup
  227.                          by the resource mechanism. This should be copied
  228.                          into a directory "ENV:HWGPOST".)
  229.  
  230.     - postlib.h         (The include file with some infos on how to use
  231.                          new features of HWGPOST)
  232.  
  233.     - hwgpostlib.doc    (Docs on how to use the programmers interface of
  234.                          HWGPOST for your own programs)
  235.  
  236.     - post              (A hacked up post 1.7 frontend to try out HWGPOST.
  237.                          Nothing fancy)
  238.  
  239.  
  240. Don't ask me for my sources. Currently I have no plans whatsoever to
  241. release them in full or part to anyone. After reading through the History
  242. you might understand why.
  243.  
  244.  
  245. Special note on the 'post' frontend
  246. ===================================
  247.  
  248. The included 'post' frontend is a major (ugly) hackup of the original
  249. (ugly) source to suit my testing needs. It may or may not do what you
  250. expect and it might or might not be compatible to the original 'post'.
  251. Anything can happen. If you don't get the output you expect, please send me
  252. a detailed bug report and fall back on PostView or the old 'post' frontend
  253. for now.
  254.  
  255. To get more information on the supported options try 'post ?' and type
  256. another '?' at the command line template. For gray scale displays,
  257. play with the MAXDEPTH option. On an A2024, 'MAXDEPTH=2' and
  258. 'DISPLAYID 0x41000' give rather nice results compared to the standard
  259. B&W setup.
  260.  
  261. You won't be able to use your display HW to the fullest as the hacked up
  262. frontend does not check the display database at all.
  263.  
  264.  
  265. Installation
  266. ============
  267.  
  268. 1. Save your existing post.library, init.ps, and post. HWGPOST might break your
  269.    setup and I don't want you to be out in the cold.
  270.  
  271. 2. I am sure you have the POST: and PSFONTS: assigns that are needed for post 1.7.
  272.    If not. Create them, and put all your type 1 fonts into PSFONTS:
  273.  
  274. 3. Put init.ps, HWGPOSTResources, and (if you want to) post into POST:
  275.  
  276. 3.1 Edit HWGPOSTResources for _your_ font setup in PSFONTS: You'll probably
  277.     need to throw out and add some lines.
  278.  
  279. 3.2 Put PATH_FONT into "ENV:HWGPOST". Edit it to suit your needs. For a
  280.     permanent setup, copy it into ENVARC:HWGPOST, too!
  281.  
  282. 4. Copy your choice of post.library[.020] into LIBS:
  283.  
  284. 5. Shut down any running applications using post.library and do an "avail
  285.    flush".
  286.  
  287. 6. Try HWGPOST and send me detailed bug reports with reproducable examples!
  288.  
  289.  
  290. My TODO list
  291. ============
  292.  
  293. Well, lots of stuff as time permits:
  294.  
  295.     - Finish up Binary Object Sequences
  296.     - User path operators
  297.     - missing filters
  298.     - device parameters
  299.     - insideness operators
  300.     - missing color spaces
  301.     - rest of the Level 2 graphics stuff
  302.     - VM garbage collection
  303.     - whatever else is needed for a languagelevel of 2
  304.  
  305.  
  306. My Address
  307. ==========
  308.  
  309.  *  Heinz Wrobel
  310.  *  Karlstr. 16
  311.  *  82131 Gauting
  312.  *  Germany
  313.  *  FAX +49 89 850 51 25 (I don't like phone calls)
  314.  *  <heinz@hwg.muc.de>
  315.  
  316. Have fun!
  317.  
  318. Heinz Wrobel
  319.  
  320.