                      GEM(R) Desktop Publisher(TM)

                               README.DOC

                              October 1988

   This file contains important information about GEM Desktop Publisher, 
   Release 2, Fontware(TM), and the Font Merge Utility.  You can print this 
   file and keep it with your documentation for reference.  In addition, be 
   sure to read any release notes included in your GEM Desktop Publisher 
   package.  

 
Using The GEM Desktop Publisher "To App" Function
-------------------------------------------------

      Page 8-3 describes this function and paragraph one on page 8-4 should
      read as follows:-
      
      		When you exit the application you will automatically be
		returned to Publisher where you left off in the document
		that was being worked on.
		

Using GEM Desktop Publisher Sample Documents 
-------------------------------------------- 

      Three sample documents are supplied as examples. The Publisher 
      installation program gives you the choice of whether or not to 
      install these documents.  If you elected to install them, you will 
      find them in the \GEMAPPS\GEMPAGES folder on the disk drive on which 
      you installed Publisher.

      If you intend to print the sample documents before editing them, open 
      and save each document in Publisher. This creates a file for the 
      document having the extension .GMP, which GEM Output requires in 
      order to print it. Follow these steps:  

      1. Open a document using the Open command (File Menu). 
      2. Immediately choose the Save as... command.  When the Item 
         Selector appears, double-click on the document name. 
      3. Publisher displays an alert that says a document with this name 
         already exists and asks if you want to replace it.  Click on OK. 
      
      Repeat these steps for each additional document.

      
GEM Desktop Publisher General Information: 
------------------------------------------ 

   1. For best performance, always add the largest text file to your 
      document first.

   2. You must display each page of your document ON THE SCREEN before it 
      actually becomes part of the document. For example, let's say your 
      text file should result in a ten-page document. If you format only 
      the first two pages before you save the document and print it, the 
      resulting document will be only two pages long. (You might want to do 
      this as a means of checking your formatting before you finish the 
      document.) To get the full ten-page document, you must press PgDn for 
      each page to make it appear on the screen.
         
   3. Publisher has the following per-document limits:

                    Item               Limit 
                  ----------------------------
                    Files                 64 
                    Pages                100 
                    Rectangles           256 
                    Paragraph Styles      32 
                    Graphic Elements     500

 
   4. Do not store text or graphics files for your Publisher documents in 
      folders whose names have extensions. For example, you can store files 
      in a folder named REPORTS; if you store them in a folder named 
      REPORTS.APR, their names will not appear in the Mini-Selector.  

   5. Publisher does not allow you to copy a document to the folder in 
      which it is already located (in other words, on top of itself). If 
      you attempt to do so, Publisher displays an alert.

   6. In GEM Output, use the Make Fit setting for the Scale option (Printer 
      or Plotter command--Preferences Menu) when printing 8 x 10 pages on 
      the following devices:  

                  Quadram(R) QuadJet(TM) 
                  Hewlett-Packard(R) ThinkJet(TM)

      Because these devices define a graphics page as less than 8 x 10 
      inches, they print an 8 x 10-inch page on two separate sheets unless 
      you use the Make Fit setting.

   7. Publisher has three separate paste buffers (temporary storage for cut 
      and paste operations) -- one for pasting text, one for pasting 
      rectangles and one for pasting graphic elements. If you want to paste 
      text, you must be in Text mode. If you want to paste rectangles, you 
      must be in Select or Rectangle mode. If you want to paste graphic 
      elements, you must be in Graphics mode.

   8. If you are creating your own keyboard mapping file and use any 
      character other than a space or a tab at the end of the keystroke 
      hexadecimal code, the code is ignored. See Appendix A of the GEM 
      Desktop Publisher User's Guide.

   9. While the screen is redrawing on some high-resolution monitors 
      running on slow (PC or XT) systems, you can display a menu and choose 
      a command that will be unavailable (grayed out) after the redraw is 
      finished. Choosing unavailable commands can have extremely serious 
      consequences. In this case, wait until the redraw is finished and the 
      mouse form is no longer a cross hair before choosing commands.

  10. There is no alert to warn you if you are about to copy over a 
      document using the Copy Document command. For example, if you had a 
      document named NEWS1.GWD in C:\NWSLTTRS, and you used Copy Document 
      to copy another file name NEWS1.GWD into C:\NWSLTTRS, you will not be 
      warned that the document already exists and will be replaced by the 
      newer version.

  11. If you start Publisher with no disk space, Publisher will send you 
      back to the GEM Desktop. You must then:

        1. Leave the GEM Desktop using the Quit command.
        2. Delete files or otherwise clear some space on your disk.
        2. Start the GEM Desktop again by typing the GEM command at the 
           command line.

      You can then start Publisher by any of the methods described in 
      Section 2 of the user's guide.

 12. Publisher needs a minimum amount of memory that can be checked by the 
     following procedure. From the GEM Desktop:

        1. Choose Enter DOS Commands from the Options menu. 
        2. Run the CHKDSK command from the operating system command line. Refer to 
           your operating system manual for further details. 
        3. Note the last number displayed on the screen, on the 
           line that says "free bytes". 
        4. Type "exit" to get back to the GEM Desktop.

      If the number on the last line that tells you the number of "free 
      bytes" is less than 359000, you probably will not be able to run 
      Publisher. This can happen if you have a number of memory-resident 
      programs like Sidekick (TM) or drivers such as disk caches or EMM 
      drivers. You can increase this number by changing your GEM system in 
      the following ways:

        1. Select a monochrome screen in GEMSETUP instead of a color screen. 
        2. Rename your desk accessories to remove them from memory.

      In either case, you must exit the GEM Desktop and re-enter it. If 
      doing both these actions still does not give you enough memory to run 
      Publisher, you must then remove some of your non-GEM memory-resident 
      programs or drivers.

 
