What you need

While you're at it, you should also download Ghostview 4.4 for OS/2 (ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/ghostgum/gsv44os2.zip). It is a graphical front end for Ghostscript. On top being a pretty interface, it makes installation a lot easier. If you have Ghostscript and Ghostview, installation is simple. Unzip only the Ghostview archive, which should be in .ZIP format. Make sure the Ghostscript archive is in the same directory, but do not unzip it!. Now run OS2SETUP.EXE from Ghostview and follow the prompts in the installation program. That's it! (If you don't want Ghostview, you'll have to read the instructions on how to install Ghostscript by itself). Ghostscript is super handy, it will even let you view the newer messed up .PDF files that Acrobat Reader 3 chokes on. You can also use it to convert Postscript or EPS files to PCX, BMP, PNG, GIF or JPEG image files. [Those newer .PDF files really are messed up. It isn't OS/2's fault. The "bug" was in Adobe Acrobat 4, but has since been fixed in Adobe Acrobat 5, so if you find a buggy .PDF, you'll know it was generated by someone who used Acrobat 4 and didn't read the instructions on how to fix the problem].

Method 1: Use Ghostview/Ghostscript manually

Step 1: Prepare your document in whatever program you like. (e.g. WordPro, DeScribe, Mesa, etc). Nothing new or special here, isn't that simple?

Step 2: Print your document. For the printer, don't forget to choose the Postscript printer you installed, and be sure to check the "Print to file" option if it's available. If it is not available in the print dialog (e.g. IBM Works), then you need to manually setup the printer driver. I haven't seen any application which doesn't have a "Print Setup" option. It will take you directly to the dialog which configures the printer.

By default, printers are set to print to "Printer", of course. You need to change it to "Raw Postscript file" and you'll also need to enter a filename. If you want a new filename, sorry, you'll have go to the setup each time you print and type in a new filename, else it will ask if you want to overwrite the old one.

Step 3: Go find the Postscript file you just printed out. If you have Ghostview setup properly, you should be able to just double-click on the file and it will open it up with Ghostview. Don't worry, almost finished, it takes longer to describe than to do.

Step 4: Now in Ghostview, go to the "File->Convert" menu. It should pop up a dialog like this one. Be sure to select "pdfwrite" for the device if you want to create a .PDF document.

If you just click "Ok", it will prompt you for a filename to save the .PDF file as and then go ahead and convert the file. But I should point out a few things about the conversion.

• By default, for some reason, it only selects the current page to convert. You need to specifically press the "All Pages" button to convert all the pages. (Or, of course, just the even or odd pages too, if you wish).
• I think by default, it sets the resolution to 72. That's 72DPI, which is usually fine for on-screen viewing, since that is the pixel density of most monitors. If you intend for the document to print out at all, I recommend a mininum of 300DPI. The difference can be very noticeable, especially on pictures. Increasing the resolution can greatly increase the resulting file (it seems to depend on the quality of the original picture and what format, if not .PDF, you are converting to). If it's all text, it probably won't grow the file size much.
• The "Properties" button allows you to set various options with .PDF files, such as limiting it to Acrobat 3 compatibility, font resolution and compression, and various other Acrobat options which I know nothing about.
• Ghostscript has a known bug in that certain fonts used in your document that it doesn't "know" about, or doesn't have a substitute for, it will render as bitmap fonts in the .PDF file. These tend to look horribly chunky under Acrobat Reader 3 for OS/2, but they look fine on Acrobat 4 and up on other platforms and the file will print out just fine. (If you want to delve in into the vagaries of the FONTMAP file and tell us how to tell Ghostscript which fonts to substitute and when, I'd really appreciate it. There is documentation included in the Ghostscript package).

Now if this still sounds too complicated for you, then you are ready for something more automated...

Method 2: Using ePDF or PMPDF

I'll describe PMPDF, but ePDF is very similar (maybe it even springs from the same code). PMPDF comes as a WarpIn (http://www.xworkplace.org/proj_warpin.html) archive, so installation is really easy. It even sets up a printer object for you clearly labelled "PDF Writer". The only thing it asks for during installation is the location (path) to your Ghostscript installation. (One thing to note, when you setup the configuration for PMPDF, select the output to be "Screen", not "Default", "Printer" or "Pre-Press", these won't work. The dialog does note which one is OS/2 compatible anyways).

