home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / wp / rubicon5.zip / MANUAL.APP < prev    next >
Text File  |  1989-10-07  |  22KB  |  529 lines
  1.                       _______________
  2.                      |               |
  3.                      |   APPENDIX    |
  4.                      |_______________|
  5.  
  6.  
  7. CONTENTS
  8.  
  9. A.1 Serial Output Devices
  10. A.2 Installation
  11. A.3 Configuration
  12. A.4 Printer Configuration Examples
  13.  
  14.  
  15. A.1 SERIAL OUTPUT DEVICES
  16.  
  17. As delivered, the Publisher is configured to utilize the MS-DOS printer
  18. driver, since it is believed that this will provide the most
  19. satisfactory installation for the majority of users. However, this
  20. configuration is NOT SUITABLE FOR MOST SERIAL PRINTERS or other serial
  21. output devices (e.g. phototypesetters) likely to be used with the
  22. Publisher. Most such devices require the Xon/Xoff handshaking protocol,
  23. which is not supported by the MS-DOS serial driver. To provide full and
  24. proper support for such serial output devices, the Publisher includes
  25. the "Greenleaf" serial driver, as an option. 
  26.  
  27. If you are using a serial output device, such as the serial Apple
  28. "LaserWriter", or a Hewlett-Packard "LaserJet" connected via a serial
  29. interface, you should therefore reconfigure the Publisher to use the
  30. "Greenleaf" driver. The procedure for doing this is explained below,
  31. under "Configuration".
  32.  
  33. A.2 INSTALLATION
  34.  
  35. As explained in Section 1 of this manual, the Publisher is supplied with
  36. an automatic installation program which, when invoked, creates a new
  37. directory, named RUBICON, on the designated drive (or on Drive C if no
  38. drive is designated), and copies the Publisher into it in normal
  39. (non-compressed) form. The support files needed for the type or types of
  40. printer designated by the user are also copied into the RUBICON
  41. directory, along with the default style sheet and configuration file,
  42. SETUP.TAG. 
  43.  
  44. If the user specifies installation for "LaserJet" printers (or for both
  45. "LaserJet" and "Postscript" printers, the installation program will
  46. create a further directory, named SOFTFONT, on the same drive, and if
  47. installation of the Rubicon soft fonts has been specified, it will copy
  48. these soft fonts (the Renner and Trajan families) into this SOFTFONT
  49. directory. 
  50.  
  51. There are really only two problems which can arise during the
  52. installation procedure. 
  53.  
  54. 1.   The installation program will abort if it finds an existing
  55.      directory on the designated drive named RUBICON or SOFTFONT. To
  56.      solve this problem, any such directory should be renamed or moved
  57.      to another drive, and the installation recommenced from the
  58.      beginning. Before recommencing installation, any directory or files
  59.      which the installation program copied to the designated drive
  60.      before it aborted, should be removed or deleted.
  61.  
  62. 2.   The installation program will abort if it determines that there is
  63.      insufficient disk space on the designated drive to accommodate the
  64.      installation. If sufficient sapce is avaliable on another drive,
  65.      this problem may be solved by simply changing the drive designation
  66.      for the installation. Otherwise, the only cure for this is to
  67.      provide more disk space by the conventional methods of cleaning up
  68.      the disk, deleting redundant and obsolete material, and archiving
  69.      seldom-used material.
  70.  
  71. The automatic program provides all the installation most users require,
  72. but some users may find it necessary or convenient to perform additional
  73. installation steps, as described below, to provide access to the
  74. Publisher from any directory, to gain access to additional "LaserJet"
  75. fonts, or to reconfigure their MS-DOS system to permit more files to be
  76. open simultaneously. 
  77.  
  78. A.2.1 ACCESS FROM ANY DIRECTORY
  79.  
  80. It is convenient to be able to use the Publisher from any directory,
  81. instead of having to change to the directory in which it was installed
  82. for each use. This may be achieved by: (1) inserting a PATH command in
  83. the file AUTOEXEC.BAT in the root directory, or amending the existing
  84. PATH command in that file, to designate the directory where the
  85. Publisher is located (normally C:\RUBICON) as part of the path the
  86. computer searches when given a command; and (2) inserting a SET command
  87. in the file AUTOEXEC.BAT in the root directory, to define the Publisher
  88. "environment variable" RUBICON equal to the directory (normally
  89. C:\RUBICON) where the Publisher's support files are located. 
  90.  
  91. The file AUTOEXEC.BAT can be accessed and edited using any suitable text
  92. editor. Typically, it will already contain a PATH command, like: 
  93.  
  94. PATH=C:\ABLE;C:\BAKER;C:\CHARLIE
  95.  
  96. which can be amended to: 
  97.  
  98. PATH=C:\ABLE;C:\BAKER;C:\CHARLIE;C:\RUBICON
  99.  
  100. If there is no existing PATH command, the line
  101.  
  102. PATH=C:\RUBICON
  103.  
  104. can be inserted into the file.
  105.  
  106. A suitable SET command, which will normally be:
  107.  
  108. SET RUBICON=C:\RUBICON\
  109.  
  110. must also be added to the AUTOEXEC.BAT file. The new version of this
  111. file must be copied back to the root directory to replace the original
  112. version. IT WILL TAKE EFFECT THE NEXT TIME THE SYSTEM IS BOOTED. 
  113.  
  114.  
  115. If there is no file AUTOEXEC.BAT, one can be created by the usual method
  116. of file creation. A full explanation of the SET and PATH commands and
  117. the function of the AUTOEXEC.BAT file will be found in your operating
  118. system (MS-DOS) manual. 
  119.  
  120. A.2.2 ACCESS TO LASERJET SOFT FONTS
  121.  
  122. If you are using a "LaserJet" or "LaserJet II" printer, or a printer set
  123. up to emulate one of these, the Publisher will need to have access to a
  124. suitable set of soft fonts, to take full advantage of its capabilities.
  125.  
  126.  
  127. RUBICON FONTS
  128.  
  129. The Publisher is supplied with two complete families of Rubicon soft
  130. fonts: Trajan, a "Times"-style serif typeface of traditional appearance,
  131. suitable for extended passages of text, and Renner, a modern sans-serif
  132. typeface, suitable for use where a contrasting typeface is desired, for
  133. example in headings. Both families are supplied in regular, bold-face
  134. and oblique (italic) forms, in even point sizes 8 through 14, and in
  135. bold-face only, in point sizes 18, 24 and 30. 
  136.  
  137. If you install the Publisher using the Installation Program, and specify
  138. "LaserJet" printers and installation of the Rubicon fonts, these Rubicon
  139. fonts will be installed automatically in a location accessible to the
  140. Publisher, and you will be able to use them as described in Section 3.3
  141. of the Manual, without any further installation steps. 
  142.  
  143. HEWLETT PACKARD FONTS
  144.  
  145. If you obtain, or already have, copies of the TmsRmn and Helv soft fonts
  146. distributed by the Hewlett-Packard Company as Part No. 33411AD or
  147. 33412AD, you can use these fonts with the Publisher, as described in
  148. Section 3.3 of the Manual, PROVIDED that you perform the following
  149. installation steps. 
  150.  
  151. 1. Arrange Proper Soft Font Location.
  152.  
  153. The location where the Publisher looks for soft fonts is determined by
  154. the instruction tag <font_path= > in the initialization sequence. As
  155. supplied, the default configuration/style sheet file SETUP.TAG contains
  156. the tag <font_path=SOFTFONT>. Unless this instruction is over-ridden by
  157. a subsequent <font_path= > tag in the initialization sequence (that is,
  158. at the beginning of a document file, or in a file included at the
  159. beginning of a document file), the Publisher will look for soft fonts in
  160. the directory SOFTFONT on the same drive where the Publisher itself is
  161. located. 
  162.  
  163. To access your Hewlett-Packard fonts, you must therefore either place
  164. copies of them in the SOFTFONT directory, or place in the initialization
  165. sequence a suitable <font_path= > tag to identify the directory (and
  166. drive, if different from the drive where the Publisher is located) where
  167. they are to be found. For example, if the Hewlett-Packard fonts are
  168. located in a directory called HPFONTS on Drive D, the suitable tag would
  169. be <font_path=D:\hpfonts\>. 
  170.  
  171. If all the soft fonts you will be using are in a single directory (which
  172. is the preferred setup), that directory should be specified in the
  173. <font_path= > tag in the SETUP.TAG file. If you will be using soft fonts
  174. from more than one directory, the soft font directory most frequently
  175. used should be specified in SETUP.TAG, and suitable <font_path= > tags
  176. should be placed at the beginning of individual document files which
  177. require fonts from other directories. 
  178.  
  179. NOTE: Since the <font_path= > tag must appear in the initialization
  180. sequence, ALL SOFT FONTS used in a single document must be located
  181. in THE SAME DIRECTORY.
  182.  
  183. 2. Arrange Proper Soft Font File
  184.  
  185. Names
  186.  
  187. The copies of the Hewlett Packard TmsRmn and Helv fonts which are to be
  188. accessed by the Publisher MUST have the file names recognized by the
  189. Publisher. For example, the file containing the TmsRmn 12 point medium
  190. ("regular") portrait font must be named TR120RPN.SFP; the file
  191. containing the Helv 24 point bold portrait font must be HV240BPN.SFP,
  192. and so on. 
  193.  
  194. The set of Hewlett Packard fonts uses slightly different file
  195. nomenclature: in the file name extensions, `R8' appears instead of `SF';
  196. for example the file known to the publisher as TR120RPN.SFP is called
  197. `TR120RPN.R8P', and so on. It is necessary to change the names of the
  198. copies of these fonts which are to be used by the Publisher, by changing
  199. the `R8' in the filename extensions to `SF'. This can be done using the
  200. normal MS-DOS "rename" command, in the following command line:
  201.  
  202. REN *.r8? *.sf?
  203.  
  204. Of course, if these fonts are also being used with other software which
  205. requires the original Hewlett Packard names, it will be necessary to
  206. maintain two sets of copies of them. 
  207.  
  208. NOTE: If you will be using Hewlett Packard fonts EXCLUSIVELY, you may
  209. wish to delete the Rubicon fonts from your hard disk (or refrain from
  210. installing them in the first place) to conserve disk space. However, the
  211. Publisher, as distributed, specifies Trajan 12 point as the default
  212. Laserjet soft font.  If the Rubicon fonts will not be accessible to the
  213. Publisher, this MUST BE CHANGED to a suitable Hewlett Packard font, such
  214. as TmsRmn 12 point.  To do this, you must amend the default setup/style
  215. sheet file SETUP.TAG to replace the tag <Trajan12M> with a tag
  216. specifying the desired Hewlett Packard font, such as <Times12M>. 
  217.  
  218. A.2.3 INCREASING OPEN FILES LIMIT
  219.  
  220. For certain types of document, the Publisher may require as many as 10
  221. files to be open simultaneously. MS-DOS permits only 8 files to be open
  222. simultaneously, unless it has been configured to permit a larger number.
  223. Fortunately, the configuration procedure is simple. 
  224.  
  225. You can configure your MS-DOS system to permit 10 files to be open
  226. simultaneously by ensuring that the root directory of the system disk
  227. contains a file named CONFIG.SYS which contains the line
  228.  
  229. FILES="n"
  230.  
  231. where "n" is an integer (whole number) between 10 and 255. The file
  232. CONFIG.SYS can be created (if it is not already present the root
  233. directory) by the normal methods of file creation, and can be edited
  234. using any suitable editor. If the CONFIG.SYS file already exists, it may
  235. already contain a FILES command. If such a command specifies a number
  236. less than 10, it should be amended to specify a larger number. If the
  237. CONFIG.SYS file contains no FILES command, a new line such as 
  238.  
  239. FILES=12
  240.  
  241. should be inserted.
  242.  
  243.  
  244. A.3 CONFIGURATION
  245.  
  246. The publisher is configured using instruction tags placed in the
  247. initialization sequence, i.e. the material which the Publisher reads
  248. before reaching any printable text in the document file being published.
  249. The first item in the initialization sequence is always the file
  250. SETUP.TAG, and the configuration tags in SETUP.TAG will be operative
  251. unless over-ridden by subsequent configuration tags later in the
  252. initialization sequence, i.e. in the document file, or in a file
  253. INCLUDED in the document file, before any printable text. That is, the
  254. configuration defined by SETUP.TAG is the default configuration. 
  255.  
  256. Accordingly, the configuration of the Publisher may be changed for a
  257. particular document by placing configuration tags in the document file
  258. (or in a file INCLUDED in the document file) before any printable text.
  259. The default configuration may be changed by inserting, deleting or
  260. amending configuration tags in SETUP.TAG, using any suitable text
  261. editor. 
  262.  
  263. If "LaserJet" printers are specified when the Publisher is being
  264. installed (alone or together with "Postscript" printers), SETUP.TAG (as
  265. supplied) configures the Publisher to drive a "LaserJet" printer via the
  266. MS-DOS printer driver, to obtain its soft fonts from the directory
  267. SOFTFONT, and to automatically download all fonts required for the
  268. document being published. 
  269.  
  270. The following tags may be used to reconfigure the Publisher.
  271.  
  272. PRINTER DRIVER
  273.  
  274. <driver=>  Microsoft: Microsoft printer driver
  275.            Greenleaf: Greenleaf serial driver
  276.  
  277. An alternative serial printer port driver, from Greenleaf, has been
  278. included in the Publisher. It contains many serial port features not
  279. available in the Microsoft's MS-DOS serial driver. Features of
  280. particular note are Xon/Xoff support, transmission rates up to 19,200
  281. baud, and two-way serial communications (allowing the Publisher to
  282. receive error and status messages from devices that send them). 
  283.  
  284. Some printers, like the serial Apple "LaserWriter", cannot be driven
  285. through the Microsoft port driver, so "Greenleaf" must be used instead.
  286. The Publisher can drive many Postscript phototypesetters directly, via a
  287. serial interface. 
  288.  
  289.  
  290. PROTOCOL TAG FOR THE "GREENLEAF" SERIAL DRIVER:
  291.  
  292. <protocol port=1 baud=9600 parity=3 stopbits=1 databits=8 xonxoff=1>
  293.  
  294. <port=>  Port Number
  295.          1: COM1
  296.          2: COM2
  297.          3: COM3
  298.          4: COM4
  299.  
  300. <baud=>  Baud Rate
  301.          50
  302.          75
  303.          110
  304.          134
  305.          150
  306.          300
  307.          600
  308.          1200
  309.          1800
  310.          2000
  311.          2400
  312.          3600
  313.          4800
  314.          7200
  315.          9600
  316.          19200
  317.  
  318. <parity=>   Parity
  319.             1: Odd
  320.             2: Even
  321.             3: None
  322.             4: Mark
  323.             5: Space
  324.  
  325. <stopbits=>   Number of stop bits (1 or 2)
  326.  
  327. <databits=>   Number of data bits (5, 6, 7, or 8)
  328.  
  329. <xonxoff=>   0: disable xonxoff protocol
  330.              1: enable xonxoff protocol
  331.  
  332. PRINTER MODEL
  333.  
  334. <Model=>   LaserJet
  335.            Postscript
  336.  
  337.            Default is LaserJet
  338.  
  339. SOFT FONTS
  340.  
  341. <Download=>   0: disable automatic font downloading (if applicable)
  342.               1: enable automatic font downloading (if applicable)
  343.  
  344.               NOTE: this tag can be over-ridden by the run time switches
  345.               "/X" and "/L". 
  346.  
  347. <font_path=>  soft font directory path 
  348.               EXAMPLE: <font_path=c:\softfont\><qz>
  349.               The Publisher will look for soft fonts, as required, in
  350.               the directory "c:\softfont". 
  351.  
  352. RESOLUTION
  353.  
  354. The Publisher contains support for high resolution Postscript output
  355. devices:
  356.  
  357. The tag
  358.  
  359. <DPI=n>
  360.  
  361. where n (an integer) is the resolution, can be used to set the internal
  362. accuracy of the publisher. The internal resolution, expressed in dots
  363. per inch, should match exactly the resolution of the output device. If
  364. the <DPI=> tag is not used, 300 dpi resolution is assumed.
  365.  
  366. The <DPI=> tag should be used before any tag that accepts units of
  367. linear measure (i.e. margins, indentation, etc.). The parameters of all
  368. such tags are converted to the Publisher's internal resolution units,
  369. which are identical to the output resolution set by the <DPI=> tag.
  370.  
  371.  
  372. A.4 PRINTER CONFIGURATION EXAMPLES
  373.  
  374. A.4.1 HEWLETT-PACKARD LASERJET (PARALLEL)
  375.  
  376. If LaserJet printers are specified when installing the Publisher, the
  377. Publisher will be configured to drive a LaserJet printer through a
  378. parallel interface, which is the usual arrangement. The default style
  379. sheet/configuration file SETUP.TAG will read as follows: 
  380.  
  381. <driver=Microsoft><qz> 
  382. <port=PRN><qz>
  383. <model=LaserJet><DPI=300><qz>
  384. <font_path=\softfont\><download=on><qz> 
  385. <paper long=11.0in short=8.0in><landscape=off><qz> 
  386. <margin top=1.0in left=0.5in right=8.0in bottom=10.0in><qz> 
  387. <margin header=0.733in footer=10.25in><qz>
  388. <column count=2 gutter=0.25in><qz> 
  389. <leading line=15pt para=4pt><Trajan12m><qz>
  390. <xr><ip24pt><qz>
  391. <pn=1><qz> 
  392.  
  393. A.4.2 HEWLETT-PACKARD LASERJET (SERIAL)
  394.  
  395. If the Publisher is to be used to drive a LaserJet printer as a "serial"
  396. printer, that is through a serial interface, the first two lines of the
  397. default style sheet/configuration file SETUP.TAG should be amended to
  398. specify the "Greenleaf" driver, with suitable protocols. The amended
  399. file should read substantially as follows: 
  400.  
  401. <driver=Greenleaf><qz>
  402. <protocol port=1 baud=9600 parity=3 stopbits=1 databits=8 xonxoff=1><qz>
  403. <model=LaserJet><DPI=300><qz>
  404. <font_path=\softfont\><download=on><qz>
  405. <paper long=11.0in short=8.0in><landscape=off><qz>
  406. <margin top=1.0in left=0.5in right=8.0in bottom=10.0in><qz>
  407. <margin header=0.733in footer=10.25in><qz>
  408. <column count=2 gutter=0.25in><qz>
  409. <leading line=15pt para=4pt><Trajan12m><qz>
  410. <xr><ip24pt><qz>
  411. <pn=1><qz>
  412.  
  413. Note: the LaserJet serial port can be set to 19,200 baud (Consult your
  414. LaserJet manual). In this case, the above "protocol" tag should be
  415. amended to read "baud=19200". Most computer serial ports are rated for a
  416. maximum output of 9600 baud, but will in fact work at higher speeds. 
  417.  
  418. A.4.3 APPLE LASERWRITER
  419.  
  420. If Postscript printers are specified when installing the Publisher, the
  421. Publisher will be configured to drive an Apple LaserWriter printer
  422. through a serial interface. The default style sheet/configuration file
  423. SETUP.TAG will read as follows: 
  424.  
  425. <driver=Greenleaf><qz>
  426. <protocol port=1 baud=9600 parity=3 stopbits=1 databits=8 xonxoff=1><qz>
  427. <model=Postscript><DPI=300><qz>
  428. <font_path=\softfont\><download=on><qz>
  429. <paper long=11.0in short=8.0in><landscape=off><qz>
  430. <margin top=1.0in left=0.5in right=8.0in bottom=10.0in><qz>
  431. <margin header=0.733in footer=10.25in><qz>
  432. <column count=2 gutter=0.25in><qz>
  433. <leading line=15pt para=4pt><Times12m><qz>
  434. <xr><ip24pt><qz>
  435. <pn=1><qz>
  436.  
  437. The LaserWriter Plus cannot be run at speeds faster than 9600 baud. The
  438. LaserWriter NTX can be configured to run at 19200 baud (consult your
  439. LaserWriter manual). In this case, the above "protocol" tag should be
  440. amended to read "baud=19200". Most computer serial ports are rated for a
  441. maximum output of 9600 baud, but will in fact work at higher speeds. 
  442.  
  443. A.4.4 DESTINY PAGESTYLER
  444.  
  445. If the Publisher will be used to drive a Destiny PageStyler, Postscript
  446. devices should be specified during installation, but after the automatic
  447. installation program has ended,the first two lines of the default style
  448. sheet/configuration file SETUP.TAG should be amended to specify the
  449. "MicroSoft" driver, with port "LPT2". The amended file should read as
  450. follows: 
  451.  
  452. <driver=Microsoft><qz>
  453. <port=LPT2><qz>
  454. <model=Postscript><DPI=300><qz>
  455. <font_path=\softfont\><download=on><qz>
  456. <paper long=11.0in short=8.0in><landscape=off><qz>
  457. <margin top=1.0in left=0.5in right=8.0in bottom=10.0in><qz>
  458. <margin header=0.733in footer=10.25in><qz>
  459. <column count=2 gutter=0.25in><qz>
  460. <leading line=15pt para=4pt><Times12m><qz>
  461. <xr><ip24pt><qz>
  462. <pn=1><qz>
  463.  
  464. The Destiny PageStyler is an add-on card that goes inside the computer.
  465. It allows a Hewlett-Packard LaserJet to emulate a Postscript printer.
  466. The standard configuration of the PageStyler card allows LaserJet
  467. printing through LPT1 and Postscript printing through LPT2. 
  468.  
  469. A.4.5 LINOTRON 300P PHOTO-TYPESETTER
  470.  
  471. The Linotron 300P is a Postscript photo-typesetter. Normally, the user
  472. would proofread a document on a Postscript laser printer, print it to
  473. disk, and then take it to a service bureau. Usually, a Linotron at a
  474. service bureau is connected to an Apple MacIntosh that will read 3.5"
  475. IBM PC diskettes.
  476.  
  477. The Linotron 300P can be operated at a resolution of 635, 1270, or 2540
  478. d.p.i. (dots per inch). For optimum appearance of the printed output,
  479. the <DPI> tag in SETUP.TAG should be tag set to the final output
  480. resolution. 
  481.  
  482. Example: A Destiny Postscript is being used for a proofing device.
  483. Final output resolution is 1270 d.p.i..  The following is a suitable
  484. version of SETUP.TAG:
  485.  
  486. <driver=Microsoft><qz>
  487. <port=LPT1><qz>
  488. <model=Postscript><DPI=1270><qz>
  489. <font_path=\softfont\><download=on><qz>
  490. <paper long=11.0in short=8.0in><landscape=off><qz>
  491. <margin top=1.0in left=0.5in right=8.0in bottom=10.0in><qz>
  492. <margin header=0.733in footer=10.25in><qz>
  493. <column count=2 gutter=0.25in><qz>
  494. <leading line=15pt para=4pt><Times12m><qz>
  495. <xr><ip24pt><qz>
  496. <pn=1><qz>
  497.  
  498. A.4.6 COMBINED SUPPORT FOR LASERJET & POSTSCRIPT PRINTERS
  499.  
  500. If both LaserJet and Postscript printers are specified when installing
  501. the Publisher, the Publisher will be provided with two extra configuration
  502. files: SETUP.HP and  SETUP.PS. 
  503.  
  504. SETUP.HP is intended to support a parallel LaserJet printer, and is the
  505. same as the version of SETUP.TAG described above in Section A.4.1.  If
  506. the LaserJet printer is a "serial" printer, file SETUP.HP should be
  507. amended as described above in Section A.4.2. 
  508.  
  509. SETUP.PS is intended to support a serial Postscript printer such as an
  510. Apple LaserWriter, and is the same as the version of SETUP.TAG described
  511. above in Section A.4.3.  If the Postscript device the Publisher will be
  512. driving is a Destiny PageStyler or a Linotron Photo-Typesetter, file
  513. SETUP.PS should be amended as described above in Section A.4.4 or
  514. Section A.4.5. 
  515.  
  516. If the Publisher will be used most frequently with the LaserJet, the
  517. default style sheet/configuration file SETUP.TAG should be a copy of
  518. SETUP.HP (including any amendments), and document files to be printed by
  519. the Postscript device should begin with the line: 
  520.  
  521. <INCLUDE SETUP.PS>
  522.  
  523. Conversely, if the Publisher will be used most frequently with the
  524. Postscript device, the default style sheet/configuration file SETUP.TAG
  525. should be a copy of SETUP.PS (including any amendments), and document
  526. files to be printed by the LaserJet should begin with the line: 
  527.  
  528. <INCLUDE SETUP.HP>
  529.