home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / wp / pc_wread.zip / SEEDOC.TXT < prev   
Text File  |  1990-02-06  |  60KB  |  1,036 lines
  1. ░░░│           Hello, and welcome to the PC-WREAD documentation! 
  2. ░░░│ 
  3. ░░░│   In just a moment, we'll take you right into that documentation;
  4. ░░░│   first, though, let's explain how you move around in the document.
  5. ░░░│   
  6. ░░░│   All the active keys will be continually displayed along the bottom
  7. ░░░│   line--you see them there now.  They are the usual movement keys:
  8. ░░░│   
  9. ░░░│       ∙ the four cursor keys (plus Ctrl-Left and Ctrl-Right);
  10. ░░░│       ∙ the PageUp and PageDown keys; and,
  11. ░░░│       ∙ the Home and End keys.
  12. ░░░│   
  13. ░░░│   The Esc key is the Exit key.
  14. ░░░│   
  15. ░░░│   By and large, everything does what you might expect it should: the 
  16. ░░░│   cursor keys scroll one line or column at a time, the Page keys scroll 
  17. ░░░│   one screenful at a time, and Home and End jump to the top and bottom--
  18. ░░░│   respectively--of the document.  (Ctrl-Left and Ctrl-Right jump 10 
  19. ░░░│   columns at a time.)  And Esc returns you peacefully to DOS.
  20. ░░░│
  21. ░░░│   To see this document as was intended, use just the Page keys.
  22. ░░░└─────────────────────────────────────────────────
  23. ░░░    (Press PgDn when you're ready to move on.)
  24.   ──────────────────────────────────────────────────────────────────────────── 
  25.                                                                                
  26.                                    PC-WREAD                                    
  27.                                   ──────────                                   
  28.                                                                                
  29.                          ┌──────────────────────────┐                          
  30.                          │                          │                          
  31.                          │    A software product    │                          
  32.                          │                          │                          
  33.                          │          from            │                          
  34.                          │                          │                          
  35.                          │    High Boskage House    │                          
  36.                          │                          │                          
  37.                          └──────────────────────────┘                          
  38.                                                                                
  39.                                                                                
  40.                                                                                
  41.                                                                                
  42.                                                                                
  43.                                                                                
  44.                                                                                
  45.    V. 1.00                                      Copyright 1990 by Eric Walker  
  46.   ──────────────────────────────────────────────────────────────────────────── 
  47.  
  48.  
  49.                          ╔════════════════════════════════╗
  50.                          ║   PC-WREAD: Its Legal Status   ║
  51.                          ╚════════════════════════════════╝
  52.  
  53.      
  54.       Please be sure to read this section! 
  55.      
  56.      PC-WREAD is a "shareware" product.  Its author retains the copyright and 
  57.      all rights in the program, including the exclusive right to license its 
  58.      use by others.
  59.  
  60.            The author hereby grants you the following limited license:
  61.      
  62.          You may install and use this program without notification or      
  63.          payment in any amount to the copyright holder, provided such use  
  64.          does not extend longer than thirty (30) days from the date of     
  65.          first installation; by no later than the end of the aforesaid     
  66.          period, you must either register the program by notifying the     
  67.          author of your intent and paying the registration fee or else     
  68.          remove the program from your system and thereby cease using it.   
  69.          ────────────────────────────────────────────────────────────────  
  70.          ────────────────────────────────────────────────────────────────  
  71.          It is the intent of this license that you have an opportunity to  
  72.          evaluate the program and its suitability for your needs before    
  73.          having to decide whether or not to purchase a full license.  You  
  74.          are permitted, and indeed encouraged, to distribute this program  
  75.          to others, subject to the folowing conditions: all files in the   
  76.          original distribution package--SEE.EXE, SEEDOC.EXE, SEEDOC.TXT,   
  77.          COLORS.DOC, and README.1ST--must be distributed together, each    
  78.          unaltered in any way whatsoever, and not bundled with any other   
  79.          programs; you may not charge any fee for the distribution, except 
  80.          that established user's groups may charge a nominal amount (not   
  81.          to exceed ten dollars); and you must not represent, explicitly or 
  82.          implicitly, that any recipient is receiving any rights in this    
  83.          program beyond this shareware limited license.                    
  84.      
  85.      Registration will bring you the following: a slightly augmented version of 
  86.      the program (described more fully below); a license to use the program and 
  87.      any successor versions in perpetuity at any one site (multiple-site 
  88.      licensing is available at moderate incremental costs); a few modest but 
  89.      perhaps useful little utilities; the right to--at reasonable hours and for 
  90.      reasonable periods--harass the author by telephone; the peace of mind that 
  91.      comes with having fulfilled a moral obligation on the honor system; and 
  92.      the satisfaction of having helped support the shareware concept. 
  93.  
  94.      Registration for a single site is $10; if, however, you send along a 
  95.      diskette in a suitable mailer, or do not require the augmented program, 
  96.      the cost is only $8.  For multiple-site use, the license-fee structure is:
  97.  
  98.         Number Of Sites:     License Fee Per Site:
  99.              2 -  5              $7
  100.              6 - 10              $6
  101.             10 - 20              $5
  102.             over 20              $4
  103.  
  104.      These figures are registration costs only; distribution diskettes are $2 
  105.      each, regardless of number of sites. 
  106.              
  107.      Please: Bear in mind that such modest costs for software, representative 
  108.      of the shareware movement, are only possible if you register the programs 
  109.      that you use.  It is neither honorable nor reasonable to expect "the other 
  110.      guy" to do it all.  There are very few--if any--software needs for which 
  111.      the best answer is not available in the shareware world.  
  112.      
  113.      Whether or not you find this particular program worth registering, please 
  114.      keep these low prices for high quality possible by supporting shareware 
  115.      authors. 
  116.      
  117.  
  118.               
  119.                            ╔════════════════════════════╗
  120.                            ║   PC-WREAD: What It Does   ║
  121.                            ╚════════════════════════════╝
  122.  
  123.  
  124.      
  125.      PC-WREAD is a file-viewing tool.  It can be used as a general-purpose file 
  126.      viewer, and it will do that job decently, but candidly it does not have 
  127.      the full panoply of features that an all-purpose file viewer (such as the 
  128.      shareware program LIST from Vernon Buerg) should ideally possess. 
  129.  
  130.      Rather, PC-WREAD is a special-purpose tool: it was designed to work in 
  131.      tandem with the highly successful shareware word-processor PC-Write, from 
  132.      Quicksoft, Inc., although--as described in the Appendix hereto--it can be 
  133.      of significant use even without PC-Write. 
  134.  
  135.      Briefly stated, what PC-WREAD does is present on screen a display of any 
  136.      file that is exactly the same as the display that PC-Write would show for 
  137.      that file when displaying in "Hide" mode (font characters invisible). 
  138.   
  139.        Note: if any of the terms used in this discussion are unclear to you,
  140.        there is an extended introduction to the basics further down, under the
  141.        heading "Basic Background."
  142.  
  143.      The remainder of this discussion will assume that you are a user of and 
  144.      at least reasonably familiar with the operation and features of PC-Write.
  145.      
  146.      PC-WREAD evolved to fill a perceived gap between the features of PC-Write 
  147.      and of LIST (and similar programs).  Frequently, situations arise in which 
  148.      the user (that's you for now, but stay tuned) wants to simply view on 
  149.      screen--as opposed to edit or print out--a text file.  PC-Write can, of 
  150.      course, be invoked for this purpose, either in the ordinary Edit mode or 
  151.      in the Read-Only mode.  Each of these two cases, however, has drawbacks. 
  152.  
  153.      In Edit mode, there is the very real possibility (and, over time, that 
  154.      becomes probability) of inadvertently altering the file, perhaps 
  155.      disastrously--there are a lot of ways to cause havoc by a single careless 
  156.      or accidental keypress.  Worst of all are the instances in which such file 
  157.      alterations are not even noticed at the time, which is assuredly possible 
  158.      in the most likely case, the accidental keypress (everyone--everyone--
  159.      brushes a finger or a notepad against the keyboard on occasion), because 
  160.      the alteration will usually only be caught if it was dramatic. 
  161.  
  162.      Read-Only mode has its own problems.  PC-Write, wonderful as it is, is an 
  163.      editor; that's its job.  The Read-Only mode was included primarily as a 
  164.      way to work around locked files in networks, and it thus works in all ways 
  165.      just like Edit mode, except that you cannot save any editing changes to 
  166.      the file directly but must write the file under another name.  So, besides 
  167.      the very real problem of remembering to call PC-Write in the Read-Only 
  168.      mode (and of remembering how to do so), there is the fact that while you 
  169.      can't actually damage the file, you can certainly appear to be doing so.  
  170.      Further, it would be all too easy to call up a file to review and after 
  171.      kicking around in it for a few minutes forget that you're in Read-Only and 
  172.      start editing; you wouldn't be reminded what was happening until you first 
  173.      went to save your work.  Yes, you can and would then use another file 
  174.      name, but--all in all--while using PC-Write in Read-Only as a straight 
  175.      file-viewing tool works, it's not the ideal solution. 
  176.  
  177.      An obvious alternative is a full-blown file viewer such as the above-cited 
  178.      LIST program.  But such programs can't know when they're looking at a PC-
  179.      Write-created file, so they have to be equal-opportunity displayers of 
  180.      files' contents.  This means that they can have no way of knowing that a 
  181.      Code-2 character is supposed to make the following text look like this 
  182.      until another Code-2 character is encountered, then revert to "normal"; 
  183.      in fact, they can't even know what "normal" means to you (especially on a 
  184.      color monitor) without special configuration.
  185.  
  186.      Furthermore, general-purpose file-view programs have to present all 
  187.      characters (whether or not you made them "enhanced") in one appearance, 
  188.      plus thay have to decide what to do with the font characters themselves.  
  189.      If they display them like ordinary text, the result will be, to say the 
  190.      least, distracting, especially in any areas of your document making heavy 
  191.      use of text enhancements.  But if they don't display the font characters 
  192.      at all, you have no idea what text sections may be enhanced in some way. 
  193.  
  194.      Enter PC-WREAD.  PC-WREAD does know that it's viewing a PC-Write-created 
  195.      file (actually, it doesn't know, it assumes).  As you will have seen from 
  196.      reading this file, PC-WREAD very obviously does know what to do with font 
  197.      characters used by PC-Write, even when they're nested: 
  198.  
  199.       Normal, then elite going bold with italic in it within the elite area.
  200.  
  201.        Note: the specific font-display characteristics in this document are
  202.              customized PC-Write font characteristics, discussed further below.
  203.  
  204.      PC-WREAD displays them all just as PC-Write would.  So, the very obvious 
  205.      first major use for PC-WREAD is as a quick, easy, safe way to look over 
  206.      document files created with PC-Write.  You're reading one now--but that 
  207.      brings us to a second (if related) major use for PC-WREAD.  
  208.       
  209.      PC-Write uses font characters primarily to send instructions to your 
  210.      printer.  The altered screen display is only a support feature for that 
  211.      primary purpose, there to let you know what text is affected.  It isn't 
  212.      perfect in that respect--your screen can't actually show italics or 
  213.      different pitches or sub- and superscripts--but it doesn't have to be; it 
  214.      is enough to tell you the text is affected, and leave the "how" it is 
  215.      affected to categorical (e.g. differing-pitch) display variations.
  216.  
  217.      But why not utilize that facility--variant screen displays--as the primary 
  218.      function?  That's exactly what this very file does.  It is not intended to 
  219.      be printed out--if you tried it, you'd get some very peculiar results!  It 
  220.      is intended for just this: being read "on line," as you are doing now.  
  221.      Have you noticed how the text, without (we hope) any manifest signs of 
  222.      forcing, makes complete screenloads of information? 
  223.  
  224.      It must strike any thoughtful observer as both bizarre and ludicrous that 
  225.      programs--software, the essence of the computer age--are to this hour 
  226.      documented almost exclusively in hard copy or in files intended for 
  227.      no other use than to be printed out.  "On-line documentation" is a phrase 
  228.      that rarely means anything but Help screens in a program.  Actual outside-
  229.      the-program documentation intended exclusively or even mainly for screen 
  230.      reading is almost nonexistent.  The shoemaker's children go barefoot.
  231.  
  232.      Having PC-WREAD available, you can now readily create documents for on-
  233.      line reading.  You could, of course, always do this and use a general-
  234.      purpose file viewer to read them, but now you have the full spectrum of 
  235.      text presentation available to you.  In monochrome, you can use--
  236.  
  237.               ∙ normal
  238.               ∙ boldfacing
  239.               ∙ underlining
  240.               ∙ boldfaced underlining
  241.               ∙ reversed video
  242.  
  243.      (which, if you are viewing this in color, is what those lines show as in 
  244.      monochrome).  In color, you can use anything on anything, provided it is 
  245.      coded into PC-Write, either by default or by your customization of the 
  246.      font characters' screen effects (discussed further below). 
  247.  
  248.      This added capability makes on-line files a good deal more attractive, 
  249.      both literally and figuratively.  Consider how vastly simpler the giving 
  250.      of even elementary instructions is when you can create lines like:
  251.       
  252.       Type F <Enter> and wait for a response, then press <F1> and type R2
  253.  
  254.       While the mind immediately seizes on the marvellous prospects for 
  255.       improvement in text files, such as program documentation (like this 
  256.       file), the fun has only started.  Virtually every programming language, 
  257.       even DOS's Batch Files, has some "remarks" delimiter: after the delimiter 
  258.       (the ' in BASIC or--effectively--the : in a Batch File), the language 
  259.       ignores the rest of the line.  Consider this fragment of a PC-Write 
  260.       "commented" AUTOEXEC.BAT file seen via PC-WREAD, and ponder the 
  261.       possibilities: 
  262.  
  263.  
  264. :     THIS IS THE NORMAL, FULL AUTOEXEC VERSION   
  265. :   (The "fast start" version is in AUTOEXEC.HOT.) 
  266. echo off
  267. cls
  268. prompt $P$G
  269. path C:\;C:\EDITOR;C:\UTILS;C:\DOS;C:\FILTERS;C:\AMPLE
  270. set CPMDISK=D                                
  271. set W=ALONGNAMEDESIGNEDTOASSURETHATTHEREWILLBELOTSOFENVIRONMENTSPACE
  272. set X=ALONGNAMEDESIGNEDTOASSURETHATTHEREWILLBELOTSOFENVIRONMENTSPACE
  273. set Y=ALONGNAMEDESIGNEDTOASSURETHATTHEREWILLBELOTSOFENVIRONMENTSPACE
  274. set Z=ALONGNAMEDESIGNEDTOASSURETHATTHEREWILLBELOTSOFENVIRONMENTSPACE
  275. :This adds 256 bytes to Environment space--must occur before 1st TSR program
  276. synchdos
  277.  
  278.      Programmers: you know it's good practice to extensively comment your 
  279.      code; now look what you can do:
  280.      
  281.  
  282. cls
  283. system
  284. '
  285. '══════════════════SUBROUTINES, PROCEDURES, & FUNCTIONS═════════════════════════
  286. '
  287. '∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙Get A Keypress∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙
  288. sub KB
  289.   shared kb$,scancode
  290. '
  291.   do:loop until instat
  292.   kb$=ucase$(inkey$)  '--won't run except in TurboBasic
  293.   if len(kb$)=2 then scancode=asc(right$(kb$,1)) else scancode=0
  294. end sub
  295. '
  296. '∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙Interpret Key Presses∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙
  297. sub INTERPRET(scancode)
  298.   shared daymax,day,month,year
  299.   local ok
  300.  
  301.      Or this:
  302.  
  303. '∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙change default disk drive∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙
  304. sub SETDRIVE inline
  305. '
  306. ' call setdrive(drive)
  307. '
  308.   $inline &H55                ' push BP          save Base Pointer             
  309.   $inline &H89,&HE5           ' mov BP,SP        use extant stack              
  310.   $inline &H8B,&H5E,&H06      ' mov BX,[BP+6]    load DRIVE's pointer          
  311.   $inline &H8B,&H17           ' mov DX,[BX]      move DRIVE into DL            
  312.   $inline &HB4,&H0E           ' mov AH,0E        load op code into AH          
  313.   $inline &HCD,&H21           ' int 21           set DRIVE as current drive    
  314.   $inline &H5D                ' pop BP           restore BP                    
  315. end sub
  316. '
  317. '∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙∙scan file contents for custom attributes∙∙∙∙∙∙∙∙∙∙
  318. sub SCAN inline
  319. '
  320. 'call scan(mono,aa(0),codes(1),prdefsize,holdtext$)
  321. '          +22  +18     +14      +10       +6
  322. '
  323.  
  324.      Examples and possible uses could be endlessly multiplied, but your own
  325.      imagination can probably make the point even better than we can.
  326.  
  327.      This PC-Write/PC-WREAD marriage is made in heaven for writing reminder 
  328.      instructions for, as a start, yourself.  Here at High Boskage House, when 
  329.      we get a new piece of software in, the very first thing we do--before ever 
  330.      dreaming of installing the program--is to take the supplied .DOC file and 
  331.      very materially rewrite it for our own benefit.  The first benefit is 
  332.      ensuring that the documentation is completely and thoroughly understood; 
  333.      one cannot rewrite what one has not definitively understood.  The second 
  334.      benefit is that when we're through, we have (we think) a comprehensible, 
  335.      clear document; it is a sad fact that far too many software creators are 
  336.      much more adept at a computer language than at the English language.  
  337.      
  338.      (As an aside, it is our firm opinion that many fine programs--especially 
  339.      shareware programs, and most especially large and powerful shareware 
  340.      programs--often don't get the distribution they deserve because many users 
  341.      cannot fathom the opaque "explanations" provided in the .DOC files.) 
  342.  
  343.      The third benefit is that we can use PC-Write font characters to enhance 
  344.      the screen text to make fast spotting of key points and summaries 
  345.      available when we later screen-review the file for a specific datum.
  346.  
  347.      Now, however, consider the case of leaving instructions for third parties, 
  348.      whether on your system or theirs.  What a picnic!  You can get flashy, 
  349.      attention-getting screen displays without cumbersome batch files or 
  350.      special ANSI coding or suchlike.  Just use good old PC-Write to create the 
  351.      information file--like this one--and what you see is what they'll get.
  352.  
  353.      Granted that PC-Write is possibly the premier word processor around, you 
  354.      can't write files--.DOC or otherwise--on the assumption that every end 
  355.      viewer will have and know how to use PC-Write.  (Their loss.)
  356.  
  357.      But--all that's necessary is that the viewer have PC-WREAD available, a 
  358.      simple enough requirement.  And it's so very easy to use that even the 
  359.      rankest beginner can be trusted to use it properly to read your 
  360.      instruction (or other information) files.  (See the end of this document 
  361.      for information on bundling PC-WREAD with other products.) 
  362.                                          
  363.                                         |
  364.                                         |
  365.                                         |
  366.                                         | 
  367.                                   (more follows)
  368.                                       
  369.                                       
  370.  
  371.                           ╔══════════════════════════════╗
  372.                           ║   PC-WREAD: How To Work It   ║
  373.                           ╚══════════════════════════════╝
  374.  
  375.  
  376.  
  377.      The operational program comes to you named SEE.EXE.  You may freely rename 
  378.      it to whatever you find quick and easy.  If you do not rename it, you 
  379.      would display the contents of a hypothetical file FIXIT.DOC by typing: 
  380.  
  381.           SEE FIXIT.DOC <Enter>
  382.      
  383.      You may include, as necessary, Path or Drive specifications:
  384.  
  385.           SEE B:\WORK\MISC\FIXIT.DOC <Enter>
  386.  
  387.      All Path specifications--Drive specified or not--must begin with a \.  
  388.      
  389.      You can also call PC-WREAD without a file specification, with just: 
  390.  
  391.           SEE <Enter>
  392.  
  393.      When so invoked, PC-WREAD will come up prompting for a file specification; 
  394.      it will be showing a list of all files in the current default directory.  
  395.      (We will discuss dealing with that screen a little further on.) 
  396.  
  397.      If you call PC-WREAD with a file specification that is in some way 
  398.      defective or is nonexistent, PC-WREAD will show you your specification and 
  399.      an error message explaining the problem it is finding (it can, however, 
  400.      only signal one kind of error at a time).  PC-WREAD will at this point be 
  401.      asking you whether you want to quit the program or try again--the only two 
  402.      options then available (the screen is utterly self-explanatory).  If you 
  403.      choose to continue, PC-WREAD will then take you to the same screen that 
  404.      you get after exiting a normal file presentation (which is also the same 
  405.      screen that you get if you invoke PC-WREAD with no file name at all--the 
  406.      one we just said we will discuss a little further on). 
  407.      
  408.      When PC-WREAD successfully locates a file you have specified, it will 
  409.      display it--as you are now seeing.  The top "framing" line will show the 
  410.      file name as specified and the Line Number of the topmost line of the 
  411.      current screen display.  Line numbering can occasionally be slightly 
  412.      tricky; the problem is that certain "phantom lines" which appear on the 
  413.      screen display don't figure into the displayed Line Count.
  414.  
  415.      A PC-Write file contains three "classes" of lines: real text lines, which 
  416.      could be printed out if desired; Guide Lines, which are in essence private 
  417.      messages from you to PC-Write about formatting your document and which 
  418.      neither print out nor even appear in the "hide" screen-display mode; and 
  419.      Page-Break Lines, which show where you or PC-Write have inserted page 
  420.      breaks, and which don't print out as lines (just as form feeds) but which 
  421.      do display on screen, even in the "hide" screen-display mode. 
  422.  
  423.      PC-Write itself is a bit ambivalent about Page-Break lines.  The normal 
  424.      Status-Line display is relative: lines are numbered relative to the page 
  425.      they're on, and Break Lines are designated "Line 0" in that display.  But 
  426.      if you request an all-document absolute location, Break Lines (and even 
  427.      Guide Lines) are counted in the displayed total! 
  428.  
  429.      PC-WREAD both displays and counts text lines; no problem.  It neither 
  430.      displays nor counts Guide Lines; no problem.  It does not count, but does 
  431.      display Page-Break Lines--problem: a "line" not counted in the displayed  
  432.      Line Number count appears on screen. 
  433.  
  434.      In PC-WREAD, Break and Guide Lines never figure in the Line Count.  Just 
  435.      remember: If a Break Line is the top screen line, the displayed Line Count
  436.                will be that of the first real text line below that Break Line. 
  437.  
  438.      This need to treat Break Lines slightly differently than does PC-Write
  439.      itself (because PC-WREAD always shows an absolute Line Number count)
  440.      leads to one small, curious difference in screen display: when you
  441.      scroll a Page-Break Line up off the top of the screen, you see what   
  442.      appears to be a "jump" effect.  What happens is that your one-line
  443.      scroll command is telling PC-WREAD to move to the next line; but the
  444.      "next" line--the next real line--is the one whose line number follows
  445.      that displayed in the top framing line.  The Break Line that was being
  446.      shown atop the display area has no real existence; the displayed number
  447.      was that of not the Break Line, but that of the "real" text line shown
  448.      right after it--the second displayed line on the screen.  So, the one-
  449.      line scroll moves two display lines off the screen--the phantom Break
  450.      Line and the real text line.
  451.  
  452.        ┌────────────────────────────────────────────────────────────────┐
  453.        │                            NOTE:                               │
  454.        │ Using PC-WREAD to view any file containing characters of code  │
  455.        │ 11 or code 12 that do not conform to PC-Write's requirement of │
  456.        │ one per line, in the very first column only, will lead to some │
  457.        │ VERY bizarre-looking screen displays!  No others are problems. │
  458.        └────────────────────────────────────────────────────────────────┘
  459.  
  460.  
  461.      The bottom "framing" line shows all the keys PC-WREAD will recognize:
  462.  
  463.         <Left Arrow> = scroll one column left (stops at left document edge)
  464.  
  465.         <Right Arrow> = scroll one column right (goes indefinitely)
  466.  
  467.         <Ctrl>-<Left Arrow> = scroll ten columns left (to document edge)
  468.  
  469.         <Ctrl>-<Right Arrow> = scroll ten columns right (indefinitely)
  470.  
  471.         <Up Arrow> = scroll one line up (stops at document top)
  472.  
  473.         <Down Arrow> = scroll one line down (stops at last document line)
  474.  
  475.         <Pg Up> = scroll one screen up  (stops at document top)
  476.  
  477.         <Pg Dn> = scroll one screen down  (stops at last document line)
  478.  
  479.         <Home> = jump to top of document (cancels any horizontal scrolling)
  480.  
  481.         <End> = jump to bottom of document (cancels any horizontal scrolling)
  482.  
  483.         <Esc> = exit from current document (returns to menu)
  484.  
  485.      The Line Number display on the top framing line gives you an idea where in 
  486.      a document you are, but this information is supplemented by the presence 
  487.      or absence of four "pointer arrows" on the screen.  An arrow at any one of 
  488.      the four extreme corners of the display screen signifies that more of the 
  489.      file can be seen by scrolling in the direction indicated by the arrow.
  490.  
  491.      Right now, you will see at the bottom corners the "Up" and the "Down" 
  492.      arrows; they mean that you are neither at the start nor the end of this 
  493.      document.  You can scroll up and see more, or you can scroll down and see 
  494.      more.  (On very rare occasions, you can find a ? where the Down arrow 
  495.      would go; this means that PC-WREAD is at the very last line of the current 
  496.      "block"--explained later--and that it doesn't yet know if this is the last 
  497.      block of the file.)
  498.  
  499.      The Left Arrow appears whenever you are scrolled horizontally away from 
  500.      the left margin.  The Right Arrow only appears if a document line is 
  501.      longer than the 80 characters that will fit on the screen at once, like 
  502.      the 100-character "ruler" below; the Right Arrow will remain on until you 
  503.      scroll far enough right to display the end of the longest line of the 
  504.      current screen.  Use the Left and Right cursors now to see what we mean.
  505.  
  506. ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8----+----9----+----0
  507.       
  508.      When you quit a file's display via the <Esc> key, or when you have invoked 
  509.      PC-WREAD with no file specification or with an invalid one, you are 
  510.      presented with a "what next?" screen.  The top part of this screen will be 
  511.      a list of all the files in a Directory (in which Directory depends on 
  512.      things we'll explain shortly), bracketed by two "framing" lines; below 
  513.      this will be a request for a new file to display.  The top framing line 
  514.      will identify the displayed Directory; the bottom one will usually tell 
  515.      you how to list some other Directory.  We say "usually" because PC-WREAD 
  516.      makes allowance for the fact that a very long Directory list might 
  517.      overflow the available list space; if that happens, the bottom framing 
  518.      line will instead be showing a blinking message to that effect.  
  519.  
  520.      PC-WREAD can list 72 files (and it lists only files, never SubDirectory 
  521.      names); if you have more than that in one SubDirectory, it's past time to 
  522.      reorganize!  It's poor practice to overload directories; they were created 
  523.      to avoid just that happening.  Make some new SubDirectories and rearrange. 
  524.  
  525.      The normal bottom framing line display is a note to the effect that you 
  526.      can elect to display some other Directory by entering as a "dummy" file 
  527.      selection the * asterisk character.  Although the screen message does not 
  528.      say so, the [ and ] bracket characters will also work for that purpose.  
  529.                                                       
  530.      The two bracket signs were included because they are among the few lower-
  531.      case characters not recognized by DOS as valid in commands--so that they 
  532.      cannot be taken as real file names (and both were included so you don't 
  533.      have to remember "left bracket or right?")--and lower-case characters are 
  534.      much easier for hunt-and-peck typists to enter when they're in a hurry. 
  535.      
  536.      What happens if you use these "dummy" file names will be covered in a 
  537.      moment, but let's finish the "what next?" screen first.  The bottommost 
  538.      screen line will be a message to the effect that pressing the <Enter> key 
  539.      with no file entry will exit PC-WREAD.  This is, in fact, the normal and 
  540.      proper way to exit PC-WREAD; although the <Break> key should work, it 
  541.      should never be needed, since there is error-trapping. 
  542.   
  543.      (If PC-WREAD encounters an unanticipated error, it will jump to a special 
  544.      Error-Display screen; the only exit from there is to DOS, via any key.) 
  545.   
  546.      PC-WREAD tries to be accomodating with respect to your file-request 
  547.      entries.  It is totally indifferent to case in letters.  It tolerates (and 
  548.      ignores) leading or trailing blank spaces.  It assumes that if no Drive is 
  549.      specified, the current (DOS default) Drive is intended; likewise, it 
  550.      assumes that if no Path is specified, the current (DOS default) Path is 
  551.      intended.  
  552.      
  553.      You can explicitly specify either a Drive or a Path, but you do have to 
  554.      follow the DOS rules: Drives must be one letter followed by a : colon, and 
  555.      Paths--whether or not there is a Drive specification preceding them--must 
  556.      begin with the \ backslash character.  And, of course, the Drive, Path, 
  557.      and file named must all exist for PC-WREAD to find the file!
  558.  
  559.      Something that should be of interest to all shareware veterans: PC-WREAD 
  560.      will work with CED!  If you don't know about or haven't got CED (the 
  561.      Command Editor), a shareware program, you don't know what you're missing.  
  562.      For the rest of you: remember that PC-WREAD is a CED application program, 
  563.      and that CED maintains completely separate DOS-Command and Application-
  564.      Program stacks, and has a completely separate set of Application-Program 
  565.      synonyms.  Check the CED documentation if you're unclear about this.  
  566.      (Note: CED has a new--at this writing--shareware competitor, ANARKEY; it 
  567.      sounds good and comes well recommended, but we have not yet obtained it 
  568.      and so cannot guarantee that PC-WREAD can make use of it, although it 
  569.      probably can.)
  570.  
  571.      If you don't have CED or a similar program, note that your keyboard input 
  572.      to PC-WREAD's file-name requests is "DOS-buffered"; this means that the 
  573.      keys on your keyboard should work just as they do when you are entering 
  574.      input at the DOS Command line, so that the <F1> and <F3> keys, for 
  575.      example, could be used to recall and edit--primitively--the last entry. 
  576.  
  577.      Comment: if you do have CED, please use the CED edit keys, not the DOS 
  578.      keys; at least in our version of CED (version 1.0D), such use within an 
  579.      application causes fascinating but annoying CED conflicts.  PC-WREAD can, 
  580.      we believe, deal with all of these in stride, but try not to tempt fate. 
  581.      
  582.      Now about the Directory display: again, PC-WREAD tries to be accomodating.
  583.      It will display the files in the last valid Drive:\Path named to it, 
  584.      whether or not it located the specific file requested there.  Note the 
  585.      words "last" and "valid"--the to-be-displayed Directory doesn't change, no 
  586.      matter how many file-request attempts you make, until one of those 
  587.      attempts contains at least a Drive-Path combination that is valid 
  588.      (regardless of the file name's validity).  Naming no Drive or Path is 
  589.      equivalent to specifying the current Directory, so that's what PC-WREAD 
  590.      will show if you call a file (whether or not at first entry) by file name 
  591.      only, and also if you call no file name at all when first invoking it.
  592.  
  593.      And as to changing the Directory display without calling for a particular 
  594.      file: when you use a *, a [, or a ] by itself as a "file name" request, 
  595.      PC-WREAD will take you to a special Path-select screen.  The rules here 
  596.      are very similar to those at the main "what-next?" screen, except that no 
  597.      specific file is to be named.  You can end your Path specification with a 
  598.      \ or not, as you may be used to--PC-WREAD will take it either way.  
  599.      
  600.      Here too, PC-WREAD will tell you what problem it may be having with an 
  601.      invalid entry.  And, as the screen will inform you, just pressing <Enter> 
  602.      with no entry will be interpreted as a request for the current Directory. 
  603.  
  604.      Understand this:  changing the PC-WREAD display Directory does NOT change 
  605.      the DOS default Directory, nor will PC-WREAD recognize the displayed 
  606.      Directory as a default for file selection unless it really is also the DOS 
  607.      default Directory (and if it is, the top framing line will say so).  If 
  608.      you want to see a file from the displayed list, unless it happens to be 
  609.      the current Directory, you must enter the complete Path as part of the 
  610.      file specification.  (The same applies concerning Drives.)  The PC-WREAD 
  611.      display is only a tool to help you remember the full, correct name of 
  612.      files you may want to see.  PC-WREAD never changes its startup DOS default 
  613.      Drive and Path, and always returns you to them when you exit from it. 
  614.  
  615.      A last note: Because PC-WREAD takes in files in "blocks," as detailed 
  616.      later, when scrolling through a long file you will every so often 
  617.      experience a very brief delay--noticeable, but just barely so--between 
  618.      some pair of screens.  Because PC-WREAD uses overlapping blocks, you will 
  619.      have to move some distance through the file before experiencing another 
  620.      such delay; you cannot find yourself jumping back and forth between blocks 
  621.      at some specific line-count position.
  622.  
  623.  
  624.                          ╔════════════════════════════╗
  625.                          ║   PC-WREAD: How It Works   ║
  626.                          ╚════════════════════════════╝
  627.  
  628.      
  629.      
  630.      In this section, we explain some of PC-WREAD's functioning and detail its 
  631.      capabilities and limitations.
  632.  
  633.      PC-WREAD does not necessarily load the entire document file into memory 
  634.      all at once.  To save start-up time, and allow handling of files of any 
  635.      length, it deals with document files in "blocks" of 32Kbytes at a time
  636.      (of course if the entire file is 32K or less, PC-WREAD takes it all at 
  637.      once).  If you ask PC-WREAD to scroll the file such that it needs text 
  638.      outside the 32K block currently in memory, it will load in a new 32K 
  639.      block, but one offset (up or down, as appropriate) only 16Kbytes from the 
  640.      block that was current.  In this way, your current screen position in the 
  641.      document--which was the edge of the former block--is now at the midpoint 
  642.      of the new block.  You thus have plenty of room to move around in either 
  643.      direction before you will force PC-WREAD to read another new block.
  644.  
  645.      When we say PC-WREAD can handle files of "any" length, we mean any length 
  646.      that can be stored on today's storage media, or most likely even on 
  647.      tomorrow's: PC-WREAD's file-length specifier is 32 bits long, allowing 
  648.      files of up to 4,096 Megabytes.  Even laser disks won't be a problem!
  649.  
  650.      Scrolling in PC-WREAD is limited top, bottom, and left by the file's 
  651.      "edges"; rightward scrolling, described earlier as unlimited, actually is
  652.      limited, but only to 32,767 columns--you'd get a crick in the fingers 
  653.      scrolling out that far, even ten columns at a time.  There's no reason to 
  654.      ever go that far, nor for PC-WREAD to be able to; it just happens that it 
  655.      can.  (At bottom, you can scroll up until the last file line is atop the 
  656.      screen, facilitating exact line-number referencing without counting.)
  657.  
  658.      When scrolling rightward, PC-WREAD does not ignore the columns off-screen 
  659.      leftward; it keeps track of font-effect characters in that invisible area, 
  660.      and knows what the current screen effect should be even if the font 
  661.      character that turned it on is a thousand columns leftward.
  662.  
  663.      Speed of operation with PC-WREAD will, of course, vary depending on quite 
  664.      a variety of factors, the foremost of which is the specific hardware that 
  665.      makes up your computer system: from a basic PC or XT to a PS/2 Model 80, 
  666.      there is an almost 16-to-1 clock ratio, and that by no means tells it all. 
  667.      
  668.      Also remember (or learn) that when measuring intervals internally on a 
  669.      computer, such as with the TIMER function in BASIC, we can get results as 
  670.      precise as we want, but they will only be accurate to about .027 second.  
  671.      (Never confuse precision with accuracy; you can say that the time now is 
  672.      4:37 p.m. and 17.3 seconds, which is very precise, but if you're using a 
  673.      sundial to get it, probably not very accurate.)  In the IBM/clone family 
  674.      of computers, the standard software "clock tick" occurs roughly 18.2 times 
  675.      a second, or about every 55 milliseconds (.055 second). 
  676.  
  677.      Note one point: the first time that you press the <End> key, for a jump to 
  678.      file end, there will be a definite pause, the length of which will depend 
  679.      directly on the length of the file.  Because PC-WREAD displays the line 
  680.      number of its position in the file, it must go through the entire file 
  681.      counting line ends before actually making the jump; this can take time 
  682.      perceptible on the human scale, as noted below.  After that first time, 
  683.      PC-WREAD has the all-file line count and will simply make the jump, like 
  684.      any other block jump.  (PC-WREAD does not need the all-file line count for 
  685.      itself; it just wants to be able to show it to you.) 
  686.  
  687.      Also note that, depending on file size and your location in the file, 
  688.      "jumps" to file-top and file-bottom may not involve loading new blocks (if 
  689.      the whole file is under 32K, nothing does), and may thus take no longer 
  690.      than scrolling up or down by one line (a "screen jump").
  691.      
  692.      On a "Turbo XT clone" with a decent hard drive, we found these times: 
  693.  
  694.         ∙ initial start-up, file 32K or larger: circa 1.35 seconds
  695.         ∙    "      "   " ,  "  very small: circa 0.60 second
  696.         ∙ "block jump," full 32K block: circa 0.78 second
  697.         ∙ screen jump: circa .05 second
  698.         ∙ first jump-to-file-end: circa 1 second for every 46K of file
  699.  
  700.      As noted, these will vary, but all in all--regardless of your exact 
  701.      hardware configuration--you should find PC-WREAD comparable in speed of 
  702.      operation to whatever you're accustomed to in your environment from any 
  703.      good-quality screen-display program, and perfectly usable. 
  704.  
  705.      About screen colors: you are not seeing this document with SEE, the actual 
  706.      evaluation version of PC-WREAD, but rather with SEEDOC, a special-purpose 
  707.      version of SEE.  The effects displayed here (particularly if you are 
  708.      seeing this in color) are--in effect--what you would get if you had 
  709.      customized your PC-Write configuration files in a specific way pertaining 
  710.      to displays, a process we strongly recommend.  Please review (with SEE of 
  711.      course!) the supplementary file COLORS.DOC for a fuller discussion of the 
  712.      fascinating and subtle matter of customizing displays in PC-Write. 
  713.  
  714.      The actual evaluation version of PC-WREAD, SEE.EXE, simply uses all the 
  715.      PC-Write default screen-display colors or attributes.  If you have 
  716.      customized those, PC-WREAD in that version will not know that.  
  717.      
  718.      The full-registration version is smarter.  It will search the Path for the 
  719.      two PC-Write configuration files, ED.DEF and PR.DEF; if it finds them, it 
  720.      will search them for any screen-display redefinitions that you may have 
  721.      placed there, and will use that information itself.  It will recognize any 
  722.      and all <Alt>-<letter key> font redefinitions, plus any redefinition of 
  723.      the "normal text" display or the line-end-fill display (but not any 
  724.      redefinition of the "lines under last text" area display).
  725.  
  726.      PC-WREAD does not at this time have a text-string search capability.  If 
  727.      the response to the initial release is sufficient, such may be added.
  728.  
  729.      Whether or not you elect to use and register PC-WREAD, we would certainly 
  730.      appreciate any feedback, positive or negative, about it, and especially 
  731.      about features you would like to see added (or subtracted).  Please send 
  732.      any comments to the registration address at the end of this file.
  733.  
  734.                                         | 
  735.                                   (more follows)
  736.  
  737.   
  738.      
  739.  
  740.                          ╔════════════════════════════════╗
  741.                          ║   PC-WREAD: Basic Background   ║
  742.                          ╚════════════════════════════════╝
  743.      
  744.  
  745.      
  746.                              Some Primers For Newcomers 
  747.  
  748.   
  749.      All "characters"--things that can be typed, printed out, or displayed on a 
  750.      screen--are single bytes of data; a byte, being 8 bits of data, can have 2 
  751.      to the 8th power, or 256, different values, ranging from 0 to 255.  The 
  752.      numerical value of a byte used as a character is referred to as its code; 
  753.      the phrases "ASCII code" or "ASCII value" are also often used, but 
  754.      properly speaking only the codes from 32 to 127 inclusive are "ASCII" 
  755.      codes.  ASCII is an acronym for American Standards Committee on 
  756.      Information Interchange, which long ago defined standard meanings to be 
  757.      assigned to the "ASCII" codes: for example, code 65 universally 
  758.      denominates the capitalized form of the letter A.  
  759.      
  760.      Codes outside the ASCII range are not standardized.  Two near standards--
  761.      by no means universal--have evolved for the "extended ASCII" range of 
  762.      characters with codes from 128 to 255: the Epson version and the IBM 
  763.      version (these are not their formal names--they don't have any such).  In 
  764.      the Epson version, the ASCII characters repeat but in italics; thus, 
  765.      character code 193, which is 65 (the ordinary capital A) plus 128 (to 
  766.      shift it to "high-order"), is an italicized capital A.  In the IBM 
  767.      version, the 128 so-called "high-order" codes produce a fascinating 
  768.      variety of graphic characters, many of which can be combined to draw neat 
  769.      boxes like this: 
  770.  
  771.             ╔═════════════════════════════════════════════════════╗
  772.             ║   DON'T FORGET TO REGISTER YOUR COPY OF PC-WREAD!   ║
  773.             ╟─────────────────────────────────────────────────────╢
  774.             ║   It's the honorable thing to do, and it's cheap!   ║
  775.             ╚═════════════════════════════════════════════════════╝
  776.  
  777.      The characters with codes below 32 are less standardized yet.  Virtually 
  778.      no printer, unless especially instructed to (and not all can be so 
  779.      instructed), will print any such character.  Screen-display responses vary 
  780.      with programming language, but many of these low-code characters will not 
  781.      even show on the screen (unless poked directly into video memory).  
  782.       
  783.      There is a reason for this apparent discrimination: these 32 codes are 
  784.      very commonly used to send commands to peripherals, especially printers. 
  785.  
  786.      PC-Write makes use of these 32 low-code characters as what it calls font-
  787.      control characters.  As you create a document with PC-Write, you embed 
  788.      font-control characters in your text, either explicitly with the <Alt> key 
  789.      plus a letter key, or implicitly (as, for example, by pressing the 
  790.      <Enter> key).  As you will know, embedded <Alt>-<letter>--that is, font-
  791.      control--characters are used by PC-Write to send instructions to your 
  792.      printer as to how to treat the affected text: "normal," boldfaced, italic, 
  793.      and so on.  
  794.      
  795.      PC-Write does not send these codes directly to your printer, which would 
  796.      not understand them; the print portion of PC-Write (as contrasted with the 
  797.      edit portion that you use to create the file) translates each such font 
  798.      character into the corresponding codes specifically appropriate to your 
  799.      brand of printer.  You will remember that at your first use of PC-Write 
  800.      you had to tell it what printer you have; this was so that it would know 
  801.      into what codes to translate each embedded font-control character in your 
  802.      document.  Printer control codes are scandalously nonstandardized; even 
  803.      so-called "compatible" printers often have their individual quirks (but 
  804.      again, the two quasi-standards are Epson and IBM).
  805.  
  806.      As you also should know, PC-Write varies the on-screen appearance of 
  807.      document portions that are influenced by an embedded font-control 
  808.      character, so that you can keep track of what you've done to what.  It 
  809.      normally distinguishes 22 such modes on screen (10 others have no special 
  810.      effect on screen-display text).  For color-monitor users, PC-Write 
  811.      normally uses 10 "non-standard" color combinations to distinguish between 
  812.      those 22 modes, while monochrome-monitor users have 4 "non-standard" 
  813.      looks: reverse, bright, underline, and bright underline.  
  814.      
  815.      Obviously, unique identification of the text alteration mode is never 
  816.      possible in monochrome, and is not completely implemented even in color, 
  817.      at least in the PC-Write defaults.  The folks at Quicksoft grouped their 
  818.      default font-display choices into quite reasonable, and thus informative, 
  819.      patterns, although the color choices in particular are rather bland--
  820.      inoffensive but unexciting.  
  821.  
  822.      We strenuously urge you to review the file COLORS.DOC, which is part of 
  823.      the PC-WREAD evaluation package, for a thorough discussion of the topic, a 
  824.      discussion too long to be included in this already lengthy outline of PC-
  825.      WREAD.  There, we examine the various conflicting criteria for screen font 
  826.      displays, and derive and explicitly list the values used in the document 
  827.      you are now reading.  (Use SEE to view COLORS.)
  828.  
  829.      PC-Write allows you to toggle font-control characters from visible to 
  830.      invisible and vice-versa very easily (that's the characters themselves, 
  831.      not their display effects on affected text), but unless you have a special 
  832.      need to briefly examine what's where, it's far easier to keep them 
  833.      invisible while working (for once, contrary to the PC-Write manual), and 
  834.      most PC-Write users we know do so most of the time. 
  835.      
  836.      You can change the way PC-Write screen-displays text affected by a given 
  837.      font-control character via appropriate customization commands placed in 
  838.      the PC-Write PR.DEF file.  You can also, via the PC-Write ED.DEF file, 
  839.      change the appearance of "normal" text and other screen-display areas 
  840.      (such as the Status Line).  Again, see COLORS.DOC for more information. 
  841.  
  842.                                         |
  843.                                         |
  844.                                         |
  845.                                         |
  846.                                         |
  847.                                         |
  848.                                         |
  849.                                         | 
  850.                                   (more follows)
  851.  
  852.  
  853.  
  854.               
  855.                     ╔═════════════════════════════════════╗
  856.                     ║            AN APPENDIX:             ║
  857.                     ╟─────────────────────────────────────╢
  858.                     ║   PC-WREAD: Uses Without PC-Write   ║
  859.                     ╚═════════════════════════════════════╝
  860.  
  861.  
  862.  
  863.      If you are a confirmed proponent of some word processor other than PC-
  864.      Write, PC-WREAD is by no means useless to you.  Certainly it does lose 
  865.      some of its value as a simple reviewer of files you have created with your 
  866.      word processor, unless that word processor also uses an embedded-character 
  867.      scheme involving the 32 low-order codes (Codes 0 - 31).  In that case, you 
  868.      can readily make PC-WREAD work for you directly by creating a PR.DEF and 
  869.      an ED.DEF file pair with such characters "customized."  PC-WREAD scans any 
  870.      file named PR.DEF located anywhere on the Path for appropriately formatted 
  871.      screen-display characteristics definitions.  A format for such definitions 
  872.      is supplied somewhat farther on; by following it out, one can define the 
  873.      screen appearance for text controlled by any 26 of the 0-to-31 low codes. 
  874.  
  875.      But the second main area of use for PC-WREAD, simply reading on-screen 
  876.      documentation files, remains highly useful.  All that need be done is to 
  877.      create a file that is "flat ASCII"--that is, which initially contains no 
  878.      below-code-32 characters.  It should then not be difficult to embed such 
  879.      characters wherever desired by manually inserting them.  PC-Write uses the 
  880.      <Alt> key in combination with letter keys to generate and embed such 
  881.      characters, but lacking PC-Write you can use the DOS keypad method.
  882.  
  883.      By depressing and holding down the <Alt> key, one can generate from the 
  884.      keyboard any character by pressing at the numerical keypad, digit by 
  885.      digit, the code for that character.  In other words, to generate a capital 
  886.      A (code 65), you can depress Alt, press the 6 key of the numeric keypad 
  887.      and then the 5 key of that keypad, then release the <Alt> key.  This is 
  888.      vital:  Only the NUMERIC KEYPAD keys work in this instance!  The regular
  889.      "typewriter" number keys will NOT perform this function.
  890.  
  891.      That's a clumsy way to enter a capital A, but it works just fine for any 
  892.      character you can't enter via a straightforward keypress.  You can also, 
  893.      in some programs, use a Ctrl-letter key combination, but many programs 
  894.      intercept such key actions and interpret them as special commands.
  895.  
  896.      Remember that making a PC-WREAD-readable file is a one-time task; after 
  897.      that, it's always available for reading (attention software developers!). 
  898.  
  899.      To return to adapting PC-WREAD to work with a word processor that is not 
  900.      PC-Write but that does work by embedding low-code characters: all one need 
  901.      do is make a pair of files, named PR.DEF and ED.DEF, to redefine for PC-
  902.      WREAD what the embedded characters mean.
  903.  
  904.      Note: this discussion applies only to the full-featured version of PC-
  905.      WREAD; the shareware distribution version does not read the .DEF files for 
  906.      display redefinitions.
  907.  
  908.      The key to the redefinitions, beyond the simple mechanics of the syntax, 
  909.      presented below, is understanding the "attributes."  An attribute is, 
  910.      somewhat like a character, a one-byte datum; each of the 2000 character 
  911.      positions on the screen (80 x 25 = 2000) has an attribute byte associated 
  912.      with it that determines how the character at that position will be 
  913.      displayed: the foreground/background colors (and intensity and blink) in 
  914.      color, or the mode in monochrome (normal, bold, underline, bold underline, 
  915.      or reverse).  Each bit in the byte controls some aspect of the display; to 
  916.      explain it all here would be a bit much--consult the file COLORS.DOC
  917.      for details--but the attribute value is simply the bit pattern of the 
  918.      attribute byte reckoned as a number (e.g. attribute code 23 signifies an 
  919.      attribute byte with bit pattern 00010111, blue on white in color or 
  920.      "normal" in monochrome). 
  921.  
  922.      In the example below, M is the attribute value that you want for for 
  923.      monochrome monitors, X is a dummy value (PC-WREAD does not support single-
  924.      color-graphics type displays), and C is the attribute value you want for 
  925.      color monitors; code is, obviously, the code value of the low (0 to 31 
  926.      inclusive) "font character" that you want to have generate these effects. 
  927.  
  928.        >> THERE MUST BE SOME VALID ENTRY FOR  EACH OF THE THREE VALUES!! <<  
  929.                                                                              
  930.      Technically, "valid" means between 0 and 255 inclusive, but use 7 as a 
  931.      "dummy" entry for any monitor type you don't currently care about. 
  932.  
  933.      This is a general format for the definitions in a non-PC-Write PR.DEF:
  934.  
  935.           #Z:M.X.C=<code>
  936.  
  937.      For the Z shown, you can use any letter from A to Z inclusive; thus, you 
  938.      can associate screen-display attributes with up to 26 Code-0-to-32 
  939.      characters.  Which letter is associated with what code is unimportant. 
  940.  
  941.           REMEMBER: use this format only if you DO NOT use PC-Write!! 
  942.  
  943.  
  944.      You can also make an ED.DEF file to define the "normal" and line-fill 
  945.      attributes.  Use this format:
  946.  
  947.           &1:M.X.C  will define the "normal" attribute, while
  948.  
  949.           &2:M.X.C  will define the line-fill attribute.
  950.  
  951.      "Line-fill" is the unused space between the actual end of a file line and 
  952.      the right margin of the screen; very few people will want the line-fill 
  953.      attribute to differ from the "normal text" attribute.  One exception might 
  954.      be a text data file where all lines must be of a fixed length; a differing 
  955.      fill value would let you see the line's true length (otherwise you can't 
  956.      tell space characters from unused columns).  And again:
  957.  
  958.        >> THERE MUST BE SOME VALID ENTRY FOR  EACH OF THE THREE VALUES!! <<  
  959.                                                                              
  960.      and:
  961.  
  962.           REMEMBER: use this format only if you DO NOT use PC-Write!! 
  963.  
  964.  
  965.      By the way, why don't you?
  966.  
  967.       
  968.  
  969.      
  970.               
  971.                       ╔══════════════════════════════════╗
  972.                       ║   PC-WREAD: How To Register It   ║
  973.                       ╚══════════════════════════════════╝
  974.  
  975.  
  976.  
  977.      
  978.      Registration of PC-WREAD for single-site use is $10.  This will bring you 
  979.      a diskette with the latest full-featured version of PC-WREAD, plus a few 
  980.      other little HBH utilities--nothing big, but one or more might be of some 
  981.      interest to some of you (the exact list may vary from time to time).  It 
  982.      will also bring you a telephone number if you have questions, suggestions, 
  983.      or whatever to offer.
  984.  
  985.      Remember: you have 30 days maximum to use PC-WREAD without registering it!
  986.  
  987.      Obviously, no one and nothing can police such a restriction except your 
  988.      conscience and ethics, in which we--like all shareware authors--trust.
  989.  
  990.      Saving Money: If you send with your registration request a 5¼-inch DSDD 
  991.      (double-sided, double density) diskette in a plausibly reusable diskette 
  992.      mailer, you need only send $8 as the registration fee.  Or, if you want to 
  993.      fulfill your ethical obligation but don't feel the need for the augmented 
  994.      version of PC-WREAD (the sole difference is that the augmented version 
  995.      reads your PR.DEF and ED.DEF files for screen-appearance redefinitions), 
  996.      or the utilities surprise package, $8 will again suffice for the 
  997.      registration fee (and you will get the phone number in your return 
  998.      acknowledgement). 
  999.  
  1000.      Multi-Site Users: the fee schedule for multiple sites appears near the 
  1001.      front of this document.  When registering, please specify the number of 
  1002.      sites at which you will be using PC-WREAD.
  1003.  
  1004.      Customization: we can and gladly will customize PC-WREAD at extremely 
  1005.      modest costs.  Please write to us and outline your needs.
  1006.  
  1007.      "Bundling": Software authors--High Boskage House Software would be glad to 
  1008.      work with you.  We can customize PC-WREAD and, if desired, edit/rewrite 
  1009.      your .DOC files.  We are flexible and reasonable--write to us.
  1010.  
  1011.      Commercial Users: we make no distinctions.  Checks with orders, please.
  1012.  
  1013.  
  1014.            HERE'S THE ADDRESS: 
  1015.  
  1016.                High Boskage House
  1017.                63500 Argyle Road
  1018.                King City, CA  93930-9713
  1019.  
  1020.  
  1021.      Please do not send cash (does anyone ever do that?).  
  1022.      
  1023.      
  1024.            HERE'S HOW TO MAKE OUT THE CHECK: 
  1025.      
  1026.      Make the check or other payment instrument (Money Order, whatever) payable 
  1027.      to: 
  1028.  
  1029.                High Boskage House Software
  1030.  
  1031.  
  1032.      We thank you for your interest in PC-WREAD, hope you find it useful, hope
  1033.      you pass it along to others, and very much hope that you register it.
  1034.  
  1035.        ──────────────────────────────────────────────────────────────────── 
  1036.