Once it is setup (no reboot required), creating .PDF's are really easy. Just print your file to "PDF Writer" and that's it. No messing around, you don't even have to change any settings to "Print to file" or whatever. Just hit "Print".

A little dialog will pop up asking you where to create the file. Just select the directory, type in the filename and click "Write PDF". It's that simple! File creating happens in the background so you can go about doing other things (if it's a particularly large file). It will give an audible beep when it is finished.

Font Tips

From there, work your way to the "Font Manager" tab so you can add other fonts. I think by default, no font files are loaded into printer memory.

You can add any Postscript font you want. What you'll want is the .PFB file that goes with the font. If you get it wrong, you'll get an error message, so don't worry. Does it help to add fonts? Probably, though I haven't gone too much into the details to be able to report it here. I always just stick with a couple of fonts that I know work.

If you want your documents to always look good, "Helvetica" always works. Sometimes Helvetic Italic can be a problem, so you can substitute Helvetica Oblique, unfortunately this doesn't look italicized on screen. By default (i.e. no FONTMAP tweaking), I've found some fonts work well, and some do not. I've got the PS fonts that came with OS/2 and Lotus Smartsuite. Grouped by somewhat similar appearance:

• Courier works well. Courier New does not.
• Wingbats, Wingdings, StarBats and StarMath work nicely.
• New Century Schoolbook, ITC Bookman, ITC Zapf Bookman, Zapf Chancery, Palatino and Palatino Roman work well, but Palatino Roman Bold does not.
• Gill Sans works well. Garamond works, but Garamond Italic and Bold do not.
• ITC Avant Garde Gothic works.. Arial and Albertus don't work well.
• None of the Unicode fonts, Times Roman MT 30 and Monotype Sans work well.

All the above assumes that you have "Use printer device fonts" and "Use downloaded fonts" selected in the "Job Properties" setup. This is already done by default in PMPDF, but you won't be able to do this to work around the WordPro problem I describe below.

Using Freelance Graphics

This will take you to the "Properties" page which you can setup (just like the screenshot described earlier on) the printer to print to "Raw Postscript file". When you print from Freelance then, print as normal (do not click "Print to file"), and a proper Postscript file will be generated. Remember to undo this if you are printing from another application.

Using WordPro

If you are just preparing a plain text document, with no mathematical formulas, you should have no problem. If you do use equations, then you are in for a rough ride. These apply whether you use ePDF, PMPDF or the "manual" method or even printing to a printer! It's a basic problem with WordPro printing to Postscript. Here are some rough rules that I follow to try and make things work.

• When you set up the printer driver "Properties" (see screenshot earlier on, it's the same place where you select print to "Printer", "Raw Postscript file" or "Encapsulated postscript file"), you must be sure to have "Use printer device fonts" selected, but "Use downloaded fonts" not selected. If you select "Use downloaded fonts", your first equation will look very pretty. Unfortunately, all following equations will not print. They will be blank. If you use the settings I suggest, the equations will convert to bitmap fonts in the .PDF, but at least they will print properly!
• Do not use underline characters in your document. Anywhere. Immediately following where you use an underline, your equations will not come out properly. They may be missing lines (e.g. for fractions) or other things. Instead, select the text and make it have a line drawn underneath if you want underlining.
• The font you use for the equations should be "Times New Roman". Some other ones may work, not "Times" or "Tms Rmn", so you'll have to play and find out. This is a shame because Ghostscript will convert "Times New Roman" to a bitmap font, but not "Times".
• Don't end your document with an equation. The last line should be regular text. (I'm not very sure about this one).
• On the same line as your equation, need to have some printing character, for example, even a space will do. (I'm even less sure about this, and also seems to depend on the revision of WordPro I'm using. It is v1.7.1 right now).

I really don't know what's going on. It's very difficult to get any document with equations printed properly (screen or printer!). If any of you have a subscription contract with Lotus, please get them to fix this bug. StarOffice seems to print equations just fine, and even WordPro seems to handle it nicely if I print to a PCL printer.

At the very least, if you understand this bug and know exactly how to work around them, please, please, please let me know. WordPro is the only wordprocessor (except LaTeX, ugggh!) which has the features I need, but for this one killer bug.

Conclusion

Related Links

This article is courtesy of www.os2ezine.com. You can view it online at http://www.os2ezine.com/20030416/page_5.html.