home *** CD-ROM | disk | FTP | other *** search
/ Mega Top 1 / os2_top1.zip / os2_top1 / APPS / TEKST / PSUTILS / README.OS2 < prev    next >
Text File  |  1994-01-21  |  5KB  |  105 lines
  1. This is an OS/2 port of Angus Duggan's PostScript Utilities
  2. for manipulating PostScript documents.
  3.  
  4. Page selection and rearrangement are supported, including arrangement
  5. into signatures for booklet printing, and page merging for n-up printing.
  6.  
  7. This port is based on the original Release 1 Patchlevel 13 sources
  8. available from:
  9.         ftp.dcs.ed.ac.uk: /pub/ajcd/psutils.tar.Z
  10. The original sources are also included in this archive in the
  11. src subdir. The original author address is (angus@harlequin.co.uk).
  12.  
  13. ABOUT THE UTILITIES
  14. -------------------
  15. There are three kinds of utilities in this archive: compiled exe files,
  16. Unix shell scripts and perl scripts. The scripts have been arranged into
  17. OS/2 command files (.cmd files) which run directly from an OS/2 command
  18. prompt. However a Unix like shell and a perl interpreter are required.
  19.  
  20. Converted Unix shell scripts are configured for Ian Stewartson's
  21. (istewart@datlog.co.uk) Unix like shell for OS/2. It is available
  22. as the file ms_sh22b.zip at many popular ftp sites (e.g. oak.oakland.edu
  23. and ftp-os2.cdrom.com). Converted shell scripts require a Unix
  24. like cat program in your path. A Unix like cat may be found in the GNU file
  25. utilities (gnufutil.zip also available from ftp-os2).
  26.  
  27. Converted perl scripts require an OS/2 perl interpreter. I used that
  28. available from ftp-os2.cdrom.com: /pub/os2/2_x/unix/perl4036.zip.
  29.  
  30. Compiled exe files represent the main utilities in the package. Shell and
  31. perl scripts, in fact, are mainly filters for fixing the PostScript output
  32. of several Unix, DOS/Windows and Macintosh applications. These exe files
  33. have been ported and compiled using Eberhard Mattes' emx/gcc 0.8h for OS/2.
  34. They won't work under DOS since they were compiled using the -Zomf switch.
  35. Furthermore they need two OS/2 dll files (emx.dll and emxlibc.dll) included
  36. in this archive.
  37.  
  38. INSTALLING THE UTILITIES
  39. ------------------------
  40. Unpack this archive in any temporary directory, e.g. D:\TEMP
  41. For a full use of the package an HPFS partition is mandatory. Otherwise
  42. your resulting files would have their names truncated to 8+3 FAT limits.
  43. The shell scripts won't work any more in a FAT partition unless you edit
  44. them properly.
  45.  
  46. Move all the files in the exe/ and cmd/ subdirs to the directory where
  47. you usually keep your Unix like stuff, e.g. D:\BIN
  48.  
  49. Edit getafm.cmd and showchar.cmd. Change the first line of these files
  50. according to the directory where you installed these scripts.
  51.  
  52. Move emx.dll and emxlibc.dll in the dll/ subdir to any subdirectory in
  53. your LIBPATH. Do not overwrite newer dll files with the same name.
  54. The included dll come from emx 0.8h fix package 2 (dated January 8, 1994).
  55.  
  56. Move all the man pages in the man/ subdir to their proper place,
  57. e.g. d:\man\man1 if you have both a Unix like man and groff installed.
  58. Edit these files, if at all needed, to reflect the proper directories.
  59.  
  60. REBUILDING THE UTILITIES
  61. ------------------------
  62. All source code patches are in the patches.os2 file. Use Larry Wall's patch
  63. program to apply them. The resulting modified makefile runs under GNU make
  64. or dmake (I used GNU Make 3.68) directly from an OS/2 command prompt.
  65.  
  66. However a number of Unix like utilities and other GNU stuff are required.
  67. Namely you need: sh, perl, cat, install, head, tail, chmod, man, groff
  68. and maybe something else.
  69.  
  70. The OS/2 makefile is heavily modified with respect to the original one.
  71. I was unable to get all this stuff working together in a smooth way.
  72. The biggest problem was with the script ./maketext running under GNU Make
  73. running under Stewartson' shell. Therefore I arranged the makefile to call
  74. perl directly with ./maketext as an argument. The whole thing now runs
  75. under plain cmd.exe of OS/2.
  76.  
  77. As to C source code patches they are quite trivial.
  78. A highlight of modifications:
  79. - Changed seekable() in psutil.c to avoid Unixism (unlink of an open file)
  80. - Changed seekable() in psutil.c to restore pipelining of utilities.
  81.   This feature was disabled for MS-DOS and required a different temporary
  82.   file creation method.
  83. - Changed almost all fopen calls from "r" to "rb"
  84. - Changed almost all fopen calls from "w" to "wb"
  85.  
  86. Sources are compiled using the switches -Zomf -Zmtd in order to save disk
  87. space for compiled exe binaries. Hence they need both emx.dll and emxlibc.dll
  88. in your LIBPATH. Executables run under OS/2 2.x only and there is no MS-DOS
  89. support for the emx DOS extender.
  90.  
  91. -----------------------------------------------------------------------------
  92. Dr. Michele Marziani                            January 14, 1994
  93.  
  94. Dipartimento di Fisica
  95. Universita' di Ferrara
  96. Via Paradiso, 12
  97. I-44100 Ferrara FE
  98. I T A L Y
  99.  
  100. Internet: marziani@ferrara.infn.it
  101. DECnet:   39967::MARZIANI
  102.  
  103. Tel:  +39 (532) 781811
  104. Fax:  +39 (532) 781810
  105.