Text Files in Publisher 
----------------------- 

   1. The GEM system software limits lines of text to a maximum of 128 
      characters. If a line is longer than 128 characters, Publisher 
      automatically wraps the word containing the 129th character to the 
      next line. There are two circumstances under which this word wrap can 
      occur:

      *  When you are using 7-point text.  7-point text reaches the 128-
         character limit within a rectangle that is 4 or 5 inches wide, 
         depending on the text itself.  If your rectangle is wider, the 
         text does not extend fully to the right edge of the rectangle.

      *  When you are in Landscape mode.  In this case, the character 
         limit also affects 10-point text if the text rectangle uses 
         the full width of the page.            

   2. If the first tab stop for the current paragraph style is greater than 
      the width of the rectangle, Publisher displays the "Word too long" 
      alert, even if the tab is not inserted in the text. No text appears 
      in the rectangle from that point on. To restore text to the 
      rectangle, reset the first tab stop to a setting that falls inside 
      the rectangle. You might have to enlarge the rectangle temporarily so 
      you can select the tabbed text.  

      The "Word too long" alert is also displayed if, in Text mode, you 
      mark a block of text that includes the first word of a paragraph, 
      then use the Character command to change its size such that the first 
      word doesn't fit in the rectangle. To restore text to the rectangle:

      1. Switch to Select mode and enlarge the rectangle until 
         the text is redisplayed.

      2. Switch to Text mode and select the oversized text.

      3. In the Mini-Selector, click on Normal.  This returns the text 
         to its original size.

   3. Files created in IBM(R) DisplayWrite4(R) that contain lines and/or 
      boxes cannot be translated successfully by Publisher. Some residue of 
      the lines or boxes may appear on the Publisher screen. To use these 
      files, remove the lines or boxes in DisplayWrite4.

   4. In justified text, if a short word (usually two or three characters 
      long) is all by itself on a line, the spaces between letters in the 
      word can become very large. This usually happens only in very narrow 
      rectangles. In effect, the word is trying to justify itself to the 
      available space in the rectangle. To restore the word's normal letter 
      spacing, you can use a small phantom rectangle to push the letters 
      back together, or you can left-align the text.

   5. Inserting a tab as the last character in a paragraph causes lines and 
      paragraphs following the tab to break incorrectly. Delete the tab to 
      correct this problem.

   6. If you open an ASCII (non-WP mode) file in GEM 1st Word Plus, save it 
      in WP mode, and then read it into a Publisher rectangle, every word 
      will be tabbed. (It may look fine in GEM 1st Word Plus.) To avoid 
      this problem, make sure you use the Convert utility to convert the 
      ASCII file to a GEM 1st Word Plus file before you open and edit the 
      file in GEM 1st Word Plus.

   7. In Release 2, Publisher converts any occurrence of three or more 
      consecutive spaces to a single tab character. This might cause 
      problems if, in your word processor, you use spaces instead of the 
      justification command to fill out lines. For example, if you have 
      Justification On in WordStar(R) and you edit a paragraph and then 
      insert spaces to fill out the line, any groups of three or more spaces 
      will show up as tabs in Publisher. If you consistently use the word 
      processor's justify command (^B in WordStar), this problem will not 
      arise.

   8. The GEM 1st Word Plus and GEM Write word processing filters do not 
      preserve empty paragraphs (created by hitting the return key at the 
      beginning of a line). All the other filters do preserve the empty 
      paragraphs. Preserving empty paragraphs causes the text to appear to 
      have more space between paragraphs in Publisher than in the word 
      processor that created the file, since each empty paragraph includes 
      space above and space below values as well as the single empty line 
      of the paragraph. You can delete these empty paragraphs using your 
      word processor or using Publisher's Text mode.

   9. If you have text that has a style attribute (bold or italic, for 
      example) and that wraps from one line to the next, under some 
      conditions the second line will be drawn without the attributes. For 
      example, make a paragraph bold by highlighting the paragraph in Text 
      (not Paragraph) mode and applying the bold attribute. Scroll so that 
      only the first line of the paragraph is visible at the bottom of the 
      screen; then scroll so that the second line becomes visible. The 
      second line might not be bold. This is a drawing problem only and can 
      be corrected by changing view levels or scrolling some more. This 
      problem will not occur if the bold attribute was applied in Paragraph 
      mode.


