home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / DATABASE / VISION70.ZIP / VISION.DOC < prev    next >
Text File  |  1993-07-23  |  60KB  |  1,634 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                 VISION   SYSTEM
  8.                                =================
  9.                               (v 7.0 01-Jul-1993)
  10.                                       by
  11.                               Maurizio  Ammannato
  12.                           (M) 1993  Maurizio's House
  13.                                  [<HyperText>]
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20. Press the ENTER key now to know some HyperText navigation rules.
  21.  
  22.  
  23.  
  24.  
  25.  
  26. Welcome to VISION System
  27. ========================
  28. Vision  is  a <Free Form Textual Data Base> System. The first access method is 
  29. the  usual  hierarchical  Chapter/Pages two-levels access. In this way you can 
  30. read  newspaper  articles,  documents,  books,  dictionaries, glossaries, help 
  31. files  ,etc.)  just  choosing  the Data Base you want read (first layer), then 
  32. its  Chapters  (second  layer),  finally the chapter' Pages (third layer). You 
  33. alternatively  can  access  a  VISION  Data Base using <Hyper Text> technique, 
  34. thus  <navigating>  text  through  its <keywords> (fourth layer). This package 
  35. allow  you  to  build  your  own  Text Data Base by yourself. It is not just a 
  36. "Read Only" package.
  37.  
  38.  
  39.  
  40.  
  41. Licence Fee
  42. ===========
  43. The  package  is completely free of charge for personal use. Do as many copies 
  44. you  like  for  you  and  your friends. However you're not allowed to make any 
  45. kind of profit or to do any commercial activity related to VISION.
  46.  
  47.  
  48.  
  49.  
  50.  
  51. MY PREFERRED SENTENCE
  52. =====================
  53. "The  best  VISION  for a Company should be its people jobs safeguard, letting 
  54. them  to prosper being at peace with the men and with God. The STRATEGY should 
  55. be  the  way  to  realize  this  VISION,  maintaining  the  Company's business 
  56. growing,  productive  and  profitable.  Not easy at all. That's why you should 
  57. have firstly a depth MISSION in your life."              (Oiziruam Otannamma)
  58.  
  59.  
  60.  
  61.  
  62. Enjoy VISION System !
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.                                                          Maurizio Ammannato
  78.                                                          Via Concordia N.80
  79.                                                         22049 Valmadrera (CO)
  80.                                                         ---------------------
  81.                                                               I T A L Y
  82.  
  83.  
  84.  
  85.  
  86.  
  87.                               TABLE  OF  CONTENTS
  88.                              =====================
  89.  
  90.  
  91.  
  92.             Decompressing Archives.......................... pag  4
  93.             VISION Configuration............................ pag  5
  94.             Color and Monochrome............................ pag  5
  95.             Compression..................................... pag  6
  96.             Converting .DB to New .DBC Format............... pag  6
  97.             Converting .DBC to Old .DB...................... pag  6
  98.             Temporary Storage............................... pag  7
  99.             VISION.MSG Message File......................... pag  7
  100.             Executing VISION................................ pag  8
  101.             VISION Data Base Structure...................... pag  9
  102.             Main Menu WINDOW................................ pag 10
  103.             Title WINDOW.................................... pag 12
  104.             Document WINDOW................................. pag 13
  105.             Reading Long Document........................... pag 13
  106.             Keyword WINDOW.................................. pag 14
  107.             Vision Data Base Technical Structure............ pag 15
  108.             Creating New Free Form Textual Data Base........ pag 16
  109.             New Data Base From Existing Text File........... pag 19
  110.             Updating Existing Data Base..................... pag 21
  111.             Erasing Data Bases.............................. pag 21
  112.             Sort Option..................................... pag 22
  113.             Changing The Main Menu List..................... pag 22
  114.             Directory Option................................ pag 23
  115.             Creating an HyperText Document.................. pag 24
  116.             How VISION Looks for Keywords................... pag 27
  117.             VISION Command Line............................. pag 27
  118.             Changing Screen Text Font....................... pag 27
  119.             Using VISION on LAN............................. pag 27
  120.             Using the MOUSE................................. pag 28
  121.             VISION and WINDOWS.............................. pag 28
  122.             Idle Time....................................... pag 28
  123.             PC Configuration................................ pag 28
  124.             History......................................... pag 29
  125.             HyperText Notes................................. pag 31
  126.  
  127.  
  128.                                                                      [pag  4]
  129.  
  130.  
  131. Decompressing Archives
  132. ======================
  133. Create  a <directory> called VISION (DOS command MD) and copy there VISION.ZIP 
  134. file  and  eventually  all  related  Textual Data Base with the extension .ZIP 
  135. (which means compressed via PKZIP.EXE utility).
  136.  
  137. Using  the  companion  PKUNZIP.EXE  utility  (which  you can find on many BBS) 
  138. decompress them as following :
  139.  
  140.  
  141.                             C:\VISION\pkunzip *.zip
  142.  
  143.  
  144. In this way all .ZIP archives will be 'unzipped'.
  145.  
  146.  
  147. The VISION package must have the following files :
  148.  
  149. - VISION.EXE             engine program
  150. - VIS_OVL.EXE            its overlay
  151. - VIS_CRE.EXE            create your own Textual Data Base (import)
  152. - VIS_UPD.EXE            from .DB database back to .UPD ASCII file (export)
  153. - LHA.EXE                LHA compressor
  154. - VIS_SORT.EXE           sort utility
  155. - VIS_FONT.EXE           change VGA screen text font
  156. - VISION.CFG             configuration file (default=color)
  157. - VISION.COL             configuration file for color monitor
  158. - VISION.BW              configuration file for mono monitor
  159. - VISION.MSG             comment/help file for VISION.EXE (default=English)
  160. - VIS_OVL.MSG            comment/help file for VIS_OVL.EXE (default=English)
  161. - VISION.DOC             VISION documentation in printable format (English)
  162. - #_VISION.NDX           documentation in VISION format (INDEX)
  163. - #_VISION.DB            documentation in VISION format (DB)
  164. - WHATIS.NEW             brief description of new features
  165.  
  166. Demo files:
  167. - VISION.DDD             example file for VISION.DIR option
  168. - #_PIPPO.UPD            example source file to build new VISION DB
  169. - #_PLUTO.UPD            example source file to build new VISION DB with
  170.                          HyperText facility
  171.  
  172. Other files:
  173. - LHA213.EXE             self extracting LHA documentation and disclaimer
  174. - PW.COM                 PC Password Protection and Screen Saver utility
  175. - PW.DOC                 PW.COM documentation
  176.  
  177.  
  178. Decompress  all  .ZIP  Data  Bases  you  have  in the directory using the same 
  179. procedure  as  before;  after that copy all .ZIP files in a back-up device and 
  180. REMOVE all .ZIP (i.e. "ERASE *.ZIP") to save precious disk space.
  181.  
  182.  
  183. To decompress <LHA> documentation: C:\VISION\lha213
  184.  
  185.  
  186.                                                                      [pag  5]
  187.  
  188.  
  189.  
  190. VISION Configuration
  191. ====================
  192. Check  through  your  favorite  Text  Editor,  or  WP,  the configuration file 
  193. VISION.CFG and change what you need or wish to change.
  194.  
  195.  
  196. Foreground  color numbers can range from 1 to 31 (after number 15 the color is 
  197. blinking). Background from 1 to 7.
  198. The following is the complete list of options you can set :
  199.  
  200.  
  201.  
  202. '---------------------------------- VISION.CFG config file
  203. SCROLL_SPEED=7     number of secs for automatic scrolling (Alt-A)
  204. IDLE=5             idle time (minutes) before screen saver execution
  205. SAVER=filename     full path of your preferred Screen Saver (try PW.COM)
  206. EDITOR=filename    full path of your preferred Text Editor (Alt-E)
  207. SORT=BYNAME        or BYDATE or NO sort option
  208. COMPRESSION=ON/OFF to allow or disallow LHA Data Bases compression
  209. TMP_DEV=dev/NO     the fastest device in your PC to allow temporary storage
  210. WDW_END=@@@        break-characters for Keyword Window
  211. SKD_LFT=60         source keyword left delimiting character
  212. SKD_RGT=62         source keyword right delimiting character
  213. TKD_LFT=17         target keyword left delimiting character
  214. TKG_RGT=16         target keyword right delimiting character
  215. F_DBW=15           foreground Data Base Window (DBW) color
  216. B_DBW=7            background Data Base Window (DBW) color
  217. F_BOT=0            foreground Help Desk color
  218. B_BOT=2
  219. F_COM=0            foreground DBW comment line
  220. F_HIG=14           foreground DBW data base name
  221. F_IDX=15           foreground Index Window (IW) color
  222. B_IDX=1
  223. F_TDX=7            foreground IW text color
  224. B_TDX=1
  225. F_DOC=0            foreground Document Text color
  226. B_DOC=7
  227. F_REV=0            foreground reverse Index title
  228. B_REV=6
  229. F_ASK=15           input window
  230. B_ASK=4
  231. F_FND=14           founded string color
  232.  
  233.  
  234.  
  235.  
  236. Color or Monochrome
  237. ===================
  238. You  can  easily change color attributes modifying .CFG file color parameters. 
  239. To  make  your  life  easier,  if  you have a monochrome screen, copy directly 
  240. VISION.BW to VISION.CFG file using DOS COPY command:
  241.  
  242.  
  243.                       C:\VISION\COPY vision.bw vision.cfg
  244.  
  245.  
  246.                                                                      [pag  6]
  247.  
  248.  
  249.  
  250. Compression
  251. ===========
  252. From  VISION  version  6.2  you  can  optionally  use the compression feature. 
  253. Firstly  write:  COMPRESSION=ON  in  the  VISION.CFG configuration file. Then, 
  254. when  you  use  VIS_CRE  program (or Alt-B command from VISION main window) to 
  255. build  a  new  Textual  Data Base from its source FILENAME.UPD file, you get a 
  256. new  file  with  .DBC  extension  (no  more  with  .DB  extension  as  before) 
  257. compressed  using  LHA  program  (the  last  "C"  character  in  the data base 
  258. extension  stands  for  Compressed). Doing that you can save disk bytes in the 
  259. ratio  of  about 8 to 1 (a filename.DB of 100.000 bytes can be reduced down to 
  260. 12.000 bytes in the compressed filename.DBC).
  261.  
  262. Executing  VISION  you  see  a  small  "c"  after the Data Base size number in 
  263. correspondence  to  the  compressed  .DBC  data  base.  (If  you don't use the 
  264. compression  option  everything  remains  the  same  as in the previous VISION 
  265. versions).
  266.  
  267. Choosing  the  highlighted data base name (ENTER key or clicking with the Left 
  268. Mouse  Button) with .DBC extension, VISION executes LHA to decompress it, then 
  269. shows  its text as usual. Due to LHA speed, the decompression activity doesn't 
  270. take no more than few seconds (depending on .DBC size and PC CPU speed).
  271.  
  272. You  can  make  some  tests  before  deciding  to  use this option or not. The 
  273. default setting is "ON".
  274.  
  275.  
  276.  
  277.  
  278. Converting .DB to New .DBC Format
  279. =================================
  280. 1) Set COMPRESSION=ON in VISION.CFG file.
  281. 2) Execute VISION
  282. 3) Move the bar up to data base name to covert
  283. 4) Press Alt-U keys to generate original ASCII .UPD file, then confirm
  284. 5) Press Alt-B keys to recreate the data base, now in compressed format
  285. 6) Give its name without any extension (the same name of point 3)
  286. 7) Write new data base comment line (if you wish the same as before)
  287. 8) Now, after compression, you have to see a "c" on the right of the filesize
  288.    number which must be much less than before
  289.  
  290.  
  291.  
  292.  
  293. Converting .DBC to Old .DB Format
  294. =================================
  295. 1) Set COMPRESSION=OFF in VISION.CFG file
  296. All other points are the same as before.
  297.  
  298.  
  299.  
  300.               ***************************************************
  301.               USE COMPRESSION OPTION TO SAVE A LOT OF DISK SPACE!
  302.               ***************************************************
  303.  
  304.  
  305.                                                                      [pag  7]
  306.  
  307.  
  308.  
  309. Temporary Storage
  310. =================
  311. VISION  and  LHA  work better if they have a fast device for temporary storage 
  312. (some  .TMP  files  etc.).  If you have such kind of device (i.e. a RAMDISK or 
  313. VIRTUAL  disk  on  for  example  "F:"  device), write TMP_DEV=F: in VISION.CFG 
  314. configuration file. Otherwise write TMP_DEV=NO to don't use this option.
  315.  
  316.  
  317.  
  318.  
  319. VISION.MSG Message file
  320. =======================
  321. Edit  VISION.MSG  messages file to change what you need (i.e. from my Italian-
  322. English to Queen's English, etc.)
  323.  
  324. To change language file use COPY DOS command :
  325.  
  326.  
  327.                      C:\VISION\COPY vision.ita vision.msg
  328.  
  329.  
  330. to   have   the   Italian  comments/help.  You  can  obviously  create  a  new 
  331. comment/help file with your own language; i.e. for Spanish :
  332.  
  333. - copy VISION.ENG into a new file VISION.ESP (DOS "COPY  VISION.ENG
  334.   VISION.ESP")
  335.  
  336. - modify the new file with Spanish translation using a TE or WP (Text Editor
  337.   or Word Processor)
  338.  
  339. - copy new VISION.ESP into VISION.MSG (c:\vision\COPY VISION.ESP VISION.MSG)
  340.  
  341.  
  342.  
  343.       ==================================================================
  344.       New comment strings MUST MUST have the same LENGTH of the old ones
  345.       ==================================================================
  346.  
  347.  
  348.                                                                      [pag  8]
  349.  
  350.  
  351.  
  352. Executing VISION
  353. ================
  354. Before  executing VISION for the first time, verify to have available at least 
  355. one  database  with  both .DB (or .DBC) and .NDX files. You must at least have 
  356. the  VISION  files.  You  can  create  a  new  one  by yourself (see below) or 
  357. download  some  from a BBS. Remember to decompress them if ZIPped as explained 
  358. before.
  359.  
  360.  
  361. You have two different ways to execute VISION.
  362.  
  363. 1)  MENU  MODE.  Typing  VISION at DOS prompt, you enter into Main Menu Window 
  364. with the list of available Data Bases (see below):
  365.  
  366.                                C:\VISION>vision
  367.  
  368.  
  369. 2)  COMMAND  LINE  MODE.  Typing VISION followed by data base name at DOS line 
  370. prompt,  you  enter directly into Index Menu from which, using ESCape command, 
  371. you come back directly to DOS :
  372.  
  373.                             C:\VISION>vision b_netw
  374.  
  375.  
  376.  
  377. If  you  have  a  VGA  monitor  you  can  execute vision typing VGA instead of 
  378. VISION.  This  allows  VISION  to  load into PC ROM a new text font (modern-d) 
  379. resulting in a more readable text:
  380.  
  381.                                  C:\VISION>vga
  382.  
  383.  
  384.  
  385. Also  in  this  case  you  can  enter directly into the Index Menu writing VGA 
  386. followed by data base name:
  387.  
  388.                             C:\VISION>vga #_vision
  389.  
  390. to have on line VISION documentation.
  391.  
  392.  
  393.                                                                      [pag  9]
  394.  
  395.  
  396.  
  397. VISION Data Base Structure
  398. ==========================
  399. Before  going  on,  it's a good idea to define the Textual Data Base structure 
  400. used by VISION.
  401.  
  402.  
  403.                       **********************************
  404.                       A VISION Data Base has FOUR layers
  405.                       **********************************
  406.  
  407.  
  408. 1) Data Base Layer (list of all available Data Bases names, up to 100)
  409. 2) Title Layer     (list of all Data Base Titles, no limit)
  410. 3) Page Layer      (text pages of selected Title, no limit)
  411. 4) Keyword Layer   (window text on selected word, no limit for keyword
  412.                     number, 16 windows in depth for each keyword)
  413.  
  414.  
  415. Two examples
  416. ------------
  417.  
  418. #_VISION Data Base:
  419. . Name, comment, creation date and size => Data Base LAYER (1st)
  420. . Chapter titles                        => Title LAYER (2nd)
  421. . Vision document Pages                 => Page LAYER (3rd)
  422.  
  423. N_GLOSSA Data Base:
  424. . Name, comment, creation date and size => Data Base LAYER (1st)
  425. . Glossary Terms                        => Title LAYER (2nd)
  426. . Term Description                      => Page LAYER (3rd)
  427. . Keyword Comment                       => Keyword LAYER (4th)
  428.  
  429.  
  430.                                                                      [pag 10]
  431.  
  432.  
  433.  
  434. Main Menu Window
  435. ================
  436. In  the  Main  Menu, you can see at the same time up to 16 available databases 
  437. with  related  comment,  last  update  data  and  size. The limit of available 
  438. databases  is 100. Press Alt-H keys (or Left Click on 24th line where the Help 
  439. info is) to get an on line help.
  440.  
  441.                        ********************************
  442.                        Alt-H to get VISION on line HELP
  443.                        ********************************
  444.  
  445.  
  446.                    Help - MAIN MENU Available Commands (1st)
  447.                    =========================================
  448.  
  449.    <Alt-B  Build New Data Base            >        PgDn  Page Down
  450.    <Alt-C  Change Data Base Comment Line  >        PgUp  Page Up
  451.    <Alt-D  Delete Data Base               >             Title Up
  452.    <Alt-E  Edit Source ASCII file (.UPD)  >             Title Down
  453.    <Alt-R  Restore Original Index         >        Home  Top of List
  454.    <Alt-S  Sort Title Index Ascending     >        End   Bottom of List
  455.    <Alt-T  Sort Title Index Descending    >        ─┘   Open Data Base
  456.    <Alt-U  Rebuild ASCII UPD file (EXPORT)>        ESC   Exit
  457.  
  458.  
  459.  
  460. Use  Up/Down  arrows or PgUp/PgDn to navigate, Alt-H for on-line help. Once on 
  461. the  line of chosen DB (highlighted color) the ENTER key allow you to open the 
  462. Title  Menu  (you  enter into 2nd layer). Using MOUSE, move its cursor on i.e. 
  463. 'PgDn'  string in the 24th line and click with the left button to activate the 
  464. Page Down function.
  465.  
  466.              *****************************************************
  467.              ENTER key or LEFT Click to OPEN highlighted Data Base
  468.              *****************************************************
  469.  
  470.  
  471. Initially  Titles  are  indexed sequentially (first record found, first record 
  472. in  DB).  You have two possibilities to change the indexing method by pressing 
  473. ALT-S  or ALT-T keys. These two commands tell VISION to sort highlighted index 
  474. by alphabetical ascending (ALT-S) or descending (ALT-T) order.
  475.  
  476.                   *******************************************
  477.                   Alt-S Alt-T to index differently Title list
  478.                   *******************************************
  479.  
  480.  
  481.  Any way Alt-R option restores the original indexing method.
  482.  
  483.                    *****************************************
  484.                    Alt-R to RESTORE original indexing Method
  485.                    *****************************************
  486.  
  487.  
  488.                                                                      [pag 11]
  489.  
  490.  
  491.  
  492. From  Main  Menu  you  can directly edit a new/old VISION source .UPD file. To 
  493. use  this option you have to declare before, in VISION.CFG file, the preferred 
  494. Text  Editor  with  its  FULL PATH and EXTENSION. Then, non depending on which 
  495. highlighted  name  you  are,  press  together Alt-E keys and give the filename 
  496. WITHOUT  .UPD  extension.  If  you  use  an  editor  called  EE,  in \EDITORS\ 
  497. directory on D: device, write in your VISION.CFG the following path:
  498.  
  499. ........................
  500. EDITOR=D:\EDITORS\EE.EXE
  501. ........................
  502.  
  503.                      ************************************
  504.                      Alt-E to EDIT source ASCII .UPD file
  505.                      ************************************
  506.  
  507.  
  508. From  Main  Menu  you  can  also  directly  build  a new VISION Data Base. Non 
  509. depending  on  which  highlighted  name you are, press together Alt-B keys and 
  510. give  the  New data base name WITHOUT .UPD extension (you must have this ASCII 
  511. file on VISION directory).
  512.  
  513.                     **************************************
  514.                     Alt-B to CREATE new Data Base (IMPORT)
  515.                     **************************************
  516.  
  517.  
  518. You  can also rebuild the original .UPD ASCII file from main Menu, 1) move the 
  519. bar  on  the  Data  Base  name  then  2)  press  Alt-U.  You  are required for 
  520. confirmation.
  521.  
  522.                   ******************************************
  523.                   Alt-U to REBUILD source .UPD file (EXPORT)
  524.                   ******************************************
  525.  
  526.  
  527. To  delete  an  existing Data Base, move the bar up to selected Data Base name 
  528. and  press Alt-D keys. Before removing highlighted Data Base, you are required 
  529. to  confirm that. This command DOESN'T cancel the related .UPD source file but 
  530. only .DB (or .DBC), .NDX and .KEY files.
  531.  
  532.                      *************************************
  533.                      Alt-D to DELETE highlighted Data Base
  534.                      *************************************
  535.  
  536.  
  537.                                                                      [pag 12]
  538.  
  539.  
  540.  
  541. Title Window
  542. ============
  543. Once on TITLE Window, press Alt-H keys to get the following on line Help :
  544.  
  545.  
  546.                    Help - TITLE WINDOW Available Commands (2nd)
  547.                    ============================================
  548.  
  549.     PgDn/Up Page Down/Up                /       Title Up/Down
  550.     Alt-H   This Help                   Home/End  Top/Bottom List
  551.     F1      Search String               F9        Search String Globally
  552.     F2      Search Again                F10       Global Search Again
  553.     ─┘     Open Document               ESC       Exit
  554.  
  555.  
  556. Use Up/Dn arrows and PgUp/PgDn keys to navigate this list.
  557.  
  558. If  you  have  a  long list you can use F1 key to quickly search the title you 
  559. need,  F2  to  search  again.  You  can  search also for a piece of word, i.e. 
  560. "etw".  In this case all words having "etw" will be displayed. F2 search again 
  561. using same search string.
  562.  
  563.                  *********************************************
  564.                  F1/F2 keys to SEARCH a word in the Title list
  565.                  *********************************************
  566.  
  567.  
  568. Using  F9/F10  you search instead for words line per line across documents. An 
  569. example.  Let  imagine  you  want  to  search  the  word "disciple" in the New 
  570. Testament.
  571.  
  572. 1) be in New Testament index window (Title level)
  573. 2) press F9 and give search string "disciple"
  574. 3) VISION finds search string in a book title
  575. 4) enter in the book (ENTER key)
  576. 5) press F2 to search same string inside the document
  577. 6) press ESC to come back to Index window
  578. 7) press F10 to search again at book title level (index)
  579.  
  580. The  difference  between two above searching methods is that F1/F2 keys search 
  581. the  string  within  the  index  comment line (Index level), while F9/F10 keys 
  582. search the string in the entire Data Base.
  583.  
  584.              ****************************************************
  585.              F9/F10 keys to SEARCH a word in the ENTIRE Data Base
  586.              ****************************************************
  587.  
  588.  
  589.  
  590. Opening Document
  591. ----------------
  592. Move  bar  up  to  desired  title,  then  press  the ENTER key to open related 
  593. document.
  594.  
  595.                     **************************************
  596.                     ENTER key to OPEN highlighted Document
  597.                     **************************************
  598.  
  599.  
  600.                                                                      [pag 13]
  601.  
  602.  
  603.  
  604. Document Window
  605. ===============
  606. Once in Document window press Alt-H keys to get the following help:
  607.  
  608.                    Help - DOCUMENT Window Available Commands (3rd)
  609.                    ===============================================
  610.  
  611.   TAB/s-TAB  Scroll Text Right/Left       s-Home    Left Scroll Home (col 1)
  612.   Alt-A      Automatic Scroll On/Off      PgDn/Up   Page Down/Up
  613.   Alt-F      Write Document to File       /       Line Up/Down
  614.   Alt-M      Mark Document Position       Home/End  To/Bottom List
  615.   Alt-J      Jump to Mark (Alt-M)         -/+       Dec/Incr Scroll Speed
  616.   Alt-P      Print Document               F1        Search String
  617.   -/-      Keyword Navigation           F2        Search Again
  618.   ─┘        Open Keyword                 ESC       Exit
  619.  
  620. (s-TAB = Shift TAB keys)                  (s-Home = Shift Home keys)
  621.  
  622. Up/Down  arrows,  PgUp/PgDown  and Home/End keys allow you to quickly navigate 
  623. across Document Window.
  624.  
  625.               **************************************************
  626.               Up/Down,PgUp/PgDown,Home/End to navigate DOCUMENTS
  627.               **************************************************
  628.  
  629.  
  630. While Left/Right arrows let you navigate through keywords (if they exist)
  631.  
  632.  
  633.                     **************************************
  634.                     Left/Right Arrows to navigate KEYWORDS
  635.                     **************************************
  636.  
  637.  
  638.  
  639.  
  640. Reading Long Document
  641. =====================
  642. Reading long document you need some functions to emulate real book reading.
  643.  
  644.  
  645. The  first  one  is to mark a position for latter retrieve. Use Alt-M when you 
  646. want  stop  reading  at  a  specific position (a soft beep advises you of work 
  647. done).  Once  you are back to same document use Alt-J to jump to mark. With no 
  648. mark, Alt-J jumps to first document line.
  649.  
  650.             ******************************************************
  651.             Alt-M and Alt-J to MARK a position for later retrieval
  652.             ******************************************************
  653.  
  654.  
  655. If  you want to read document without using arrows for navigation, you can use 
  656. the  Alt-A  automatic  scroll  option. VISION has a default value of 7 seconds 
  657. delay  time  between  scrolling (see in VISION.CFG the SCROLL_SPEED option) so 
  658. that  you  can  read  it  relaxed  and  quite.  Use  plus key (+) to slow down 
  659. scrolling speed or minus (-) key to increase it.
  660.  
  661.  
  662.                                                                      [pag 14]
  663.  
  664.  
  665.  
  666. Keyword Window
  667. ==============
  668. Once in the a <Keyword Window>, press Alt-H keys to get following Help:
  669.  
  670.  
  671.                    Help - Keyword Window Available Commands
  672.                    ========================================
  673.  
  674.           Alt-P  Print Window Text             PgDn/Up   Page Down/Up
  675.           Alt-F  Write Window Text to File     /       Line Up/Down
  676.           -/-  Keyword Navigation            Home/End  To/Bottom List
  677.           ─┘    Open Keyword                  ESC       Exit
  678.  
  679.  
  680.  
  681. Because  in  a  Keyword  Window  you  can  find other keywords, use Left/Right 
  682. arrows  to  navigate these new keywords. You can have up to 16 Keyword Windows 
  683. in depth.
  684.  
  685.            ********************************************************
  686.            Up to 16 Keyword Windows in depth for each DOCUMENT word
  687.            ********************************************************
  688.  
  689.  
  690.  
  691.  
  692. How Many Keyword Windows
  693. ------------------------
  694. When  at document level (3rd layer), each word can be a keyword. If a document 
  695. has  for  example  1000  words,  you can have at the maximum 1000 keywords for 
  696. this  level.  Once  open  one  of  these  1000  keyword, you enter FIRST LEVEL 
  697. Keyword  Window where you can find other keywords (in a Keyword Window you can 
  698. find  about  a  maximum  of  100 words per screen). Then you can choice one of 
  699. them  and  enter  in the SECOND LEVEL Keyword Window, and that up to 16 LEVELS 
  700. Keyword Windows in depth.
  701.  
  702.  
  703. If  we  have  for  example  a Data Base with 100 documents, each document with 
  704. 1000  words and assume that each of them are a keyword, and each of them opens 
  705. a  FIRST  level  window with about 100 keywords per window, up to 16 LEVELS in 
  706. depth,  the  maximum number of Keywords Windows we can have for that Data Base 
  707. is the following :
  708.  
  709.  
  710.                           100x1000x100x16=16,000,000
  711.  
  712.  
  713.                                                                      [pag 15]
  714.  
  715.  
  716.  
  717. VISION Data Base Technical Structure
  718. ====================================
  719. VISION  System  works  using  two  different  files,  the index file with .NDX 
  720. extension  and  data  base  file with .DB extension (or .DBC if compression is 
  721. ON).  If  Data  Base  uses  also keyword option, VISION creates in this case a 
  722. third file with .KEY extension.
  723.  
  724.  
  725. The following is its structure :
  726.  
  727. 1) Index record title (78 bytes 78 character)
  728. 2) Physical DB address (2 bytes integer)
  729. 3) Length of document  (4 bytes long integer)
  730. 4) Position of the Mark (2 bytes integer)
  731. 5) Reserved for later use (2 bytes integer)
  732.  
  733.  
  734. The  Data  Base  structure is depending on ASCII document maximum line length. 
  735. VIS_CRE  program  (executable  directly at DOS level or using Alt-B command on 
  736. VISION)  before  building  a  new  Vision Data Base, displays the maximum text 
  737. line length which is used to determine the simple Data Base structure:
  738.  
  739. 1) Comment line (variable length)
  740.  
  741.  
  742. But  you  have  to  don't care at all of this technical info, you have only to 
  743. follow these very simple instructions to create your new data base.
  744.  
  745.  
  746.                                                                      [pag 16]
  747.  
  748.  
  749.  
  750. Creating New Free Form Textual Data Base
  751. ========================================
  752.  
  753.  
  754. A) Building New Source ASCII File
  755. ---------------------------------
  756. Take  your  favorite  Text Editor or use Alt-E option from Main Menu to edit a 
  757. new  source  file  called  i.e. #_PIPPO.UPD (the .UPD extension is a MUST) and 
  758. write your info in the following order :
  759.  
  760. 1) First row will become FIRST index record
  761.  
  762. 2)  from  second  line up to the special break-characters line, write document 
  763. lines  (pay  attention  to  don't  write  the following special combination of 
  764. characters '@#$' at the line beginning).
  765.  
  766. 3)  special break-string combination to close the document; that is a '@#$' at 
  767. the beginning of the line.
  768.  
  769. Look at the following simple #_PIPPO.UPD example :
  770.  
  771.  
  772.                    ---beg of file----- (don't insert this line in your file)
  773. NETWORK
  774. ========
  775. The network is....
  776. ..................
  777. ..................
  778. [@#$]              (Don't write these squared brackets in real file)
  779. SUPER-CENTER
  780. ============
  781. The supercenters are....................................
  782. ........................................................
  783. ........................................................
  784. ........................................................
  785. ........................................................
  786. ........................................................
  787. [@#$]              (Don't write these squared brackets in real file)
  788. PROTOCOLS
  789. =========
  790. You need protocols when you
  791. have to exchange information with other people/computers.
  792. The language is one of above protocols.
  793.                    ---end of file----- (don't insert this line in your file)
  794.  
  795.  
  796.                                                                      [pag 17]
  797.  
  798.  
  799.  
  800.           **********************************************************
  801.           DON'T insert the break-string at the BEGINNING of the file
  802.           **********************************************************
  803.  
  804.  
  805.              ****************************************************
  806.              DON'T insert the break-string at the END of the file
  807.              ****************************************************
  808.  
  809.  
  810.           ***********************************************************
  811.           DON'T put BLANK lines between break-string and FIRST record
  812.           ***********************************************************
  813.  
  814.  
  815.                                                                      [pag 18]
  816.  
  817.  
  818.  
  819. B) Creating a VISION Data Base
  820. ------------------------------
  821. Once  done  this  ASCII  test  file, on VISION Main Menu, press Alt-B keys and 
  822. give  its filename without any extension. This file MUST reside in same VISION 
  823. directory.
  824.  
  825.             ******************************************************
  826.             .UPD source files MUST be in the same VISION directory
  827.             ******************************************************
  828.  
  829.  
  830. You  can  also  use  VIS_CRE program at DOS level without entering VISION Main 
  831. Menu :
  832.  
  833.                            C:\VISION\vis_cre #_pippo
  834.  
  835.  
  836. This  program  creates  #_PIPPO.NDX  with three master records (NETWORK,SUPER-
  837. CENTER,PROTOCOL) and the #_PIPPO.DB (or .DBC) data base with text.
  838.  
  839.  
  840. After  VISION has created these two files, it asks for a DB comment line. (You 
  841. can  also  change  this  comment  later,  on  Main  Menu  press  Alt-C keys on 
  842. highlighted name).
  843.  
  844.  
  845.  
  846. See  and  use  this  example  to understand how to build or to modify a source 
  847. ASCII  .UPD  file.  #_PIPPO.UPD  must  be  in  the VISION delivery disk or ZIP 
  848. archivie.
  849.  
  850.           ***********************************************************
  851.           USE #_PIPPO.UPD file to understand how to build a VISION DB
  852.           ***********************************************************
  853.  
  854.  
  855.                                                                      [pag 19]
  856.  
  857.  
  858.  
  859. New Data Base From Existing Text File
  860. =====================================
  861. This  procedure  is  the most common use of VISION because you have often some 
  862. .DOC/.MAN/.TXT/.HLP  files  in printable or listable ASCII format and you want 
  863. to  transform  them in the more readable VISION format. VISION can very easily 
  864. transform this ASCII files in a Textual Free Form Data Base.
  865.  
  866.            ********************************************************
  867.            VISION can quickly transform ASCII files in FREE FORM DB
  868.            ********************************************************
  869.  
  870.  
  871.  
  872. A) Modifying Source ASCII File
  873. ------------------------------
  874. Take  the ASCII file you want to convert and rename it with the .UPD extension 
  875. (i.e.  PIPPO.DOC  in  #_PIPPO.UPD);  remove  all extraneous lines (top of form 
  876. character,  page  break, etc.) and do exactly the same procedure as to build a 
  877. new VISION source .UPD file.
  878.  
  879.  
  880.  
  881. Example of #_PIPPO.UPD ASCII file to convert
  882. ------------------------------------------
  883.  
  884.  
  885.                          - Pag 1 -
  886.  
  887. NETWORK
  888. ========
  889. The network is....
  890. ..................
  891. ..................
  892.  
  893. TOF (Top of Form printer command)
  894.  
  895.                          - Pag 2 -
  896.  
  897. SUPER-CENTER
  898. ============
  899. The supercenters are....................................
  900. ........................................................
  901. ........................................................
  902. ........................................................
  903. ........................................................
  904. ........................................................
  905.  
  906. TOF (Top Of Form printer command)
  907.                          - Pag 3 -
  908.  
  909. PROTOCOLS
  910. =========
  911. You need protocols when you
  912. have to exchange information with other people/computers.
  913. The language is one of above protocols.
  914.  
  915.  
  916.                                                                      [pag 20]
  917.  
  918.  
  919.  
  920. Now  remove  ALL  EXTRANEOUS  lines,  i.e.  the  "Pag  nn"  lines,  the  "TOF" 
  921. characters,  the  blank  not  useful  lines, then follow the same procedure as 
  922. before  to  create  new  source file so that the original PIPPO.DOC looks like 
  923. the following #_PIPPO.UPD file :
  924.  
  925.  
  926.                    ---beg of file----- (don't insert this line in your file)
  927. NETWORK
  928. ========
  929. The network is....
  930. ..................
  931. ..................
  932. [@#$]              (Don't write these squared brackets in real file)
  933. SUPER-CENTER
  934. ============
  935. The supercenters are....................................
  936. ........................................................
  937. ........................................................
  938. ........................................................
  939. ........................................................
  940. ........................................................
  941. [@#$]              (Don't write these squared brackets in real file)
  942. PROTOCOLS
  943. =========
  944. You need protocols when you
  945. have to exchange information with other people/computers.
  946. The language is one of above protocols.
  947.                    ---end of file----- (don't insert this line in your file)
  948.  
  949.  
  950.  
  951. Once  PIPPO.DOC  has  been modified in this #_PIPPO.UPD way, enter VISION Main 
  952. menu and press Alt-B keys to generate new DB.
  953.  
  954.  
  955.                                                                      [pag 21]
  956.  
  957.  
  958.  
  959. Updating an Existing Data Base
  960. ==============================
  961. The best way to update a VISION DB is to :
  962.  
  963. 1) enter VISION Main Menu (1st level)
  964. 2) move the bar to Data Base name
  965. 3) press Alt-U keys and confirm
  966.  
  967. Now VISION creates again original .UPD source file, then :
  968.  
  969. 4) press Alt-E keys and give its name without any extension
  970. 5) change what you need to change or update or add
  971. 6) come back to VISION
  972. 7) Alt-B keys to recreate VISION Data Base (.DB[C], .NDX and eventually .KEY)
  973.  
  974.  
  975.  
  976.  
  977. Erasing Data Base
  978. =================
  979. Enter  VISION  Main  Menu,  move  bar on Data Base to remove, then press Alt-D 
  980. keys.  VISION  removes  only  .DB,  .NDX and .KEY files; it doesn't delete the 
  981. .UPD source ASCII file.
  982.  
  983.  
  984.                                                                      [pag 22]
  985.  
  986.  
  987.  
  988. Sort Option
  989. ===========
  990. You  can  have  the list of available TDB (Textual Data Bases) sorted in three 
  991. different ways (first Menu Window).
  992.  
  993. Write in VISION.CFG file your sorting choice.
  994.  
  995. SORT=BYNAME        It sorts Data Bases by names.
  996. SORT=BYDATE        It sorts Data Bases by date (last equal first)
  997. SORT=NO            VISION doesn't sort at all.
  998.  
  999. Using  SORT=NO  and  VISION.DIR  option,  you  can decide by yourself the Data 
  1000. Bases order (thus you get in main Window the exact order of VISION.DIR file).
  1001.  
  1002.  
  1003.  
  1004.  
  1005. Changing the Main Menu List
  1006. ===========================
  1007. Renaming  BOTH  files  (.NDX  and .DB file) with a name of your choice, VISION  
  1008. sorts  automatically  them  by  new  alphabetical  order  putting  them in the 
  1009. position you prefer (if the sorting option is set on BYNAME).
  1010.  
  1011.  
  1012. For example :
  1013.  
  1014. N_......  = network related data bases
  1015. P_......  = product related data bases
  1016. S_......  = services
  1017. V_......  = various and generic data base
  1018. $_......  = pricing data bases
  1019. ..  = ...............................
  1020.  
  1021.  
  1022.  
  1023. Simply  changing the name of your DB (and related .NDX and .KEY file), you get 
  1024. a  different  classification. For example if you want to put #_PIPPO Data Base 
  1025. in  first Main Menu line, execute the following DOS command, at DOS prompt, in 
  1026. the VISION directory :
  1027.  
  1028.                      C:\VISION\rename #_pippo.* !_PIPPO.*
  1029.  
  1030. to be sure to change all #_PIPPO DB related files.
  1031.  
  1032.  
  1033.                                                                      [pag 23]
  1034.  
  1035.  
  1036.  
  1037. Directory Option
  1038. ================
  1039. When  VISION starts, it firstly look for a file called VISION.DIR. So that you 
  1040. have two different VISION behavior :
  1041.  
  1042. 1) VISION doesn't find it in current directory.
  1043.    Then VISION looks for files on current directory as usual.
  1044.  
  1045. 2) VISION finds this file. Then it uploads DBs into Main Menu following
  1046.    VISION.DIR directive.
  1047.  
  1048. In  the  last  way you can have your VISION files anywhere in your PC. Look at 
  1049. the example for a better understanding.
  1050.  
  1051.        *****************************************************************
  1052.        Using VISION.DIR option you can have DB files ANYWHERE in your PC
  1053.        *****************************************************************
  1054.  
  1055.  
  1056.  
  1057. VISION.DIR example
  1058. ------------------
  1059. D:\VISION\#_VISION   (.DB .NDX and .KEY files on current dir)
  1060. C:\BIBLE\B_NEWT      (.DB .NDX and .KEY files on C:,in \BIBLE\ dir)
  1061. G:\V_PRESS           (.DB .NDX and .KEY files on G:\, optical disk)
  1062.  
  1063.             *******************************************************
  1064.             YOU MUST GIVE THE FULL PATH (DEVICE,DIRECTORY and NAME)
  1065.             *******************************************************
  1066.  
  1067.  
  1068. You  have  to  build  that  VISION.DIR  file using your preferred text editor. 
  1069. VISION.DIR  must  reside in the same VISION programs directory. Give a look to 
  1070. VISION.DDD, an example file in the distribution disk.
  1071.  
  1072.  
  1073. When  you  load  a new data base, remember to update VISION.DIR file otherwise 
  1074. the program will ignore it.
  1075.  
  1076.               **************************************************
  1077.               REMEMBER to UPDATE VISION.DIR when adding a new DB
  1078.               **************************************************
  1079.  
  1080.  
  1081.  
  1082. N.B.
  1083. If  the  compression  is ON, VISION executes before LHA to decompress the .DBC 
  1084. file  (every  where  it is on PC) into the .DB format file, which is temporary 
  1085. stored  in  the  SAME VISION directory. In this way, if you have for example a 
  1086. "write  once" optical disk containing VISION files, VISION decompress the data 
  1087. base  not  on  the  source  device (in this case the optical disk) but into an 
  1088. erasable device (where it is supposed VISION programs reside).
  1089.  
  1090.  
  1091.                                                                      [pag 24]
  1092.  
  1093.  
  1094.  
  1095. To Create an Hypertext Document
  1096. ===============================
  1097. To build document in <Hyper Text> way you have to remember three main things:
  1098.  
  1099. 1) how to declare a <SOURCE keyword> 
  1100. 2) how to mark a <TARGET keyword>
  1101. 3) how to write a <Keyword WINDOW>
  1102.  
  1103.  
  1104.  
  1105. HyperText Parameters in VISION.CFG
  1106. ----------------------------------
  1107. Give  a  look  at  VISION.CFG file (TYPE it or use a Text Editor). You have to 
  1108. find the following parameters:
  1109.  
  1110. WDW_EWND=@@@       this means you declare this three characters as the
  1111.                    break-string to let VISION understand where a Keyword
  1112.                    Window text stops.
  1113.  
  1114. SKD_LFT=60         source keyword left delimiting character
  1115. SKD_RGT=62         source keyword right delimiting character
  1116.                    these characters delimit the text word you want be
  1117.                    a text keyword
  1118.  
  1119. TKD_LFT=17         target keyword left delimiting character
  1120. TKG_RGT=16         target keyword right delimiting character
  1121.                    for each SOURCE keyword you have to declare a TARGET
  1122.                    keyword using these two delimiting characters
  1123.  
  1124.  
  1125. Now  an  example. Let's imagine to have the example as before (#_PIPPO.UPD) to 
  1126. which we want add HyperText facility. Call this new file #_PLUTO.UPD.
  1127.  
  1128.                  *********************************************
  1129.                  See #_PLUTO.UPD file for an Hypertext Example
  1130.                  *********************************************
  1131.  
  1132.  
  1133.                                                                      [pag 25]
  1134.  
  1135.  
  1136.  
  1137.                    ---beg of file----- (don't insert this line in your file)
  1138. NETWORK
  1139. ========
  1140. The <network> is....(here "network" is the 1st SOURCE keyword)
  1141. ..............................................................
  1142. ..............................................................
  1143. [@#$]              (Don't write these squared brackets in real file)
  1144. SUPER-CENTER
  1145. ============
  1146. The <supercenters> are............ (2nd SOURCE keyword)
  1147. .......................................................
  1148. .......................................................
  1149. .......................................................
  1150. .......................................................
  1151. .......................................................
  1152. [@#$]              (Don't write these squared brackets in real file)
  1153. PROTOCOLS
  1154. =========
  1155. You need <protocols> when you  (3rd SOURCE keyword)
  1156. have to exchange information with other people/computers.
  1157. The <language> is one of above protocols. (4th SOURCE keyword)
  1158. [@#$]              (Don't write these squared brackets in real file)
  1159. Hypertext Notes
  1160. ---------------
  1161. network          (1st TARGET keyword)
  1162. With Network word we intend here a Telecommunication Network.
  1163. Also called <VAN>.
  1164. [@@@]              (Don't write these squared brackets in real file)
  1165. supercenters
  1166. A Supercenter has clusters of processors, hundreds of disk devices.
  1167. For this reason we use to call them Supercenter.
  1168. [@@@]              (Don't write these squared brackets in real file)
  1169. protocols
  1170. See <protocol>
  1171. [@@@]              (Don't write these squared brackets in real file)
  1172. language
  1173. Usually  in Information Technology we use to call language a source high level 
  1174. group of rules to be translated in machine sequence of binary symbols.
  1175. [@@@]              (Don't write these squared brackets in real file)
  1176. VAN
  1177. It  stands for Value Added Network. Differs from carrier because of some added 
  1178. features like a protocol conversion, etc.
  1179. [@@@]              (Don't write these squared brackets in real file)
  1180. protocol
  1181. It's a group of rules to let participants to understand each other.
  1182.                    ---end of file----- (don't insert this line in your file)
  1183.  
  1184.  
  1185. We  have  declared  network  as  the first SOURCE keyword. We've enclosed this 
  1186. word  between decimal 60 character (as in CONFIG.SYS in SKD_LFT parameter) and 
  1187. decimal  62  character  (as  in  SKD_RGT).  Now  we  have to put somewhere the 
  1188. corresponding  TARGET  keyword.  You can change in CONFIG.SYS these delimiting 
  1189. characters.
  1190.  
  1191.  
  1192.                                                                      [pag 26]
  1193.  
  1194.  
  1195.  
  1196.               ***************************************************
  1197.               For each SOURCE keyword a TARGET keyword MUST exist
  1198.               ***************************************************
  1199.  
  1200.  
  1201.  
  1202.  
  1203. In  #_PLUTO.UPD  example  we've  put  at  documents  end a new document called 
  1204. "Hypertext  Notes"  where  we  can  write  all  Hypertext  TARGET keywords and 
  1205. related texts.
  1206.  
  1207. We  have  here  to declare first TARGET text (in this case the word "network") 
  1208. and  we  have  to enclose it between a "" decimal 17 (as in VISION.CFG in the 
  1209. TKD_LFT  parameter)  and a "" decimal 16 (as in TKD_RGT parameter). Obviously 
  1210. you can change these two characters in VISION.CFG.
  1211.  
  1212. After  TARGET  keyword  declaration  we  have to write below an explanation of 
  1213. this keyword with following limits : no more than 78 characters per line.
  1214.  
  1215.                  *********************************************
  1216.                  KEYWORD WINDOW limit is 78 characters x lines
  1217.                  *********************************************
  1218.  
  1219.  
  1220. After  text  end  write three "@@@" (as in VISION.CFG in WDW_END parameter) to 
  1221. let VISION understand where text stops.
  1222.  
  1223.              ****************************************************
  1224.              DON'T insert the break-string at the END of the file
  1225.              ****************************************************
  1226.  
  1227.  
  1228.  
  1229.  
  1230. Attention to break-string
  1231. -------------------------
  1232. When  you  are  using  HyperText capability, pay attention to the break-string 
  1233. characters  of  HyperText  texts (usually three "@@@", decimal 64, declared in 
  1234. VISION.CFG  in  the  WDW_END=xxx  option),  different  from  the  break-string 
  1235. characters  for  VISION  texts  (they MUST be ALWAYS "@#$", dec 64, dec 35 and 
  1236. dec 36).
  1237.  
  1238. You  have  the  option  to  change  the  HyperText  break-string  to  get more 
  1239. flexibility  in  designing  you  HyperText structure. In fact in the "glossary 
  1240. document"  case  you  need  to  have  each  VISION text be at the same time an 
  1241. HyperText  text  too. In this case, declare the same VISION break-string (thus 
  1242. "@#$")  in  WDW_END=xxx  parameter  in  VISION.CFG  file, for HyperText break-
  1243. characters.
  1244.  
  1245.        ****************************************************************
  1246.          Every time you're building a new doc with HyperText function
  1247.        VERIFY the break-string value on VISION.CFG in WDW_END parameter
  1248.        ****************************************************************
  1249.  
  1250.  
  1251.                                                                      [pag 27]
  1252.  
  1253.  
  1254.  
  1255. How VISION Looks for Keywords
  1256. =============================
  1257. When  VIS_CRE program founds a keyword, before saving it to filename.KEY file, 
  1258. it  removes  both  leading and trailing blanks, embedded blanks and convert it 
  1259. into  an UPPERCASE string. Thus the keyword "pippo" or "Pippo" is converted to 
  1260. "PIPPO". The keyword "Pippo is beautiful" to "PIPPOISBEAUTIFUL".
  1261.  
  1262.  
  1263.  
  1264.  
  1265. VISION Command Line
  1266. ===================
  1267. You can execute VISION also from another program capable to SHELL to DOS.
  1268.  
  1269. To  do  that  you  have  only  to  execute  VISION  in command line mode, thus 
  1270. VISION.EXE followed by data base name:
  1271.  
  1272.                            C:\VISION\VISION #_pippo
  1273.  
  1274.  
  1275.  
  1276.  
  1277. Changing Screen Text Font
  1278. =========================
  1279. If  you  have a VGA monitor, you can change the ROM standard PC font. You have 
  1280. to  execute before VISION a small utility VIS_FONT which loads a modern-d font 
  1281. (use firstly VIS_FONT /D option) into PC ROM.
  1282.  
  1283.  
  1284. You  can change the font using instead of /d the /s "scrawled" hand made font, 
  1285. or /l or no option for modern-s font.
  1286.  
  1287.  
  1288.  
  1289.  
  1290. Using VISION on a LAN
  1291. =====================
  1292. Create  a  VISION  directory  on the LAN server giving to ALL VISION files ALL 
  1293. LAN permissions (read, write, cancel, etc.)
  1294.  
  1295. In  reality,  to  don't  getting  mad  with  LOCK/UNLOCK  SHARE  and other LAN 
  1296. programming  techniques,  VISION  simply  generates  a temporary file, copy of 
  1297. requested  .DB,  .NDX and .KEY files for each LAN user requestor. Now, because 
  1298. usually  each  LAN PC executes a copy of VISION program on its CPU, with above 
  1299. procedure  it  reads  also  its  own data base copy. In this way no concurrent 
  1300. users conflict.
  1301.  
  1302.  
  1303.  
  1304.                                                                      [pag 28]
  1305.  
  1306.  
  1307.  
  1308.  
  1309. Using MOUSE
  1310. ===========
  1311. VISION  detects  if  a  mouse driver is loaded (MS software driver) and if the 
  1312. case  displays its cursor starting from the center of the Main Window. You can 
  1313. still  use  keyboard  commands.  The  Left  Mouse  Button is used to execute a 
  1314. command  and  the  Right  Button  always used to escape from current window or 
  1315. activity.
  1316.  
  1317. To  execute VISION commands you can move the mouse cursor to the 24th line and 
  1318. click  on  the  string  enclosed  between two brackets (decimal 60 and decimal 
  1319. 62).  You  can  also  enter the HELP window and click on the commands enclosed 
  1320. between the same brackets as before for the execution.
  1321.  
  1322. To  open  a  Databases  or  a Title or a Keyword you can move the mouse on the 
  1323. chosen  title,  then  click  once  to move there the highlighted bar, then the 
  1324. second Left Click will open it.
  1325.  
  1326.  
  1327.  
  1328.  
  1329. VISION AND WINDOWS
  1330. ==================
  1331. You  can  use  VISION  also  from  WINDOWS.  Once  on  WINDOWS  click  on  the 
  1332. application  group  you  prefer  than  click  on  FILE  and NEW. Give all path 
  1333. informations  and  choose  an  icon. Now VISION is one of the DOS programs you 
  1334. can  execute  from  WINDOWS.  To let VISION detect the mouse, you have to load 
  1335. the mouse driver BEFORE executing WIN.
  1336.  
  1337.  
  1338.  
  1339.  
  1340. IDLE TIME
  1341. =========
  1342. After  a  predefinited  idle  time (default is 5 minutes) VISION executes your 
  1343. preferred  Screen  Saver  (write  its  full  name in VISION.CFG file at SAVER= 
  1344. option).  Try  PW.COM  which  is in the package to have also a security way to 
  1345. leave VISION unattended.
  1346.  
  1347.  
  1348.  
  1349.  
  1350. PC Configuration
  1351. ================
  1352. You need any MS-DOS compatible Personal Computer with :
  1353.  
  1354. - at least 256 k Bytes of main memory
  1355. - hard disk
  1356. - video
  1357.  
  1358. better if :
  1359.  
  1360. - 640 K bytes of main memory
  1361. - VGA color video
  1362. - Mouse
  1363.  
  1364.  
  1365.                                                                      [pag 29]
  1366.  
  1367.  
  1368.  
  1369. History
  1370. =======
  1371.  
  1372.         4.1        - Added VIS_UPD.EXE to revert VISION Data Bases into
  1373.                      the original ASCII .UPD file.
  1374.  
  1375.                    - Fixed a bug while printing documents from a very large
  1376.                      Data base.
  1377.  
  1378.  
  1379.         4.2        - Fixed minor bug in main menu window when DBs are exactly
  1380.                      14 files.
  1381.  
  1382.  
  1383.         4.4        - 15 Data Base names on Main Menu instead of 14.
  1384.                      20 text rows on Text Windows instead of previous 19.
  1385.  
  1386.                    - No more RAM option.
  1387.  
  1388.                    - No more SOUND option.
  1389.  
  1390.                    - Added Data Base name SORT option.
  1391.  
  1392.                    - Slightly faster than 4.2 version.
  1393.  
  1394.  
  1395.         5.1        - Partially rewritten and recompiled used P.D.Q library
  1396.                      to have a complete assembler code. Much smaller than
  1397.                      before and faster.
  1398.  
  1399.                    - Added Hypertext Capability.
  1400.  
  1401.                    - Removed Alt-D shell to DOS.
  1402.  
  1403.                    - Added Alt-B to create new DB directly from Main Menu.
  1404.  
  1405.                    - Added Alt-E to edit source ASCII .UPD file.
  1406.  
  1407.                    - Added Alt-U to rebuild original source .UPD file.
  1408.  
  1409.                    - Added Alt-D to erase a DB from Main Menu.
  1410.  
  1411.                    - Each of four layers has each Help screen.
  1412.  
  1413.  
  1414.         5.5        - Fixed a bug in Command Line option.
  1415.  
  1416.                    - Alt-P and Alt-F in a Keyword Window print also first
  1417.                      line.
  1418.  
  1419.                    - No limit in a Keyword Window. Text can be of any length.
  1420.  
  1421.  
  1422.                                                                      [pag 30]
  1423.  
  1424.  
  1425.  
  1426.         6.0        - Text Data Base with variable record length
  1427.  
  1428.                    - Added TAB, Shift-TAB and Shift-Home commands to scroll
  1429.                      text left and right (variable line length).
  1430.  
  1431.                    - Revised VISION doc with added Hypertext features
  1432.  
  1433.  
  1434.         6.1        - Fixed a bug in Title section. Extraneous text after an
  1435.                      F10 type string search in some circumstances.
  1436.  
  1437.                    - Keywords are searched without taking care also of
  1438.                      embedded blanks (leading and trailing blanks were not
  1439.                      taken into account in previous versions)
  1440.  
  1441.  
  1442.         6.2        - Added compression option (using LHA)
  1443.  
  1444.                    - Cosmetics to VIS_CRE and VIS_UPD
  1445.  
  1446.                    - 16 titles instead of 15 in Main Menu
  1447.  
  1448.                    - Fixed a bug using VISION.DIR option and SORT=BYNAME
  1449.  
  1450.  
  1451.         6.3        - Fixed a bug when using VISION.DIR option
  1452.  
  1453.  
  1454.         6.5        - LAN version
  1455.  
  1456.         7.0        - MOUSE support
  1457.                    - Intel 486 compatibility
  1458.                    - Added Screen Saver option
  1459.                    - Changed graphic window characters to allow the use
  1460.                      of the extended international character set
  1461.  
  1462.  
  1463.                                                                      [pag 31]
  1464.  
  1465.  
  1466.  
  1467. HyperText Notes
  1468. ===============
  1469.  
  1470. Hyper Text
  1471. An  Hyper  Text  is  a  text  in which each word can be a keyword to access an 
  1472. other  text  via  a  Keyword  Window,  opening  new  text  paths, adapting the 
  1473. document  reading  to  the specific <reader knowledge>. Once in a new path (or 
  1474. in  a  new  <Keyword  Window>  )  you can find there another keyword to access 
  1475. another  keyword  window  so that you can <navigate> your text as you like, or 
  1476. better  as  it's  required by the level of your knowledge, following different 
  1477. text paths.
  1478.  
  1479. You  can  have  as  keyword even an IMAGE or a PROGRAM so that your text could 
  1480. become  a  media  not  only  to  inform readers but also to teach them lessons 
  1481. executing demo programs etc. VISION has text keywords only.
  1482.  
  1483. To declare a word be a keyword,enclose it between two <character delimiters>.
  1484. @@@
  1485.  
  1486. keyword
  1487. In  an  Hypertext  each  word can be a keyword, thus pressing the ENTER key on 
  1488. this  highlighted  word,  you  can  enter  in  a  new text path, opening a new 
  1489. <keyword window>.
  1490. @@@
  1491.  
  1492. keywords
  1493. See <keyword>
  1494. @@@
  1495.  
  1496. character delimiters
  1497. See <Character Delimiter>
  1498. @@@
  1499.  
  1500. Character Delimiter
  1501. VISION  must  know  the  hot  keyword  you want to investigate. It's enough to 
  1502. delimit  the  word  or  the  phrase  with two characters, the first one is the 
  1503. starting and the second one the ending character.
  1504.  
  1505. You  can use the character you want (declare them in the VISION.CFG file) i.e. 
  1506. brackets,   parenthesis,etc.   but  you  must  be  careful  to  don't  declare 
  1507. characters you use currently as text.
  1508.  
  1509. You  can  also use the character set from DECIMAL 1 to DECIMAL 31 (unprintable 
  1510. characters)  being  careful on some special characters like DECIMAL 26 (end of 
  1511. file).  Try  first  DECIMAL 16 (starting) and DECIMAL 17 (ending) or DECIMAL 4 
  1512. and 5.
  1513. @@@
  1514. Source Keyword
  1515. The  source  keyword  is  the  word  which opens a new text path opening a new 
  1516. <Keyword Window>.
  1517. @@@
  1518.  
  1519.  
  1520.                                                                      [pag 32]
  1521.  
  1522.  
  1523.  
  1524. Target Keyword
  1525. The  TARGET  keyword  is  the  corresponding  <Source  Keyword>  word with its 
  1526. explanation. In this opened new window, other keyword can exist.
  1527. @@@
  1528.  
  1529. Keyword Window
  1530. You  can  mainly  use this kind of keyword to immediately open a Pop Up Window 
  1531. on the Source Keyword, useful in HELP files.
  1532.  
  1533. VISION  looks  for  a keyword delimited  <character delimiters>, reads all the 
  1534. lines  up to ending mark (i.e. "@@@") and displays related text in a window of 
  1535. 78 characters x 20 lines.
  1536.  
  1537. A  Keyword  Window can have one or more keywords opening other Keyword Windows 
  1538. up to a maximum of 16 nested windows.
  1539. @@@
  1540.  
  1541. navigate
  1542. See <Navigation>
  1543. @@@
  1544.  
  1545. navigating
  1546. See <Navigation>.
  1547. @@@
  1548.  
  1549. Navigation
  1550. You can navigate an <Hyper Text> in the following way :
  1551.  
  1552. - Home key         go to document beginning
  1553. - End key          go to document end
  1554. - PgDn/PgUp        one screen page Down or Up (21 rows)
  1555. - Arrow Dn/Up      one line Down or Up
  1556. - Arrow Left/Right change keywords (if they exist)
  1557. - ENTER key        open a new <Keyword Window>
  1558. - ESCape key       come back to previous help window or main text
  1559. @@@
  1560.  
  1561. reader knowledge
  1562. Current  media force people to adapt themselves to them, having available only 
  1563. a  YES-or-NOT option. If you want to read a newspaper article you have to read 
  1564. everything  or  nothing,  if you're listening to a television speaker you have 
  1565. to  listen  all  the  speech  or to close the TV, the same for movie, theater, 
  1566. book etc.
  1567.  
  1568. Using  Hyper  Text  document,  the reader can decide the level of knowledge he 
  1569. wants,  because <navigating> the text he can go where he needs, can come back, 
  1570. navigate  again so that at the end he can learn exactly what he wants, nothing 
  1571. more, nothing less.
  1572. @@@
  1573.  
  1574. network
  1575. With Network word we intend here a Telecommunication Network.
  1576. Also called <VAN>.
  1577. @@@
  1578.  
  1579.  
  1580.                                                                      [pag 33]
  1581.  
  1582.  
  1583.  
  1584. supercenters
  1585. A Supercenter has clusters of processors, hundreds of disk devices.
  1586. For this reason we use to call them Supercenter.
  1587. @@@
  1588.  
  1589. protocols
  1590. See <protocol>
  1591. @@@
  1592.  
  1593. language
  1594. Usually  in Information Technology we use to call language a source high level 
  1595. group of rules to be translated in machine sequence of binary symbols.
  1596. @@@
  1597.  
  1598. VAN
  1599. It  stands for Value Added Network. Differs from carrier because of some added 
  1600. features like a protocol conversion, etc.
  1601. @@@
  1602.  
  1603. protocol
  1604. It's a group of rules to let participants to understand each other.
  1605. @@@
  1606.  
  1607. Free Form Textual Data Base
  1608. . Free Form        because you can build a new Data Base from an existing
  1609.                     ASCII, listable file, without any change.
  1610.  
  1611. . Textual          because each DB record is a text line
  1612.  
  1613. . Data Base        because VISION uses DB technique to organize text lines
  1614.                    in DB records
  1615. @@@
  1616.  
  1617. directory
  1618. A  DOS  directory  is  a  part  of  the  PC non volatile storage (hard disk or 
  1619. diskette).  You  can  create  a directory, enter into this directory or remove 
  1620. the directory.
  1621.  
  1622. MD = Make Directory (to create a new directory)
  1623. CD = Change Directory (to enter into a new directory)
  1624. RD = Remove Directory (to cancel an empty directory
  1625. @@@
  1626. LHA
  1627. VISION  uses  LHA version 2.13 July 20,1991 developed by Haruyasu Yoshizaki to 
  1628. compress  and  decompress  VISION  Data  Bases.  LHA  is  embedded into VISION 
  1629. programs so that you see only "Expanding Data Base.." message while it works.
  1630. Thank  you  to  Yoshizaki  this  program, under simple conditions you can read 
  1631. executing  LHA213.EXE  program included in this package and reading LHA213.DOC 
  1632. file, can be considered Public Domain.
  1633.  
  1634.