home *** CD-ROM | disk | FTP | other *** search
/ Dictionaries & Language / Dictionaries and Language (Chestnut CD-ROM) (1993).iso / word_p / magic15 / howto.mag < prev    next >
Encoding:
Text File  |  1989-06-02  |  44.4 KB  |  67 lines

  1.  
  2.     This file is a special BLACK MAGIC Hypertext document.  To read me
  3.  
  4. obtain MAGREAD.ARC from a local bulletin board, free of charge, or
  5. send $7 to: 
  6.  
  7.     NTERGAID
  8.     2490 BLACK ROCK TPK SUITE 337
  9.     FAIRFIELD, CT 06840
  10.  
  11. to receive, a disk copy of MAGREAD.ARC.
  12. You'll also get some of the latest documents written with BLACK MAGIC.
  13.  
  14.             Thank You
  15.             NTERGAID, Inc.
  16.            î╪6+]'Ä╪X├εå─BεJ├PR║    εB░
  17. FüNM::, 
  18. O
  19. F                   ?*O
  20. Fway is much quicker ,O
  21. F the end of the curr1    O
  22. FNOZ;`;ó[:O
  23. F?        Link Types?
  24. 22   ?providing commenCNO -> SCUBA        DNM                    EO
  25. F         Select To CHO
  26. F         Sel       /MO
  27. F  ╔NO
  28. ╜<├SO
  29. Feading Commands  O[O
  30. Fds                 cO
  31. Ff Introduction To ThhO
  32. F                   ?nO
  33. FDocument integrity avO
  34. Fre linked, they prov|O
  35. F                   ?ÇO
  36. F                   /àO
  37. F settings.         açO
  38. F                   /ìO
  39. F                   /ÉO
  40. Fhich these options cöO
  41. Fack Magic Command¢O
  42. F       l@k@r@íO
  43. Fankfully there are b¿O
  44. F fr                ?»O
  45. F                   ?┤O
  46. F                   /╗O
  47. Fesent time there is ╛O
  48. F                   ?┼O
  49. F                   /╔O
  50. F             WX╦O
  51. F                   /╤O
  52. F                    ╫O
  53. Fookmarkinthefile.▀NOookmarkinthefil αNMookmarkinthefile.πNODXDO7DrD╩ΣNM    °C`D ΓB µNOrowKey>), and then pτNMVDΦO
  54. F a hypertext documenδ
  55. 22╝D║D
  56. φ2
  57. 2ε    O
  58. F   óDíD¿D≈NO and through the use°O
  59. F                √NOa tool designed to mⁿNM                    NO       ence of this NM                   O
  60. F                        NOs first conceived by
  61. NM               aNOs linked to        NM                O
  62. F               O
  63. F                     NO                    !NM   ÇpÇÇÇ≡(NOÇÇÇpÇ<Ç)NMacopyfromashare-NOution              .NMOrder Blank" and   5NO   Orderitfromus.6NM              :O
  64. Fα<╘<▐<O22////////////////////QO
  65. F////////////////////Y22////////////////////\ NN////////////////////]O
  66. F////////////////////`22////////////////////a22////////////////////b22  tFfile.      tFfile.      tFfile.    Welcome and Greetings to: 
  67.  
  68.         Black Magic, The Hypertext Word Processor 
  69.  
  70. Black Magic is a revolutionary program designed to integrate ìthe power of hypertext into that of word Processing. 
  71.  
  72. Hypertext is a concept that is based on relating information ìby association. This is opposed to the typical database view ìof relating information in a rigid structure based on ìfieldsand records. With hypertext you are instead linking ìtogether ideas and concepts into a cohesive whole. As an ìexample of information that is linked by association, ìconsider this.  Remember back to when you first learned to ìdrive a car.  The first thing you may remember is you first ìaccident.  This is information that is linked by ìassociation.Withhypertext,youcansetupthistypeof ìinformation structure - one that works like your own mind. 
  73.  
  74. Hypertext relations (links) are shown by symbols embedded in ìthe text.  These symbols are a pair of Squares, Triangles or ìDimonds.  To active a link, move the cursor between the ìlinks below and press <F1>.  Do this now ... 
  75.                  (Please Select To Continue) n    As you can see, pressing <F1> jumped you forward to this ìscreen. That is the purpose of the <F1> key - To move ìforwardone link.  The opposite of <F1> is the <Esc> key. ìThis simply jumps you backwards one link.  Try pressing ì<Esc>now and then return to this screen (Remember - <F1>. 
  76.  
  77. As you just saw, pressing <Esc> jumped you back to the ìinitial screen and <F1> brought you back to here. ìAdditionally a mouse can be used to read a document.  With a ìmouse, the left button is used to go forward a link, and the ìright button is used to go backwards one link.  Using the ìmouse is as simple as pointing at a link (anything ìsurroundedby symbols) and clicking the appropriate button. 
  78.  
  79. Just as any other word processor, there are other keys that ìcan be used to move through a document.  These include the ìcursor keys, <PgUp>, <PgDn>, <Home> and <End>. 
  80.  
  81. Now that you know how to read a hypertext document, select a ìtopic from the below list or choose one of the links above. 
  82.      Link Types        
  83. Graphics 
  84.      
  85. Reading Commands   Other Commands 
  86.      6;Hypertext   <=How To Order 
  87.     ,@NewFeaturesu    <PgUp> & <PgDn> 
  88.  
  89. As in many other word processors, the <PgUp> and <PgDn> 
  90. keys move the cursor by screens of information. Moving the 
  91. cursor this way is much quicker than the arrow keys.     u    <Home> & <End> 
  92.  
  93. The <Home> and the <End> keyts can both be used to speed 
  94. your navigation through a hypertext document. 
  95.  
  96. The <Home> key simply moves the cursor to the beginning of 
  97. the line that it is on.  Similarly the <End> key jumps the 
  98. cursor to the last position on the current line. 
  99.  
  100. The use of these two keys can also be extended to Block 
  101. Marking.  When a block is defined, pressing the <Home> key 
  102. will change the marked area on the current line to the 
  103. first character.  Likewise the <End> key extends the 
  104. selection to the end of the current line.     
  105.         Link Types ...     
  106.  
  107. Black Magic features three different link types: Reference 
  108. Links, Note Links, Replacement Links,andGADOSLinks. 
  109.  
  110. Reference Links are the primary type of link that you have 
  111. encountered to date.  They are represented by a pair of 
  112. green triangles surrounding a block of text.  A reference 
  113. link is an actual physical jump to another section of the 
  114. document.  This is an example of a reference Link. 
  115.  
  116. Note Links are simply transient temporary links that appear 
  117. on screen in a small window.  Note links are useful for 
  118. making comments on the original text, or simply providing 
  119. additional information that would be nice to know but not 
  120. required.  This is an example of a Note Link. 
  121.  
  122. The third type of link is the Replacement link.  Replacement 
  123. links, true to their name, simply replace one block of text 
  124. with another.  This is very useful when you are unsure of 
  125. your audience's knowledge.  It gives you the ability to use 
  126. highly technical terms, by simply making them replacement 
  127. links.  Thus ->     SCUBA     o    That was a reference link.  It jumped you to another 
  128. completely different section or 'Node' of the document. 
  129. Note that it is still contained in the same file. 
  130.  
  131. There are now two ways to return to the previous Node. 
  132. First simply press <Esc>; this will return you to the last 
  133. link that you were at.  Secondly, select the reference link 
  134. below.  This link will loop back to the previous scree. 
  135. This demonstrates the ability of Black Magic to create 
  136. 'Looping Links'. 
  137.  
  138.                     (Select To Continue)     iNote Links are enclosed in a small window that 
  139. appears in the upper right corner of thescreen.ìThe window is scrollable, and can contain as much ìtext as is desired.The window is also ìresizeable and can even can contain a graphic. 
  140.  
  141. One restriction on a Note link is that they are ìlimited in that you cannot link outwards from ìthem.  Their purpose issimplyfor providing ìcomments or supplemental information. 
  142.  T SelfContainedUnderwaterBreathing ìApparatus      Graphics ... 
  143.  
  144. As you can see from this screen, graphics are able to form 
  145. an integral part of a hypertext document. 
  146.  
  147. COLLAT    
  148. The blue circle towards the upper left of the graphic along 
  149. the margin, is called a graphic indicator.  It is there to 
  150. give you a way to refer to the graphic to access the links. 
  151.                       Select To Continue     o    Graphics Con't 
  152.  
  153. As you just saw, graphics can be integrated into a hypertext 
  154. document.  Additionally links canbe forged outward from a 
  155. graphic, as you see below. 
  156.  
  157. COLLAT   ' F? 
  158. If you will notice, there isacircle with an 'X' in the ìgraphic.  Thiscircle indicate hypertext links outward 
  159. from a graphic.  To access one of these links, either click 
  160. on it with your mouse, or move the cursor onto the graphic 
  161. indicator and then press the right arrow again. 
  162.                           Select To Continue     o        Graphics Con't 
  163.  
  164. As you will notice, the graphic link indicator blinks when 
  165. you move onto it.  This is to indicate that it is selected. 
  166. Then if you press <F1>, you will activate that link.  To 
  167. return from that link, press <Esc> as you do for any other 
  168. link.  If there are multiple links in a graphic, continue 
  169. using the left and right arow keys to cycle through them to 
  170. the one that you wish to select.  To exit the graphic links, 
  171. either press the left arrow until you are out of the 
  172. graphic, or press the down arrow or up arrow. 
  173.  
  174. This is all that you need to understand to use graphics and 
  175. links in Black Magic. 
  176.  
  177.     ?Now jump back one link and practice with the graphics that 
  178. are there.            ? h    
  179.         $Reading Commands ...        $ 
  180.  
  181. There are several other optional commands that may be used 
  182. to enhance the reading of any Black Magic DocuYment.  Note - 
  183. these are only optional - all you really need to know is 
  184. <F1>, <Esc> <PgUp> and <PgDn>.  These merely streamline it 
  185. as I have said. 
  186.  
  187.                Key Combination     Command 
  188.                <Alt> <F1>           Collapse 
  189.                <Ctrl> <F2>         
  190. Map Document 
  191.                <Alt> <F2>          Reader Mode 
  192.                <F10>               Menu 
  193.                <Ctrl> <ArrowKey>   Jump By Link 
  194.                <Alt> H             Show/Hide Links 
  195.                <Alt> C             Configure Black Magic 
  196.                <Ctrl> F            Find 
  197.                <Ctrl> A            Again 
  198.                <Ctrl> O            Set Search Options 
  199.                <Alt> - <NumberKey> Place holders 
  200.  
  201.                 (Other Black Magic Commands)    
  202.            Other Commands     
  203.  
  204. Excluding commands related to reading hypertext documents, 
  205. Black Magic features several other commands that are useful 
  206. when reading a hypertext document.  T    .hese    . are listed below, 
  207. activate the links on those you are interested in. 
  208.  
  209.                Key Stroke          Command 
  210.                <Shift> <Arrowkey>  Block Definition 
  211.                <F10> P             Print 
  212.                <F10> U             File Utilities 
  213.                <F7>                Run A Macro 
  214.                <Shift> <F7>        Define Macro 
  215.                <F10> F              File Operations 
  216.                <Shift> <F9>        ! Open File 
  217.                <Alt> <F10>         "!Exit 
  218.                <Shift> <F10>       #"TSR Wait State 
  219.                <F10> F E           $#Export Text      
  220.  
  221.                       
  222. $ReadingCommands       Collapsing A Document 
  223.  
  224. The Collapse command is used to condense a document back 
  225. into its *+original state 
  226.  
  227. The use for it is to find your way back to the beginning of ìadocument when you are deep inside it.  To execute it, ìsimply press: 
  228.  
  229.      <Alt> <F1> 
  230.  
  231. This will then initiate the collapse process.  It may affect 
  232. the screen adversely at first as Black Magic collapses the 
  233. document, however the screen will be updated when it is 
  234. completely collapsed. 
  235.  
  236. Note when you are deep inside a large document, this can 
  237. take some time.      e    
  238. Mapping A Document 
  239.  
  240. The Mapping command calls up a graphic 'map' of the 
  241. document.  This map show the document is a network of 
  242. interconnected reference links.  To execute this press: 
  243.  
  244.      <Ctrl> <F2> 
  245.  
  246. Try this now to see the document as a whole. 
  247.  
  248. As you saw, the map is composed of three windows, the 
  249. largest being the map itself, and the two others being a 
  250. viewer into the selected node and a legend that explains how 
  251. to use the map. 
  252.  
  253. The numbers inside of each node are simply the internal 
  254. window numbers that Black Magic uses to refer to the node. 
  255. They are displayed there simply as a reference for you to 
  256. use - They have no "absolute" meaning in the sense that they 
  257. change with changes in the document's link structure.    
  258.  .        1    2Reader Mode    1    2 
  259.  
  260. For those of you that are using MAGREAD to read this, feel 
  261. free to skip right on by, it doesn't concern you.  For 
  262. those using MAGIC.EXE to read this, continue on. 
  263.  
  264. Black Magic has two distinct modes of operation: Reader Mode 
  265. and Authoring Mode.  The default upon startup is Authoring 
  266. mode.  In the authoring mode, you have the full capabilities 
  267. of Black Magic to edit and alter documents, while in the 
  268. Reader mode you are simply a browser where you cannot alter 
  269. anything. 
  270.  
  271. The difference between Reader mode and Author mode is seen 
  272. on screen on the bottom status or command line.  At the left 
  273. hand edge of the screen where the filename is, there is 
  274. either: 
  275.  
  276.      File: C:\MAGIC\FILES\FILENAME.MAG ----> Author Mode 
  277.                     OR 
  278.      Read: C:\MAGIC\FILES\FILENAME.MAG ----> Reader Mode 
  279.  
  280. The advantage to being in reader mode when using MAGIC.EXE 
  281. is twofold: ,Document integrity and )Jump By Link.     
  282.     The Menu 
  283.  
  284. Pressing <F10> calls up a menu along the bottom of the 
  285. screen from which many choices can be made.  The menu is a 
  286. .Lotus 123 style moving bar type menu that can be accessed by 
  287. using the arrow keys or the first letter of each item on the 
  288. menu.  The menu gives you access to: 
  289.  
  290.      *Block Commands 
  291.       +File Commands 
  292.      ,Search Commands 
  293.      -Print Commands 
  294.      -Config Commands 
  295.      /DOSUtilities Commands 
  296.      "0Exit Command 
  297.  
  298. Note - If you are either using Black Magic in 1reader mode, 
  299. or you are using the MAGREAD utility some of these commands 
  300. may be unusable.              )Jumping Link by Link    ) 
  301.  
  302. When you are using MAGREAD.EXE to read a Black Magic 
  303. Document, or when Black Magic is in 2Reader Mode, pressing 
  304. the Control key in conjuction with the left and right arrow 
  305. keys will jump you through all the links in any one window 
  306. one by one. 
  307.  
  308. This is very handy for quickly scanning a document and 
  309. determining what links you wish to focus in on in depth.     N    Show/Hide Links 
  310.  
  311. One of the problems with hypertext systems to date is that 
  312. when many links are available to the reader, the temptation 
  313. is very strong to simply browse through the links and never 
  314. read anything in depth.  In essence you go on a 'tour' of a 
  315. document, but don't necessarily learn anything. 
  316.  
  317. To combat this, there is a command in Black Magic to simply 
  318. show or hide all the available links instantly.  This 
  319. command is invoked by pressing: 
  320.  
  321.      <F4>
  322.  
  323. This will hide all available links, and then pressing: 
  324.  
  325.      <F4>
  326.  
  327. Again will redisplay the links.     t    Configuration Screen 
  328.  
  329. Pressing <F10>UC calls up a configuration screen through 
  330. which you can /3alter its defaults.  Among the things that ìcanbe altered are the default paths, colors, Show/Hide ìlinks, and Bookmark settings.     u        ,    7The Find (Search) Command    ,    7 
  331.  
  332. The Find command is used to do a text search for a 
  333. particular piece of text.  To execute this command, press: 
  334.  
  335.      <Ctrl> F 
  336.  
  337. Or 
  338.  
  339. K<F10>LSMF
  340.  
  341. A /4dialog box will come up for you to enter in the text ìthatyou wish found.  After entering the text and pressing 
  342. <Enter>, Black Magic will search for the text and then 
  343. either bring you to it or report that it could not be found. 
  344.  
  345. There is one thing to note about the Find command, it is 
  346. limited to the text in the current window only - It does 
  347. not search across links. 
  348.  
  349. Related Commands:   5Again 
  350.                     6Setting Search Options     m        5The Again Command    5 
  351.  
  352. The Again command is used to repeat the last Find command. 
  353. It uses the same text string, merely repeating it.  To 
  354. invoke the Again command, press: 
  355.  
  356.      <Ctrl> A 
  357.  
  358. Related Commands:   7Find 
  359.                     8Setting Search Options              6    8Search Options    6    8 
  360.  
  361. Black Magic has several search options with which you can 
  362. customize the searching process.  These options include 
  363. control over Whole Word Vs Partial Word Searching, Ignoring 
  364. the Case, and JCGlobalVs.Localsearch control.
  365.  
  366. These options are controlled by pressing: 
  367.  
  368.      <Ctrl> O 
  369.  
  370. This brings up a /9dialog box that is controlled by the cursor 
  371. keys, from which these options can be changed.     d    45PlaceHolders 
  372.  
  373. Markers orPlaceHoldersare invisible locators that you can ìembed within your text to quickly access any given location. ìOnce a marker is set, you can access it instantly from ìanywhere else in the document. 
  374.  
  375. To use a marker press <Alt> <NumberKey>.   There are a 
  376. maximum of nine (9) markers at any one time. There is no 
  377. correlation between the number of the marker and its 
  378. location in the document. The person defining the marker 
  379. makes the choice as to where marker number one is placed and 
  380. so on. It is a completely arbitrary process. 
  381.  
  382. To set a marker, press: 
  383.  
  384.      <ALT> -  <NumberKey> 
  385.  
  386. Here <NumberKey> is again used to indicate any number from 1 
  387. to 9. This will set marker number <NumberKey> at the line 
  388. that the cursor is on. To erase any given marker, merely set 
  389. a new one in its place. 
  390.  
  391.                      1:SelectToContinue b        '    *Block Definition    '    * 
  392.  
  393. Blocks are defined in Black Magic by simply holding down the 
  394. <Shift> key in conjunction with the <ArrowKeys>.  Defined 
  395. blocks are indicated by inverse video.  In Black Magic (not 
  396. MAGREAD.ARC), blocks are the basic unit for text ìmanipulation.  They can be Cut, Copied, Pasted, Boldfaced, 
  397. Undelined, Italicized, and Linked. 
  398.  
  399. In MAGREAD.ARC and reader mode of Black Magic, the purpose 
  400. of Block Marking is to provide a way to $%export text 
  401. sections of a document to a dos text file. 
  402.  
  403. To mark a Block, press the shift key and move the cursor 
  404. with the arrow keys, in order to highlight the desired 
  405. block.     t        -Printing Text    - 
  406.  
  407. You may wonder how Black Magic handles printing in a 
  408. hypertext environment with many links or nodes.  Black Magic 
  409. handles this very simply, by only printing the 'Current Text 
  410. Stream'. 
  411.  
  412. The Current Text Stream is simply that piece of text that 
  413. can be reached only with the cursor keys and <PgUp>/<PgDn> - 
  414. NOT using <F1> and <Esc>.  For example If you were to issue 
  415. the print command now, it would print out from "Printing 
  416. Text" to "Printer OptionsDialogBox." 
  417.  
  418. To print put the current text stream, press: 
  419.  
  420.      <F10> FP G 
  421.  
  422. This will start sending the text to the printer, and Black 
  423. Magic will display a message to that effect. 
  424.  
  425. Printing operations can be configured by accessing the 
  426. Printer Options %&Dialog Box.     
  427.  
  428.  w        /File Utilities ...    / 
  429.  
  430. In order to free you from having to exit to DOS every time 
  431. you wish to do some minor file manipulations, Black Magic 
  432. has the ability to: Delete, Copy, And Rename files. 
  433.  
  434. These file utility functions are located on the (logically 
  435. enough) on the Utilities Menu.  This is accessed by 
  436. pressing: 
  437.  
  438.      <F10> FU 
  439.  
  440. This brings up a bottom line menu from which you can choose 
  441. either: 
  442.  
  443.      Delete    Copy      Rename 
  444.  
  445. To do any of these actions, simply choose which option you 
  446. desire.  Then a dialog box will come up and prompt you for 
  447. the filenames that are involved.  After you enter the 
  448. filenames, Black Magic will perform the utilities function. 
  449.  
  450. Note - When deleting files, Black Magic will request 
  451. confirmation, to protect you from accidental deletion.     f    Running A Macro 
  452.  
  453. Macros are simply a series of prerecorded keystrokes that 
  454. can be played back upon request.  By recording commonly used 
  455. sets of keystrokes, many commonly used procedures can be 
  456. easily reduced to two keystrokes. 
  457.  
  458. Macros are stored on disk as a as a file with a name of the 
  459. form: 
  460.  
  461.      G.MAC 
  462.  
  463. Where the 'G' could have been any letter in the alphabet. 
  464.  
  465. To run a predefined a macro, simply press: 
  466.  
  467.      <F7> G <Enter> 
  468.  
  469. Note - the 'G' here could have been the filename of any of 
  470. the macros, not just G. 
  471.  
  472. After <Enter> is pressed, the macro will be executed.          Defining A Macro 
  473.  
  474. About Macros <----- Click Here to learn what a 'Macro' is 
  475.  
  476. To define a Macro, press: 
  477.  
  478.      <Shift> <F7> 
  479.  
  480. This puts the prompt: 
  481.  
  482.      Mac: 
  483.  
  484. On the Command Line.  Now you are required to enter a one 
  485. character alphabetical name for the macro.  (An example 
  486. would be 'G' or 'A' or any other alphabet character).  If 
  487. the macro name that you have specified already exists, then 
  488. Black Magic will alert you to this. 
  489.  
  490. Once a name is entered, Black Magic places the name next to 
  491. the 'Mac: ' prompt and displays the number 255 next to it. 
  492. This number represents the amount of keystrokes left in the 
  493. macro.  You start with 255 keystrokes available to you per 
  494. macro and it counts down as the macro is created. 
  495.                      Select To Continue     e    Macros Con't 
  496.  
  497. One you are done with your macro, simply press: 
  498.  
  499.      <Shift> <F7> 
  500.  
  501. Again to end the Macro, saving it to disk. 
  502.  
  503. Note - If you exceed the amount of keystrokes available to 
  504. the macro, Black Magic will end the macro for you, and save 
  505. it to disk. 
  506.  
  507. Note - At Present time there is no way to edit macros.     e        +File Operations    + 
  508.  
  509. Black Magic supports many file operations that are useful to 
  510. simply readers of hypertext documnts.  These are accessed by 
  511. pressing: 
  512.  
  513.      <F10> F 
  514.  
  515. This pulls up a menu of the available options.  From these 
  516. options, the ones that are of interest are the following: 
  517.  
  518.      Open - This command loads a file. 
  519.  
  520.      Files - This command calls up a listing of the 
  521.              available files on the current drive/directory. 
  522.              The filter can be changed by entering a new 
  523.              one. 
  524.  
  525.      ChangeDir - This command changes the current working 
  526.              directory to a new one. 
  527.  
  528.      Import/Export Text - When a block is marked, this ìcommand willexport the block to a DOS ìtext file.     a     OpenA File 
  529.  
  530. To load a file in Black Magic, press: 
  531.  
  532.      <F10> F O 
  533.  
  534. And enter the name of the file and then press <Enter>.  The 
  535. file will then be loaded.  Alternatively, you can press: 
  536.  
  537.      <Shift> <F9> 
  538.  
  539. To opena file. 
  540.  
  541. Note: The default filename extension for Black Magic files 
  542. is .MAG.  Any files that wish to load with this extension, 
  543. need not have it specified.  Any other files to load with 
  544. another extension must specify the extension.     n    !    0Exiting    0 
  545.  
  546. To leave Black Magic, press: 
  547.  
  548.      <Alt> <F10>
  549.  
  550. Alternatively, you may press: 
  551.  
  552.      <F10> FE 
  553.  
  554. Note - When you exit    !,BlackMagicwillaskyouifyouwant ìtoleavea    (bookmark    (inthefile.&'AboutBookmarks      "TSR Wait State 
  555.  
  556. Black Magic is an application that operates in what is 
  557. called ()"Graphics Mode". 
  558.  
  559. When you run a TSR program on top of a program operating 
  560. in graphics mode, you tend to get an entirely disrupted 
  561. screen when you return to your main application.  This is 
  562. because few TSRs will restore the screen when you exit 
  563. them.  To get around this, Black Magic was designed with a 
  564. "TSR Wait State". 
  565.  
  566. The TWS, is simply a mode that you put Black Magic into 
  567. before running a TSR.  It ensures that the screen is 
  568. properly updated upon return from the TSR. 
  569.  
  570. To activate the TSR wait state, press: 
  571.  
  572.      <Shift> <F10> 
  573.  
  574. Now the TSR can be run, with the need that you press <Esc> 
  575. when you return to Black Magic.    " u    #    %Exporting Text    % 
  576.  
  577. Black Magic can easily export text from any hypertext 
  578. document to an ASCII file.  This allows you to easily 
  579. excerpt parts of documents for your own reference. 
  580.  
  581. To export a section of a document, first mark it as a ì'block, and then press: 
  582.  
  583.      <F10> F IE 
  584.  
  585. Black Magic will then prompt you for the filename to export 
  586. it to.  After you have entered the filename and pressed 
  587. <Enter>.  The marked block will be written to the ascii 
  588. file and the block marking vanishes. 
  589.  
  590. Note - If you mark an area containing links, Black Magic 
  591. will simply export the text that was marked and not the link 
  592. markers.    # c    &About Dialog Boxes 
  593.  
  594. Dialog Boxes are a fairly standard way to solicit 
  595. information from the user.  A dialog box is simply a full or 
  596. half screen window from which choices can be made to 
  597. configure some aspect of Black Magic.  Examples of dialog 
  598. Boxes used in Black Magic include the Search Options Box, 
  599. The Configuration Screen Box, and The Printer Options Box. 
  600.  
  601. Dialog Boxes present various options for the user to alter. 
  602. The method that you employ to alter these options varies 
  603. depending on what you are altering.  For Example (What you 
  604. are altering is in italics) 
  605.  
  606.      Dialog Box Option        Method To Alter 
  607.      Line Spacing: 2          Enter a new Number 
  608.      Page Numbering: No       Press "Y' or "N" 
  609.      Header: On               Press <RightArrow> or 
  610.                                    <LeftArrow> 
  611.      Driver: HP Laserjet II   Press <RightArrow> or 
  612.                                    <LeftArrow> 
  613.  
  614. Not - the <UpArrow> and <DownArrow> keys are used to scroll 
  615. through a dialog box.    & uSBookmarksaresimply ìpointertoyourcurrentlocationinafile.Ifyou answerìYestotheBookmarkQuery,BlackMagicwillcreateafileìnamed: 
  616.  
  617. FILENAME.BKM 
  618.  
  619. Where'FILENAME'isthenameofthefilethatyouexitedìfrom.Upon reloadingthisfile,BlackMagicwillìautomaticallyjumpyoutothelinkyou wereinwhenyouìexited.  r"Graphics Mode".  This means that every screen in 
  620. Black Magic is actually a graphics picture as opposed to a 
  621. screen of text characters shoriginal state.By original I mean how it was ìwhenthe file was loaded withouta"(bookmark. h    @New Features - V1.3 
  622.  
  623. Black Magic version 1.3 has several new features including: 
  624. DOS Links, Global Searching, and a revised Menuing 
  625. system. 
  626.  
  627.  
  628.  
  629.                          GBDOS Links 
  630.  
  631.                      JEGlobal Searching 
  632.  
  633.                    Revised Menuing System 
  634.   TheConfigScreenisaccessedbypressing<Alt> ìCor<F10>UC.Afullscreenmenuthencomesup ìfromwhichvariouschangescanbemadetothe ìmannerinwhichBlackMagicoperates.  TrademarkOfLotusDevelopment ìCorporation. c    3    4    9    DAbout Dialog Boxes    4    9 
  635.  
  636. Dialog Boxes are a fairly standard way to solicit 
  637. information from the user.  A dialog box is simply a full or 
  638. half screen window from which choices can be made to 
  639. configure some aspect of Black Magic.  Examples of dialog 
  640. Boxes used in Black Magic include the Search Options Box, 
  641. The Configuration Screen Box, and The Printer Options Box. 
  642.  
  643. Dialog Boxes present various options for the user to alter. 
  644. The method that you employ to alter these options varies 
  645. depending on what you are altering.  For Example (What you 
  646. are altering is in italics) 
  647.  
  648.      Dialog Box Option        Method To Alter 
  649.      Line Spacing: 2          Enter a new Number 
  650.      Page Numbering: No       Press "Y' or "N" 
  651.      Header: On               Press <RightArrow> or 
  652.                                    <LeftArrow> 
  653.      Driver: HP Laserjet II   Press <RightArrow> or 
  654.                                    <LeftArrow> 
  655.  
  656. Not - the <UpArrow> and <DownArrow> keys are used to scroll 
  657. through a dialog box.    3 tt    :Markers are a tool designed to make writing and editing of a 
  658. document easier, but they do have their 23limitations. 
  659.  
  660. The typical use for markers is to get somewhere in the 
  661. document FAST. They let you jump to the different nodes in a 
  662. docuement easily because you don't have to find the link 
  663. originators for those nodes. 
  664.  
  665.  
  666.  
  667.         : 
  668.  limitations. 
  669.  
  670. Their first limitation is that any marker is line specific, ìnot position specific. What this means is that any marker ìwhen activated will bring you to the line that it was set ìon, but not to the specific position. The other limitation ìthat markers have is that they are not saved to disk with ìthefile. They are strictly temporary pointer to a location. ìA logical consequence of this is that when the line with a 
  671. marker is deleted, so is that marker.  Markers      ;Hypertext 
  672.  
  673. Hypertext is a new way to manage information, it blends text ìand graphics together with an interactive reading process to ìcreate a new learning experience, a hypertext experience. 
  674.  
  675.      78Origin 
  676.  
  677.      Description 
  678.  
  679. Hypertext is essentially interactive reading of 3 D 
  680. documents. Reading a book is a one dimensional linear 
  681. process, you start at the beginning, and (generally) you go 
  682. straight through to the end. It is a one dimensional 
  683. process, the path of reading being a straight line through 
  684. to the end. 
  685.  
  686. Hypertext is not like that. In a hypertext document any 
  687. block of text or graphics can be associated (linked) with 
  688. any other block. Once two blocks are linked, they provide a 
  689. instant gateway to each other.9:Linking 
  690.                      ;<SelectToContinue 
  691.  
  692.  
  693.  
  694.  ntHypertext was first conceived by Vanevar Bush, ìPresident Roosevelt's Science Advisor,in1945.Histermìforit was a Memex.  And as he envisioned it, it wouldaidìaresearcher in pulling together diverse information from a ìvariety of source.  Not knowing of digital computers, he ìpictured it asbeing run by photocells and microfilm. 
  695.  
  696. The actual term 'hypertext' was coined in the mid sixties by ìa technical visionarynamedTedNelson.Ashesawit,itìwould consist of seamlessly bindingallofman'sknowledgeìinto one linked framework where everything is linkedtoìeverything else. 
  697.  
  698. While many people have been skeptical about the possibility ìof Ted Nelson's XanaduProjectsucceeding,recentìdevelopments indicate that it may actually happen.Andìhopefully it will. 
  699.   bThis "linking" of blocks ìallows documents to be built with many levels. For example,ìadocument could be written with levels that accommodated ìboth beginnersandexperts. 
  700.      <HypertextCon't
  701.  
  702. The levels to hypertext form both the interactive nature 
  703. of hypertext and the 3 dimensional aspect of hypertext. 
  704.  
  705. Hypertext is interactive because the choice of activating 
  706. the link between two blocks or levels is up to the user. 
  707. This means that a hypertext document is not necessarily the 
  708. same each time it is read. Different readers can (by 
  709. activating different links) arrive at the same point in a 
  710. document and have learned different things. 
  711.  
  712. Hypertext is 3 dimensional because  it allows you to work in 
  713. more than one dimension by linking blocks to other blocks to 
  714. form different levels to a document. 
  715.     ;    < 
  716.     =How To Order                                 E>Order Blank 
  717.  
  718. BlackMagichasnowbeenreleasedasaSharewareproduct.ìSharewareiswhatiscalledameansof'Alternative ìDistribution'.Essentiallyitisawayoflettingyoutry ìandusethesoftwarecomprehensively.Thenifyoulikethe ìsoftwareandwishtocontinueusingit-thenyoupayfor ìitORyouvoluntarilyeraseitfromyourharddiskor ìfloppies.
  719.  
  720. BlackMagicmaybeobtainedinseveralwaysincluding: 
  721.  
  722. =>1.DownloadingIt. 
  723. ?@2.Purchaseacopyfromasharewaredistribution 
  724.      house. 
  725. AB3.Orderitfromus. 
  726. 4.Getitfromafriend. 
  727.  
  728. CDOrders 
  729.  
  730.  s 1.DownloadingIt. 
  731.  
  732. Thisisobviouslyfreeornearfree.BlackMagichasbeenìuploadedtomost ofthemajorNetworksincludingìCompuserve,Bix,andOthers.Thefilesthat wehaveìuploadedinclude: 
  733.  
  734.  MAGIC.ARC       BlackMagicSharewareprogram 
  735. MAGIC.BAT       Neededtoproperlyun-arcMAGIC.ARC 
  736. MAGUTIL.ARC     Utilities(Grabit.COM,Hypertext Manual) ìMAGUTIL.BAT     Neededtoproperlyun-arcMAGUTIL.ARC 
  737. MAGREAD.ARC     BlackMagicPublicDomainReader 
  738. MAGREAD.BAT     Neededtoproperlyun-arcMAGREAD.ARC 
  739. MAGDEMO.ARC     DemoHypertextfiles 
  740. MAGDEMO.BAT     Neededtoproperlyun-arcMAGDEMO.ARC 
  741.  
  742. Onethingtonote,isthatthesearebigfiles,andtoìdownloadthemforma commercialnetworksuchascompuserveìwouldprobablycostasmuchastobuy ourevaluationkit. AA2.Purchaseacopyfromasharewaredistribution 
  743.      house. 
  744.  
  745. SharewaredistributionfirmsaresimplycompaniesthatìacquireShareware softwareandthenredistributeit.BlackìMagichasbeensenttoanumberof thesecompaniesìincluding:PC-SigandPublicBrandSoftware.
  746.  
  747. NOTE-Bypurchasingacopyofanysharewareprogramfrmaìdistribution house,youarenotpayingtheregistrationfeeìonit.Youaresimplybuying aevaluationcopythatshouldìbelaterregisteredwiththeauthor. Na3.Orderitfromus. 
  748.  
  749. BlackMagicmaybeorderedfromusinoneofseveralways:
  750.  
  751. 1.OrderanEvaluationCopy-$15.95
  752. Justthedisks andamanualondisk.Doesn't
  753. includeTechnical supportbeyondsetupandìinstallation. 
  754. 2.Registeryourcopy-NoDocumentation-$39.95 
  755.      Includestechnicalsupportandfutureupdates. 
  756.  
  757. 3.RegisteryourcopywithDocumentation-$79.95 
  758.      IncludesTechnicalSupport,PrintedManual,ìKeyboard Templates,andQuickReferenceCard.ìAlsofuture updates. 
  759.  
  760. Noteallofthecostsofpurchasinganevaluationcopyorìregisteringyour copywithout documentationcanbeappliedìtothecostof eitheracopywithoutdocumentationoraìcopywithdocumentation. 
  761. cFororders,ourAddress is: 
  762.  
  763.                NTERGAID 
  764.                2490BlackRockTpke. 
  765.          Suite337 
  766. Fairfield,CT06840 
  767.                (203) - 368 - 0632 
  768.  
  769. Alternatively, you may call us and place your order via the 
  770. phone.  We accept Mastercard, Visa, and American Express. 
  771.  
  772. If you need an order blank, click above on "Order Blank" and 
  773. print it out.    = b    >Make Check               NTERGAID            Order Form 
  774. Payable To:     2490BlackRockTpkSuite337 
  775.                      Fairfield, CT 06840 
  776.  
  777. ============================================================ 
  778. Date:                              PO #: 
  779. ============================================================ 
  780. Quan.     Description              Unit             Extended 
  781. ------------------------------------------------------------ 
  782.      |                            |         | 
  783.      |   NTERGAID Demo Disk       | $7.00   |    $ 
  784. -----|----------------------------|---------|--------------- 
  785.      |                            |         | 
  786.      |   Black Magic Evaluation | $15.95|    $ 
  787. -----|----------------------------|---------|--------------- 
  788. |                            |     | 
  789. |BlackMagicRegistered|$39.95|$ 
  790. |NoDocumentation|| 
  791. ------------------------------------------------------------ 
  792. |                         |     | 
  793. |BlackMagicRegistered|$79.95|    $ 
  794. |    WithDocumentation|| 
  795. ------------------------------------------------------------ 
  796.  
  797.                                       Subtotal:  $ 
  798. (CT Residents add 7.5 % sales Tax)    Tax:       $ 
  799. (Only For Purchasers Of Black Magic)  Shipping:  $ 
  800.  
  801.                                       Total:     $ 
  802.  
  803. Payment By     (  ) Check         Shipping:$15-OutsideUS 
  804.                (  ) Money Order                  Except
  805.                (  ) Visa/Mastercard        Canada&
  806.                (  ) American Express             Mexico 
  807.  
  808. Name: 
  809.            ------------------------------------------------ 
  810. Address: 
  811.            ------------------------------------------------ 
  812. Address: 
  813.            ------------------------------------------------ 
  814. City: 
  815.            ------------------------------------------------ 
  816. State: 
  817.            ------------------------------------------------ 
  818. Zip: 
  819.            ------------------------------------------------ 
  820. Country: 
  821.            ------------------------------------------------ 
  822. Card #: 
  823.            ------------------------------------------------ 
  824. Exp. Date: 
  825.            ------------------------------------------------ 
  826. Name On Card: 
  827.               --------------------------------------------- 
  828.  
  829. International Orders: Please send either a check drawn on a 
  830.                       U.S. Bank in U.S. funds or an 
  831.                       international money order in U.S. 
  832.                       Dollars. 
  833.  
  834. Copyright (C) 1988 NTERGAID    > -ThisisanexampleofWhatiscalled"Collateral ìDisplay."Itisanearlytypeofhypertext ìsystems.Thebasicideaistoshowbothyour ìworkandyournotesatthesametimeandthe ìrelationshipsbetweenthem. -    A    BDOS Links 
  835.  
  836. DOS Links provide a way to integrate a the power of 
  837. hypertext into existing DOS applications.  The DOS Link 
  838. when activated, unloads Black Magic from memory, and runs a 
  839. user created batch file.  This batch file can contain 
  840. directions to run any program or sequence of programs. Then 
  841. when the batch file terminates, Black Magic is then reloaded 
  842. with the same document file that you were reading at exactly 
  843. the same place that you left.  This maintence of context is 
  844. very important as it allows people to freely leave and 
  845. enter hypertext without having to worry about what file to 
  846. load or other details. 
  847.  
  848. HActivate the link below to see a demonstration of a DOS 
  849. link that exits to DOS, displays a directory, and then 
  850. waits for the user to press a Key before returning to Black 
  851. Magic. 
  852.  
  853.  
  854.                         IDOS Link DEMO 
  855. Comment: 
  856. The above demo will only work properly if your copy of 
  857. Black Magic is loaded into a directory \MAGIC. 
  858.   NOTE: 
  859.  
  860. IF you are using Magic to read this, you will 
  861. have to press <F1> twice to activate the link. 
  862. The first time simply brings up the window with 
  863. the Batch file and the second time activates the 
  864. link.  In MAGREAD.EXE, Black Magic's Reader 
  865. program, the user doesn't ever see this window 
  866. as the link simply executes w/o displaying it. 
  867.  
  868.  
  869.  wcd\ 
  870. dir 
  871. PAUSE Now after any key is pressed, you will be returned to Black Magic. 
  872. cd\magic 
  873. magic /restart 
  874.  r    C    EGlobal Vs. Local Searching 
  875.  
  876. Now as of Version 1.3 of Black Magic, searches can be 
  877. conducted across an entire document instead just the node 
  878. that you are currently in. 
  879.  
  880. To control this option, call up the search configuration 
  881. /Ddialog box by pressing <Control> <O> and toggle the 
  882. Search All Links option to On or Off using the right and 
  883. left arrow keys. 
  884.  wCallsuptheMenu. iActivatestheSearchOption. iFindsapieceoftext. i