Font Considerations 
------------------- 

      POSTSCRIPT FONTS: After generating your fonts, you can reduce disk 
      space by deleting everything in the Fontware directory except:

        -  All files having the .TDF extension 
        -  The Fontware DDF subdirectory

      If you create a document with fonts other than Swiss(TM) and then 
      change width tables, you may see an alert that says:

                    Publisher found a font/size/style
                    combination that does not exist in
                    its width tables. Make sure you have
                    the correct width tables to match 
                    this document.

      This alert is displayed because your document contains fonts that do 
      not exist in the new width table. (Fonts are specified with the 
      Character command, either in Paragraph mode or Text mode.) You can 
      correct this problem by returning to your original width table. You 
      can then view the list of fonts in the Character dialog and edit your 
      new width table in Font Merge accordingly.

 
Changes to the Font Merge Utility User's Guide 
----------------------------------------------

   1. Section 2, "Creating Width Tables," states that there is one width 
      table supplied with Font Merge, POSTSCPT.WID, which is used unless 
      you create another width table. There are now several "default" width 
      tables from which to choose, each designed for a different typeface 
      set and/or printer type. You can select one of the default tables or 
      create a new one as described in the Font Merge user's guide.

      When you start Font Merge, immediately choose the Select Table option 
      to select a default width table that matches your printer type.


