home *** CD-ROM | disk | FTP | other *** search
/ Boldly Go Collection / version40.iso / TS / 21B / PSX.ZIP / PSX.TXT < prev   
Text File  |  1991-05-11  |  23KB  |  647 lines
  1.               PSX - PostScript Soft Font Downloader
  2.                   Copyright 1991, Costas Kitsos
  3.  
  4.  
  5. -----------------------------------------------------------------
  6.               DOCUMENTATION FOR PSX (Version 2.00)
  7. -----------------------------------------------------------------
  8.  
  9.  
  10.                             Contents
  11.  
  12.  
  13.      Introduction
  14.  
  15.      Installation
  16.           Windows Installation
  17.           About PSX.CFG
  18.  
  19.      Starting PSX
  20.           
  21.      Using PSX 
  22.           Selecting Output Options
  23.           Downloading Type 1 PostScript Soft Fonts
  24.           Downloading Type 3 PostScript Soft Fonts
  25.           Downloading Bitstream QEM PostScript Soft Fonts
  26.           Printer Control & Utilities
  27.           Quitting PSX
  28.  
  29.      Using PSX as a Command Line Dowloader
  30.  
  31.      Bibliography
  32.  
  33.      Product Support
  34.  
  35.      Legal Stuff
  36.  
  37.  
  38.  
  39.  
  40.  
  41. -----------------------------------------------------------------
  42.  
  43.  
  44.                           Introduction
  45.  
  46. PSX is a PostScript Soft Font Downloader that supports PostScript
  47. Type 1, Type 3, and Bitstream QEM formats.  The program allows
  48. you to output to LPT1, LPT2, LPT3 or to direct output to a file.
  49. You may also print font samples with PSX and device configuration
  50. reports that inform you of your printer's memory status and
  51. available fonts.  PSX v2.0 supports batch downloads (more than
  52. one soft font may be downloaded at a time) and command line soft
  53. downloads if you wish to bypass the Main Menu.
  54.  
  55.  
  56.                           Installation
  57.  
  58. PSX is designed with a hard disk in mind and although floppy disk
  59. installation and operation is possible it will not be optimal. 
  60. The following instructions assume hard disk installation.
  61.  
  62. You may copy PSX.EXE to any subdirectory of your hard disk.  It
  63. does not need to reside in the same subdirectory as your
  64. PostScript soft fonts.  You don't need to keep these instructions
  65. on your hard disk.
  66.  
  67.  
  68.                     Windows 3.0 Installation
  69.  
  70. a. Although PSX is not a Windows 3.0 Application it works fine as
  71.    a DOS Application running under Windows.
  72.  
  73.    Start Windows. 
  74.  
  75. b. Open the Program Group containing your DOS Applications   
  76.  
  77. c. While in Program Manager. Click on File.
  78.  
  79. d. Click on New.
  80.  
  81. e. Click on Program Item.
  82.  
  83. f. Under Description type: PSX
  84.  
  85.    Under Command Line type: [drive]:[\path\] PSX.EXE
  86.  
  87.    To force monochrome display use the optional parameter "/B"
  88.    
  89.    Substitute [drive] and [\path\] with the appropriate drive 
  90.    and path where the program is located, e.g. C:\PSUTIL\PSX.EXE
  91.  
  92. g. Click on OK.  Windows will install PSX.EXE (with a DOS icon)
  93.    in your selected group. This completes Windows installation.
  94.  
  95.  
  96. -----------------------------------------------------------------
  97.  
  98.  
  99.                           About PSX.CFG
  100.  
  101. PSX.CFG should reside in the same subdirectory as PSX.EXE.  It
  102. contains configuration information that PSX uses when downloading
  103. soft fonts or performing printer related functions.  
  104.  
  105. PSX.CFG information consists of the following:
  106.  
  107.        1. Your Output Option (LPT1, LPT2, LPT3, or File).
  108.  
  109.        2. The Drive/Directory where your Type 1 soft fonts are 
  110.           located (if any).
  111.  
  112.        3. The Drive/Directory where your Type 3 soft fonts are
  113.           located (if any).
  114.  
  115.        4. The Drive/Directory where your Bitstream QEM soft fonts
  116.           are located (if any).
  117.  
  118.        5. The Delay time (optional) you wish to establish for
  119.           batch downloads.
  120.  
  121. When you first run PSX it creates PSX.CFG for you using the
  122. following defaults:
  123.  
  124.      Output = LPT1
  125.      Type 1 drive/directory = Current Drive/Directory
  126.      Type 3 drive/directory = Current Drive/Directory
  127.      Bitstream QEM drive/directory = Current Drive/Directory
  128.      Delay = NONE (0 seconds)
  129.  
  130. Of course you can change any of these at any point (you'll read
  131. later how) and also save a different configuration than the
  132. default. 
  133.  
  134. -----------------------------------------------------------------
  135.  
  136.                           Starting PSX
  137.  
  138. To start using PSX in DOS, change to the subdirectory containing
  139. PSX.EXE and at the DOS prompt type: 
  140.  
  141.                          PSX 
  142.  
  143. Hit enter to begin using PSX. 
  144.  
  145. To force monochrome display start PSX with the optional parameter
  146. "/B".  At the DOS prompt type: PSX /B and hit enter.
  147.  
  148. To start using PSX in Windows, change to the program group
  149. containing PSX.EXE and double click on the PSX icon.
  150.  
  151.  
  152.  
  153. -----------------------------------------------------------------
  154.  
  155.                             Using PSX
  156.  
  157. When you start PSX it takes you to the Main Screen which displays
  158. PSX's Main Menu and PSX's information box.
  159.  
  160.  
  161. The Information Box:
  162.  
  163. The information box, located at the lower 1/4 of your screen,
  164. shows your configuration information on the left and PSX's key
  165. assignments on the right.  
  166.  
  167. Let's assume that you installed PSX in "C:\PSUTIL\".  When you
  168. first start the program the configuration information will read:
  169.  
  170.           Output to LPT1
  171.           Type 1 Dir = C:\PSUTIL\
  172.           Type 3 Dir = C:\PSUTIL\
  173.           Bits Q Dir = C:\PSUTIL\
  174.  
  175. These assignments will change as you configure PSX to your
  176. environment.
  177.  
  178. The right part of the information box shows you PSX's key
  179. assignments:
  180.  
  181.                               F1 - Help
  182.                          F5 - Font Name 
  183.                        F10 - Abort/Quit
  184.                    ESC - Back up/Cancel
  185.  
  186. The F1 key displays a short Help Screen (press any key
  187. to exit the Help Screen).
  188.  
  189. The F5 key is used to find out a Type 1's or Bitstream's Font's
  190. Name when you are in a download submenu.
  191.  
  192. F10 ends PSX and returns you to DOS (or Windows).  Pressing F10
  193. while downloading a soft font allows you to Abort the download.
  194.  
  195. The Escape key (ESC) is used to Cancel an action or command or to
  196. Back up from submenus to the Main Menu.
  197.  
  198.  
  199.  
  200. PSX Main Menu:
  201.  
  202. The Main Menu gives you six options:
  203.  
  204.                     Select Output Options
  205.                     Download Type 1 Fonts
  206.                     Download Type 3 Fonts
  207.                     Download Bitstream QEM fonts
  208.                     Printer Control & Utilities
  209.                     Exit PSX
  210.  
  211. To select an option, use the Up or Down arrow keys to move the
  212. light bar, press enter to select.
  213.  
  214.  
  215. -----------------------------------------------------------------
  216.  
  217.                     Selecting Output Options
  218.  
  219. To select output options move the light bar to the first choice
  220. of the Main Menu and press enter.  PSX takes you to the Output
  221. Options submenu:
  222.  
  223.                     LPT1:
  224.                     LPT2:
  225.                     LPT3:
  226.                     File:
  227.  
  228. Move the light bar to the Output option of your choice and press
  229. enter to select it.  For example, if your printer is connected to
  230. LPT2, move the light bar to LPT2 and press enter to select it.
  231.  
  232. If you choose "File:" PSX prompts you for a filename. To make
  233. things easy on you PSX displays the current drive and directory
  234. but you may change this as you wish.  Type the filename you want
  235. to print to e.g. "D:\PRJOBS\FILE1.PRN" and press enter.  Please
  236. note that when you print to a file PSX does not append jobs but
  237. it overwrites the file with each new job.  You must come back to
  238. this menu and change the output filename if you don't want PSX to
  239. overwrite the file.
  240.  
  241. Note that as you change Output Options the Information Box is
  242. updated to reflect them.
  243.  
  244. Press ESC to go back to the Main Menu.
  245.  
  246.  
  247. -----------------------------------------------------------------
  248.  
  249.             Downloading Type 1 PostScript Soft Fonts
  250.  
  251. To download Type 1 soft fonts, move the light bar to the second
  252. choice of the Main Menu and press enter.  You are presented with
  253. the "Download Type 1 Fonts" submenu:
  254.  
  255.                Select Font & Download
  256.                Change Drive & Directory
  257.  
  258. Check the Information Box and see if the "Type 1 Dir" entry is
  259. correct.  If not, select "Change Drive & Directory".  PSX will
  260. prompt you for a drive and directory.  If your Type 1 fonts are
  261. located in drive "F:" in the subdirectory "\PSFONTS\" type:
  262. F:\PSFONTS\  You can use the backspace, delete, insert, left and
  263. right arrow keys to edit your selection.  
  264.  
  265. Press enter when satisfied or ESC to go back to the Type 1
  266. submenu.  PSX will update the Information Box with your current
  267. choice.
  268.  
  269. To download a soft font move the light bar to "Select Font &
  270. Download" and press enter.  
  271.  
  272. PSX presents you with a listing of your soft fonts.  For Type 1
  273. soft fonts, PSX uses the filespec: "*.PFB".  It assumes the
  274. extension PFB since most Type 1 soft fonts use this extension. 
  275.  
  276. To find the fonts you want to download, use the Up/Down arrow,
  277. Page Up/Page Down, Home, or End keys to travel through the
  278. directory listing.  Optionally, you may press the first letter of
  279. the font's filename and PSX will search for the font on the list
  280. (e.g. to locate GLR_____.PFB just press "G", pressing "G" again
  281. will take you to the next file starting with "G").  
  282.  
  283. To check the Font's PostScript Name press F5 while the light bar
  284. is on a font file and PSX will display the font's PostScript
  285. invocation name.  If you get the message "No Font Name Available"
  286. don't become alarmed all it means is that PSX could not locate
  287. the Font Name.  
  288.  
  289. Mark the soft fonts you wish to download by pressing the "Space
  290. Bar", PSX will put a check mark next to the selected file.  To
  291. unmark a selection press the "Space Bar" again. Once you are
  292. satisfied with your selections, press enter to download.  PSX
  293. will download the soft fonts and return you to the menu.  If
  294. you'd rather not download any fonts press ESC and PSX will take
  295. you back to the Type 1 submenu and pressing ESC again will return
  296. you to the Main Menu. 
  297.  
  298. For your protection, PSX verifies soft fonts before downloading
  299. them to the printer.  If you get the error message: "Font Failed
  300. Verification - Font Download Aborted" it means that PSX could not
  301. verify the file as a Type 1 binary soft font and thus aborted the
  302. download. 
  303.  
  304. If at any point you need to Abort a soft font download press
  305. "F10".  PSX will ask you to confirm the Abort request, and take
  306. you back to the submenu.
  307.  
  308.  
  309.  
  310. -----------------------------------------------------------------
  311.  
  312.             Downloading Type 3 PostScript Soft Fonts
  313.  
  314. To download Type 3 soft fonts, move the light bar to the third
  315. choice of the Main Menu and press enter.  You are presented with
  316. the "Download Type 3 Fonts" submenu:
  317.  
  318.                Select Font & Download
  319.                Change Drive & Directory
  320.  
  321. Check the Information Box and see if the "Type 3 Dir" entry is
  322. correct.  If not, select "Change Drive & Directory".  PSX will
  323. prompt you for a drive and directory.  If your Type 3 fonts are
  324. located in drive "E:" in the subdirectory "\FONTS\TYPE3\" type:
  325. E:\FONTS\TYPE3\  You can use the backspace, delete, insert, left
  326. and right arrow keys to edit your selection.  Press enter when
  327. satisfied or ESC to go back to the Type 3 submenu.  PSX will
  328. update the Information Box with your current choice.
  329.  
  330. To download a soft font move the light bar to "Select Font &
  331. Download" and press enter.  PSX presents you with a listing
  332. containing your soft fonts.  For Type 3 soft fonts, PSX uses the
  333. filespec: "*.P*".  
  334.  
  335. To find the fonts you want to download, use the Up/Down arrow,
  336. Page Up/Page Down, Home, or End keys to travel through the
  337. directory listing.  Optionally, you may press the first letter of
  338. the font's filename and PSX will search for the font on the list
  339. (e.g. to locate MARYDALE.PFA just press "M", pressing "M" again
  340. will take you to the next file starting with "M").
  341.  
  342. The Font Name function (F5) is not available for Type 3 fonts
  343. because of the variety of Type 3 file formats.  On the other
  344. hand, PSX will try to find the Font Name for you when you
  345. download the font.
  346.  
  347. Mark the soft fonts you wish to download by pressing the "Space
  348. Bar", PSX will put a check mark next to the selected file.  To
  349. unmark a selection press the "Space Bar" again. Once you are
  350. satisfied with your selections, press enter to download.  PSX
  351. will download the soft fonts and return you to the menu.  If
  352. you'd rather not download any fonts press ESC and PSX will take
  353. you back to the Type 3 submenu and pressing ESC again will return
  354. you to the Main Menu. 
  355.  
  356. For your protection, PSX verifies soft fonts before downloading
  357. them to the printer.  If you get the error message: "Font Failed
  358. Verification - Font Download Aborted" it means that PSX could not
  359. verify the file as a Type 3 soft font and thus aborted the
  360. download. 
  361.  
  362. If at any point you need to Abort a soft font download press
  363. "F10".  PSX will ask you to confirm the Abort request, and take
  364. you back to the submenu.  
  365.  
  366.  
  367. -----------------------------------------------------------------
  368.  
  369.          Downloading Bitstream QEM PostScript Soft Fonts
  370.  
  371. To download Bitstream QEM PostScript Soft fonts, move the light
  372. bar to the fourth choice of the Main Menu and press enter.  You
  373. are presented with the "Download Bitstream QEM Fonts" submenu:
  374.  
  375.                Select Font & Download
  376.                Change Drive & Directory
  377.  
  378. Check the Information Box and see if the "Bits Q Dir" entry is
  379. correct.  If not, select "Change Drive & Directory".  PSX will
  380. prompt you for a drive and directory.  If your Bitstream QEM
  381. fonts are located in drive "C:" in the subdirectory "\BITS\FNT\"
  382. type: C:\BITS\FNT\  You can use the backspace, delete, insert,
  383. left and right arrow keys to edit your selection.  Press enter
  384. when satisfied or ESC to go back to the Bitstream QEM submenu. 
  385. PSX will update the Information Box with your current choice.
  386.  
  387. To download a soft font move the light bar to "Select Font &
  388. Download" and press enter.  PSX presents you with a listing of
  389. your soft fonts.  For Bitstream QEM soft fonts, PSX uses the
  390. filespec: "*.PSF".  It assumes the extension PSF since Fontware
  391. produced Bitstream QEM soft fonts use this extension.  
  392.  
  393. To find the soft fonts you want to download, use the Up/Down
  394. arrow, Page Up/Page Down, Home, or End keys to travel through the
  395. directory listing.  Optionally, you may press the first letter of
  396. the font's filename and PSX will search for the font on the list
  397. (e.g. to locate DKCFO.PSF just press "D", pressing "D" again will
  398. take you to the next file starting with "D").
  399.  
  400. To check the Font's PostScript Name press F5 while the light bar
  401. is on a font file and PSX will display the font's PostScript
  402. invocation name.  If you get the message "No Font Name Available"
  403. don't become alarmed all it means is that PSX could not locate
  404. the Font Name.  
  405.  
  406. Mark the soft fonts you wish to download by pressing the "Space
  407. Bar", PSX will put a check mark next to the selected file.  To
  408. unmark a selection press the "Space Bar" again. Once you are
  409. satisfied with your selections, press enter to download.  PSX
  410. will download the soft fonts and return you to the menu.  If
  411. you'd rather not download any fonts press ESC and PSX will take
  412. you back to the Bitstream submenu, pressing ESC again will return
  413. you to the Main Menu. 
  414.  
  415. For your protection, PSX verifies soft fonts before downloading
  416. them to the printer.  If you get the error message: "Font Failed
  417. Verification - Font Download Aborted" it means that PSX could not
  418. verify the file as a Bitstream QEM soft font and thus aborted the
  419. download. 
  420.  
  421. Note:  Bitstream QEM PostScript soft fonts are intended for
  422. PostScript printers equipped with the Bitstream Quality
  423. Enhancement Module, they have the file extension "PSF".  These
  424. fonts should not be confused with Bitstream's PostScript Type 3
  425. soft fonts that have the file extension "PSO".  
  426.  
  427. If at any point you need to Abort a soft font download press
  428. "F10".  PSX will ask you to confirm the Abort request, and take
  429. you back to the submenu.  
  430.  
  431.  
  432. -----------------------------------------------------------------
  433.  
  434.                    Printer Control & Utilities
  435.  
  436.  
  437. Selecting this option from the Main Menu, presents you with the
  438. following submenu:
  439.  
  440.  
  441.                     Print Font Sample Page
  442.                     Print Device Info Page
  443.                     Initialize Printer
  444.                     Change Delay
  445.  
  446.  
  447. Print Font Sample Page:
  448.  
  449. PSX can print a font sample page using one of the soft fonts you
  450. downloaded.  When you select this option, PSX presents you with a
  451. list of the soft fonts you downloaded (the list uses the actual
  452. PostScript Font Names instead of the filenames).  Move the light
  453. bar to the font you want to print a sample of and press enter to
  454. select.  
  455.  
  456. PSX will ask you if you want to print a Full Sample or a Quick
  457. Sample.  Press "F" for the Full Sample or "Q" for the Quick
  458. Sample.
  459.  
  460. The Full Sample prints a quote from Aristotle's Ethics once in
  461. 12pt type and once in 15pt type, a font scaling sample, and a
  462. character set.  The character set sample assumes that no
  463. characters are mapped between ASCII 0 and ASCII 32, but this
  464. seems to be the norm with most PostScript fonts (with the
  465. possible exception of some symbol fonts).  If this is a new soft
  466. font and if you work a lot with type then you'll find the Full
  467. Sample more complete.  The full sample takes 1 to 3 minutes to
  468. print, depending on the speed of your printer.
  469.  
  470. The Quick Sample only prints a quote from Aristotle's Ethics once
  471. in 12pt type and once in 15pt type.  It should take 30 sec. to 2
  472. minutes to complete, depending on the speed of your printer.
  473.  
  474.  
  475.  
  476. Print Device Info Page:
  477.  
  478. Choose this option if you want to find out information about your
  479. printer, e.g. name, version, default character set encodings,
  480. total memory, available memory, available fonts (including soft
  481. fonts), e.t.c.  The Device Info Page takes 20 to 30 seconds to
  482. print.  
  483.  
  484. A question that I'm frequently asked is:
  485.  
  486. My printer has 3,500K, yet the Device Info Page Total Memory
  487. shows only 1,280K.  How come?
  488.  
  489. The answer is that a good portion of your 3,500K is taken up by
  490. the PostScript Interpreter loaded into memory.  Since this memory
  491. will never be available to you there is no reason to account for
  492. it.  The Total Memory reported is the memory beyond that used by
  493. the PS interpreter.
  494.  
  495.  
  496.  
  497. Initialize Printer:
  498.  
  499. Choose this option if you want to reset the printer to the power
  500. on state.  It will delete, from the printer's memory, all
  501. permanently downloaded soft fonts, headers and error handlers.
  502.  
  503.  
  504.  
  505. Change Delay:
  506.  
  507. You'll probably never have to adjust this but I thought I should
  508. make this feature available, just in case.  Because PSX now
  509. supports batch downloads I added a feature that allows you to
  510. specify a delay of a few seconds between each download.  You only
  511. need to adjust this if your printer seems uncomfortable during
  512. batch downloading.  You may try different values of 2 seconds up
  513. to 10 seconds (which I'm sure you'll never need).  When you
  514. specify a delay, PSX will display: "Waiting... ", for the
  515. selected amount of delay.  To check your current delay setting,
  516. go to the Change Delay submenu.  The delay you specified will be
  517. highlighted.
  518.  
  519.  
  520. -----------------------------------------------------------------
  521.  
  522.                           Quitting PSX
  523.  
  524. This submenu gives you two choices:
  525.  
  526.                Save Configuration & Exit
  527.                Exit Now
  528.  
  529.  
  530. Save Configuration & Exit saves the current user configuration
  531. in PSX.CFG.  I encourage you to use this option since it will
  532. save you time and energy from configuring PSX every time you run
  533. it.  Selecting this option will save the current configuration
  534. and return you to DOS (or Windows).
  535.  
  536. Exit Now is the same as pressing F10.  It returns you to DOS (or
  537. Windows).
  538.  
  539.  
  540. -----------------------------------------------------------------
  541.                                 
  542.              Using PSX as a Command Line Downloader
  543.  
  544. New in this version of PSX, is the ability to use it as a command
  545. line downloader.  This feature is useful if you only have a
  546. couple of fonts to download and you'd like to bypass the PSX Menu
  547. interface.  The syntax is very simple, at the DOS prompt type:
  548.  
  549.                     PSX FONTFILE.EXT OUTPUT
  550.  
  551. FONTFILE.EXT is the font's filename which should include the
  552. drive and directory if different from the drive and directory PSX
  553. was started from.
  554.  
  555. OUTPUT can be LPT1, LPT2, LPT3 or any legal filename.  Do not
  556. include a colon ":" after LPT1, LPT2, or LPT3 because PSX will
  557. reject your Output selection.  When downloading to a file you may
  558. also specify a drive and directory.
  559.  
  560. You don't need to specify the type of font you wish to download. 
  561. PSX will figure it out for you.
  562.  
  563. Example:
  564.  
  565. To download GLBI___.PFB to LPT1, issue the command:
  566.  
  567.           PSX GLBI___.PFB LPT1
  568.  
  569. To download CQCFO.PSF to a a file called FONT1.PRN, issue the
  570. command:
  571.  
  572.           PSX CQCFO.PSF FONT1.PRN
  573.  
  574. The optional /B switch is not supported, nor is it needed for
  575. command line downloads.  If you use it, PSX will start in regular
  576. mode.
  577.  
  578. -----------------------------------------------------------------
  579.  
  580.                          Product Support
  581.  
  582. If you have any questions or comments you may reach me through
  583. CompuServe Mail at 73667,1755.
  584.  
  585.  
  586. -----------------------------------------------------------------
  587.  
  588.                           Bibliography
  589.  
  590. PostScript Language Reference Manual Second Edition, Adobe
  591. Systems Inc., Addison-Wesley Publishing Company Inc.
  592.  
  593. Adobe Type 1 Font Format Version 1.1, Adobe Systems Inc.,
  594. Addison Wesley Publishing Company Inc.
  595.  
  596. Understanding PostScript Programming Second Edition, David A.
  597. Holzgang, Sybex Inc.
  598.  
  599. Learning PostScript - A Visual Approach, Ross Smith, Peachpit
  600. Press.
  601.  
  602. Running PostScript from MS-DOS, Gary Glover, Windcrest Books.
  603.  
  604.  
  605.  
  606. Legal Stuff:
  607.  
  608. This program is provided "as is" without warranty of any kind
  609. either express or implied.  The entire risk related to the
  610. installation, performance and quality of the program is yours. 
  611. In the event there is any defect the cost of all repairs,
  612. servicing or correction is up to you.  In no event will I be
  613. liable for any damages caused from the use of this program or
  614. its documentation.
  615.  
  616. PSX is free but it is Copyrighted.  You have my permission to
  617. distribute it if you want but only in the original LHA archive
  618. containing PSX.EXE, PSX.TXT, and PSX.NEW.  You may not alter
  619. PSX.EXE, PSX.TXT, PSX.NEW or the archive in any way and you
  620. should not charge anything for it's distribution unless it's a
  621. modest fee covering duplication, shipping or transmission costs.
  622. BBS Sysops are granted permission to add their own BBS Telop. 
  623.  
  624. I hope you find PSX useful and enjoyable.
  625.  
  626.                                         Costas Kitsos
  627.                                         April 18, 1991
  628.  
  629.  
  630.  
  631.  
  632. -----------------------------------------------------------------
  633.  
  634. PostScript and Adobe are trademarks of Adobe Systems, Inc.
  635. Bitstream and Fontware are trademarks of Bitstream, Inc.
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.                PSX - Copyright 1991, Costas Kitsos
  644.                        All Rights Reserved
  645.  
  646. -----------------------------------------------------------------
  647.