PostScript Printers 
-------------------       

      There are now two PostScript width tables -- POSTSCPT.WID (the 
      default) and PSTSCPT2.WID. They enable you to use the typefaces 
      listed below, which are RESIDENT in your PostScript printer. You need 
      neither purchase these typefaces nor install them on your system.  

      POSTSCPT.WID: Swiss                  PSTSCPT2.WID:  Swiss 
                    Dutch(TM)                             New Century 
                    Courier                                   Schoolbook 
                    New Century Schoolbook(R)             Palatino 
                    Palatino(R)                           Bookman 
                    Bookman (R)                           Zapf Chancery 
                    Avant Garde(R)                        Helvetica Narrow(TM) 
                    Symbol                                Avant Garde 
                                                          Zapf Dingbats

      You can change any typeface you wish; however, since these tables 
      contain the maximum number of typefaces allowed, you must delete a 
      typeface before adding another.  


Non-PostScript Printers    
----------------------- 

      Five default width tables are supplied for non-PostScript printers. 
      They contain the Swiss and Dutch typefaces. You can change these, add 
      more typefaces, or use the table as is.  

      Choose the table that corresponds to your printer type:

        Printer Type                            Width Table 
        ------------                            ----------- 
        - 300 dots-per-inch laser printers      300DPI.WID 
          [HP(R) LaserJet II(R)]         
        - 150 dots-per-inch laser printers      150DPI.WID 
          [HP LaserJet(R)]
        - Epson(R) LQ-Series                    EPSONLQ.WID
        - Epson-FX or MX                        EPSONFX.WID
        - Xerox 4020                            XRX4020.WID

         
Running Font Merge 
------------------
 
   1. When Font Merge is installed with Publisher on a hard disk, two data 
      files named PRINTERS.DAT and FONTLIST.DAT are installed in \GEMAPPS. 

      PRINTERS.DAT is only used when you've removed Fontware from your 
      system; it tells Font Merge which printers use which font files. 

      FONTLIST.DAT is used when installing non-Bitstream PostScript fonts; 
      GEM uses numbers to identify fonts, and this file tells Font Merge 
      which numbers match these non-Bitstream PostScript fonts.

   2. The new width tables provided with this release of Publisher are 
      improved and slightly different from those provided with earlier 
      releases.  The character spacing is tighter. This means that 
      documents created with earlier releases of Publisher may take up less 
      space.  For example, a paragraph that was four lines long may now use 
      only three lines if the last line was short.

      We recommend that you view all pages of your documents when you edit 
      them with the new release of Publisher, to check your line and page 
      breaks. You can, if you want, continue to use the width tables from 
      the previous versions of Publisher, but you will not have access to 
      any other fonts and you cannot use Font Merge to edit the old width 
      table.
 
   3. Before printing a Publisher document, save it while the width table 
      for the printer you intend to use is the current width table.

      If you have edited a document using a width table for a certain 
      printer, and want to change to another width table using a different 
      printer type, you must enter Font Merge and select the new width 
      table, then re-enter Publisher and save the document using the new 
      width table. See item 4 below.

      You can print any GMP file on any printer, but for optimal character 
      spacing you must save the file using the correct width table.

   4. If you change the printer type for a width table using the Select 
      Printer Type option, the old printer fonts that are not used in the 
      new table are not deleted from the width table. Use the Delete Font 
      and Delete Size options to remove them.

      Font typefaces and sizes are never automatically deleted from width 
      tables. Whenever you delete fonts or font sizes from the FONTS 
      folder, you must delete them in Font Merge as described above.

   5. Do not delete the current width table. If you do and then you attempt 
      to start Font Merge, an alert is displayed indicating that the width 
      table is an empty file. If you click on the OK button in this alert, 
      you are returned to the GEM Desktop.

      To correct this situation, make a copy of WTABLES.WID and give the 
      copy the same name as the width table named in the alert, that is, 
      the current width table.

   6. To use SoftFonts larger than 36 points, you must first create a width 
      table for the fonts 36 points or smaller and then add the larger sizes 
      to the width table. To add the larger fonts to your width table, use 
      the Add Size option for each point size greater than 36 points. 
