home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / editors / hypsh40c.arj / HYPDOC.LZH / QREF.MAN < prev    next >
Text File  |  1991-04-24  |  52KB  |  1,165 lines
  1.             HyperShell Hypertext control system Version 4.0
  2.                       Quick Reference Guide
  3.              Copyright (c) 1989,1990,1991 Text Technology
  4.      ───────────────────────────────────────────────────────────────────────
  5.  
  6.         CONTENTS                                    Page
  7.  
  8.      1.  Hyperfile Structure                           2
  9.      2.  HyperShell Directives                         2
  10.      3.  Print Directives                              2
  11.      4.  Check directives                              2
  12.      5.  References                                    3
  13.      6.  Formatting flags                              3
  14.      7.  System variables                              4
  15.      8.  Pseudo variables                              4
  16.      9.  Application variables                         4
  17.      10. Limits                                        4
  18.      11. Actions                                       5
  19.      12. Extended action codes                         6
  20.      13. Parameters on actions                         6
  21.      14. Key specifications                            6
  22.      15. Action modifiers                              7
  23.      16. Dynamic menus                                 7
  24.      17. Contents lists                                7
  25.      18. Iterators                                     7
  26.      19. Function codes                                8
  27.      20. Expression operators                          8
  28.      21. Conversion string commands                    9
  29.      22. Pattern Match operators                       9
  30.      23. Conditions                                    9
  31.      24. Reserved characters in Actions               10
  32.      25. Options                                      10
  33.      26. Extended options                             11
  34.      27. Colour schemes                               11
  35.      28. Colour codes                                 12
  36.      29. Configuration strings                        12
  37.      30. Control menu                                 12
  38.      31. Error codes                                  13
  39.      32. Edit actions                                 14
  40.      33. Extra dynamic menus                          15
  41.      34. Flags in lists                               15
  42.      35. Extra Functions                              15
  43.      36. Environment options                          15
  44.      37. Edit mode primitive function codes           16
  45.      38. Graphics characters for Symbol shift         17
  46.      39. Default Key Mappings                         18
  47.      40. Control Keys                                 18
  48.      41. Function Keys                                18
  49.      42. hs {options} hyperfile {frame}               19
  50.      43. hi {options} hyperfile {frame}               19
  51.      44. hc {options} hyperfile                       19
  52.      45. hp {options} hyperfile {frame name}          20
  53.      46. hcx {-c/-r/-s){-x/-p/-o/-n}{-t} file         20
  54.      47. tagbload filename.ext {mode}                 20
  55.      48. HyperShell subset popup                      21 
  56.      49. Floating point extension hrxfp               21
  57.      50. HyperShell File Extensions                   21
  58.  
  59.         HyperShell Version 4.0 - Quick Reference Guide           Page 2
  60.  
  61.      1. Hyperfile Structure
  62.  
  63.        ┌───┐  ┌───┐  ┌───────────────┐  ┌─────────────────────────────┐
  64.        │ H │  │ G │  │ CONTROL ITEMS │  │ INDEX, HEADER, FOOTER, ETC. │
  65.        │   │  │ L │  └───────────────┘  └─────────────────────────────┘
  66.        │ Y │  │ O │  ┌───────────────┐  ┌─────────────────────────────┐
  67.        │   │  │ B │  │ G E N E R A L │  │ N O T E S                   │
  68.        │ P │  │ A │  │               │  │ M E N U S                   │
  69.        │   │  │ L │  │  I T E M S    │  │ S C R I P T S               │
  70.        │ E │  │ S │  │               │  │ R E M A R K S               │
  71.        │   │  │   │  │               │  │ PRINT AND CHECK             │
  72.        │ R │  └───┘  └───────────────┘  └─────────────────────────────┘
  73.        │   │  ┌───┐  ┌───────────────┐  ─────  ┌──────────────────────┐
  74.        │ F │  │ F │  │ F R A M E     │         │ FRAME, TITLE, TEXT   │
  75.        │   │  │ R │  │  S P E C      │         └──────────────────────┘
  76.        │ I │  │ A │  └───────────────┘  ──┐    ┌──────────────────────┐
  77.        │   │  │ M │  ┌───────────────┐    │    │ L O C A L  I T E M S │
  78.        │ L │  │ E │  │ F R A M E     │    │    │ N O T E S            │
  79.        │   │  │ S │  │  S P E C      │    │    │ M E N U S            │
  80.        │ E │  │   │  └───────────────┘    │    │ S C R I P T S        │
  81.        └───┘  └───┘     - etc -           └──  └──────────────────────┘
  82.  
  83.      2. HyperShell Directives
  84.  
  85.      .REMARK                           Remark section
  86.      .PRINT directives                 HP control
  87.      .CHECK settings                   HC control
  88.      .NOTE name                        Global/Local Note
  89.      .MENU name                        Global/Local Menu
  90.      .SCRIPT name                      Global/Local Script
  91.      .HEADER                           Screen header
  92.      .FOOTER                           Screen footer
  93.      .INDEX                            Create .HIX file
  94.      .SHARE                            Shared globals
  95.      .FRAME name                       Frame name
  96.      .TITLE title text                 Frame title
  97.      .END                              End of frame spec.
  98.  
  99.      3. Print Directives
  100.  
  101.      .PRINT TITLE                      Next line is title
  102.      .PRINT OFF                        Disable print
  103.      .PRINT ON                         Enable print
  104.      .PRINT PAGE                       Page break
  105.      .PRINT THIS                       Following text is printed
  106.      .PRINT SECTION prefix             Prefix for numbering
  107.      .PRINT MARGIN nn                  set frame margin (for ~i flag)
  108.      .PRINT WPOFF                      Disable -w flag
  109.      .PRINT WPON                       Enable -w flag
  110.  
  111.      4. Check directives
  112.  
  113.      .CHECK +a - check actions in menus with actions
  114.      .CHECK +f - check frame refs for menus without actions
  115.      .CHECK +p - suppress frame length check
  116.      .CHECK +u - suppress errors for unresolved references
  117.      .CHECK +x - suppress menu length check
  118.  
  119.         HyperShell Version 4.0 - Quick Reference Guide           Page 3
  120.  
  121.      5. References
  122.  
  123.       ~?ref text{~Paction}{~Kk}~E - reference(type(name){,action{,key}})
  124.            Where ? is :-
  125.  
  126.      ~F    Frame reference                frameref(name{,action}{,k})
  127.      ~f    Frame step
  128.      ~N    Global note                    noteref(name{,action}{,k})
  129.      ~n    Local note
  130.      ~t    File note
  131.      ~M    Global menu                    menuref(name{,action}{,k})
  132.      ~m    Local menu
  133.      ~S    Global script                  scriptref(name{,action}{,k})
  134.      ~s    Local script
  135.      ~A    Action                         actionref(ref{,action}{,k})
  136.      ~I    Input field                    inputfield(field,pattern{,k})
  137.  
  138.      6. Formatting flags
  139.  
  140.      ~Lnn   Line (1-22)                              linepos(number)
  141.      ~Ynn   Line (1-22) (forced)                     ypos(number)
  142.      ~Cnn   Column (1-78)                            column(number)
  143.      ~Xnn   Column (1-78) (forced)                   xpos(number)
  144.      ~Wnn   Field width (1-72)                       width(number)
  145.      ~in    Set indent at 'n' spaces (default 0)     indent(by)
  146.      ~G     Screen break
  147.      ~g     Line break
  148.      ~p     Do not PRINT rest of this line
  149.      ~c     Concatenate with next line (stops line break)
  150.      ~Tc    Text colour                               foreground(colour)
  151.      ~Bc    Background colour                         background(colour)
  152.      ~Vi    Video intensity
  153.      ~Ds    Colour Scheme (A-Z)                       scheme(letter)
  154.      ~wn    Wait n seconds before continuing          wait(seconds)
  155.      ~d     Toggle slow (teletype) display
  156.      ~On    Option setting (0-9,other chars,#)
  157.      ~Q     Immediate reference (after reference)
  158.      ~H     Hidden line
  159.      ~hc    Line/text shown if condition true           showif(c)
  160.      ~jc    Line/text hidden if condition true          hideif(c)
  161.      ~Jn    Set local flag                              setlocal(flag)
  162.      ~Z     End of region
  163.      ~a     Mark top left of area
  164.      ~bn    Set bottom right position, draw area per n  box(type)
  165.             0 - Just return to position set by ~a       _return
  166.             1 - Draw box from ~a position               _double
  167.             2 - Define text window and clear it         _window
  168.             3 - Draw box with window inside and clear   _windowbox
  169.             Above values +4 - reset text window to full screen
  170.  
  171.         HyperShell Version 4.0 - Quick Reference Guide           Page 4
  172.  
  173.      7. System variables
  174.  
  175.      $0    HyperShell program pathname                  _progpath
  176.      $1    Current frame name                           _frame
  177.      $2    Current frame title                          _title
  178.      $3    Current file name                            _hyperfile
  179.      $4    Current date                                 _date
  180.      $5    Current time                                 _time
  181.      $6    Backtrack list depth                         _depth
  182.      $7    Current directory                            _curdir
  183.      $8    Original directory                           _original
  184.      $9    HyperShell name and version                  _hypershell
  185.      $?    Error number of last error                   _errnum
  186.      $@    Remaining memory                             _memory
  187.      $_    File prompt                                  _fprompt
  188.      $^    Program exit code                            _exitstatus
  189.      $:    Exclusion list of file extns                 _exclusions
  190.      $<    Filename from directory display              _filename
  191.      $>    File extension from directory                _filetype
  192.      $`    Error status change action                   _erroraction
  193.      $\    Parameter to Script or Note                  _parameter
  194.      $~    Pattern match translation string             _pattrans
  195.  
  196.      8. Pseudo variables
  197.  
  198.      $,        represents ';' character                 _semi
  199.      $!        represents '|' character                 _bar
  200.  
  201.      9. Application variables
  202.  
  203.      $A to $Z   application variables
  204.      $a to $z   application variables
  205.      $(xxxxxx)  named application variable
  206.  
  207.      10. Limits
  208.  
  209.      Reference text                  - 40 chars
  210.      Reference action                - 40 chars
  211.      References in frame (+ note)    - 100
  212.      Note text                       - 76 chars by 22 lines
  213.      Frame text                      - 80 chars
  214.      Menu choices                    - 20 per page
  215.      Script lines                    - 80 chars by 200
  216.      (expanded) action string        - 120 chars
  217.      multiple action string          - 120 chars
  218.  
  219.         HyperShell Version 4.0 - Quick Reference Guide           Page 5
  220.  
  221.      11. Actions
  222.  
  223.      Aaction    do action 'action'                 action(action)
  224.      acaction   do 'action' on condition 'c'       ifcond(c,action)
  225.      B          backtrack one frame                backtrack()
  226.      bn         backtrack to depth n               backto(depth)
  227.      Cd:d       Change drive/directory             changeto({d:}dir)
  228.      cfile      interpret file as script           call(scriptfile)
  229.      Dcommand   Dos shell command                  dodos(command,wait)
  230.      dcommand   Dos shell command (no wait)        dodos(command{,quiet})
  231.      Ecommand   Execute command (no return)        execute(command,over)
  232.      evsabc..   Split v on s to a,b,c etc.         expand(v,s,abc...)
  233.      Fname      Go to frame                        frame(name)
  234.      fname      Go to frame (no backtrack)         framestep(name)
  235.      Gfile      Display graphic file               graphic(file)
  236.      gfile      Display graphic and stay in mode   graphic(file,hold)
  237.      Href       Add note to notepad                addref(ref)
  238.      href       Remove note from notepad           delref(ref)
  239.      I{#}       Select next{current} input field   nextinput({this})
  240.      itext      Insert text at text cursor         insert(text)
  241.      Jlabel     Unconditional jump                 goto(label)
  242.      jclabel    Conditional jump                   goto(c,label)
  243.      Kkkact     Map key kk to action               mapkey(key,action)
  244.      kkkaction  Do action mapped to key            dokey(key)
  245.      Llabel     Label name - in script.            label(name)
  246.      lvnamed    Load named var from var v          loadvar(v,name)
  247.      Mname      Global menu                        menu(name)
  248.      mname      local menu                         localmenu(name)
  249.      Nname      Global note                        note(name)
  250.      nname      local note                         localnote(name)
  251.      Oos        Set option / colour                setopt(opt,val)
  252.      ostring    Output to printer etc.             output(string)
  253.      Pstring    Popup message                      popmessage(string)
  254.      pstring    Display message on bottom line     display(string)
  255.      Qss        Quit to DOS                        quit(status)
  256.      q          Quit script                        quitscript()
  257.      Rsabc..    Read file (formatted)              read(s,abc...)
  258.      rfilenm    Open file for reading (close)      openin(file), closein()
  259.      Sname      Global script                      script(name)
  260.      sname      local script                       localscript(name)
  261.      Tfilenm    Type file                          typefile(file{,string})
  262.      tfilenm    Display file as popup note         filenote(filename)
  263.      Vxvalue    Set variable x to value            setvar(v,value)
  264.      vxvalue    Test variable x                    testvar(v,value)
  265.      Wstring    Write string to file               write(string)
  266.      wfilenm    Open file for writing (close)      openout(file), closeout()
  267.      Xcomm      Execute command                    execute(command,wait)
  268.      xcomm      Execute command (no wait)          execute(command)
  269.      Y          Reset error status to 0            reseterr(value)
  270.      y{+/#/-}   Display next,current,prev screen   refresh(ind)
  271.      Zxa        Extended action code  (see below)
  272.      zcaction   Do 'action' if 'c' false           ifnot(c,action)
  273.  
  274.         HyperShell Version 4.0 - Quick Reference Guide           Page 6
  275.  
  276.      12. Extended action codes
  277.      ZAkey:action - Specified autoref                autoref(key,action)
  278.      ZB           - Beep (sound bell)                beep(param)
  279.      Zbn          - 0=Bright,1=Blink Background      blinkback(status)
  280.      ZE           - Exit subroutine                  return()
  281.      ZC           - Display control menu             control()
  282.      ZFn          - Reserve footer lines             reserve(lines)
  283.      ZG           - Refresh &X,&Y coords             getxy()
  284.      Zg           - Get graphics mouse selection     getseln()
  285.      ZH           - Hold start position of loop      holdline()
  286.      ZIexpr       - If expr TRUE (+ve), do multiact  if(expr)
  287.      ZJlabel      - Jump to Subroutine               gosub(label)
  288.      ZLn{s}       - Toggle frame local flag          toggle(flag,noref)
  289.      Zlc{i}       - Set local flag for contents ind. localind(flag,ind)
  290.      ZMn          - Set text mode (n = 3,7 or 64)    textmode(mode)
  291.      ZPfile       - Preload hyperfile                preload(hyperfile)
  292.      ZR           - Recall saved screen              recall()
  293.      Zr           - Reset text window to full screen resetwindow()
  294.      ZSev=string  - Set environment variable         setenv(var,value)
  295.      ZT           - Take copy of whole screen        takecopy()
  296.      Zt           - Show copied screen               showcopy()
  297.      ZUc          - Load character as input          unget(c)
  298.      ZVname=value - Assign named variable            assign(name,value)
  299.      ZXnn         - Set mouse cursor column          setmousex(xpos)
  300.      ZYnn         - Set mouse cursor line            setmousey(ypos)
  301.  
  302.      13. Parameters on actions
  303.        -- on Frame actions F and f --
  304.      Fname          Named frame (normal frame selection)
  305.      F              Home frame (first in file)
  306.      F+             Next frame (wrap at end)
  307.      F+1            Next matching frame
  308.      F+2            Next unmatched frame
  309.      F+name         Next named (duplicates)
  310.      F-             Previous frame (wrap at start)
  311.        -- on M,m,F --
  312.      Mmenu name(option number)         Specified option
  313.      Mmenu name[lookup key / pattern]  Lookup value
  314.      Mmenu name[@]                     Graphics selection zone action
  315.        -- on N,n,t,S,s,c --
  316.      Nnote name(parameters)            Set variable $\
  317.      Sscript name(parameters)          Set variable $\
  318.        -- on T --
  319.      Tfilename/string       Type file, searching for string
  320.                             If string starts '^' it is a pattern
  321.      Tfilename#nn           Type file, starting at page nn
  322.      Tfilename#nn/string    Type file at page nn and highlight string
  323.  
  324.      14. Key specifications
  325.  
  326.      (kk = F1-F0,S1-S0,A1-A0,C1-C0,#x)
  327.  
  328.         HyperShell Version 4.0 - Quick Reference Guide           Page 7
  329.  
  330.      15. Action modifiers
  331.  
  332.      ?prompt       Prompt for value               prompt(prompt)
  333.      ?prompt/deflt Prompt giving value to edit    prompt(prompt,default)
  334.      %envvar       Use value of env. var          getenv(variable)
  335.      &funcspec     Use function return
  336.      @menuspec     Use menu return                from(menuspec)
  337.      !readspec     Iterators (read file etc)
  338.      =expr         Integer/boolean expression
  339.  
  340.      16. Dynamic menus
  341.  
  342.      @B           Backtrack list for unwind       unwind()
  343.      @b           Backtrack list for revisit      revisit()
  344.      @C{n}{key}   Current contents list           contents(n,key)
  345.      @Dwildspec   Directory list (no extn)        popdir(wild,noext)
  346.      @dwildspec   Directory list (with extn)      popdir(wild)
  347.      @Ewildspec   Directory (directories)         popdirs(wild)
  348.      @Ffilename   Contents of file as menu        filemenu(filename)
  349.      @Gfilename   Formatted file list             datalist(filename)
  350.      @Lwildspec   Extended directory display      directory(wildcard)
  351.      @lwildspec   Extended dir with actions       diraction(wildcard)
  352.      @M/mname     Global/local menu               from(menu(name)) etc.
  353.      @N/n/tname   Global/local/file note          from(note(name)) etc.
  354.      @R           Notepad paged display           notepad()
  355.      @Sstring     Search titles of current file   search(title,string)
  356.      @sstring     Search titles of open files     search(alltitle,string)
  357.      @Xstring     Search titles/texts current     search(text,string)
  358.      @xstring     Search titles/texts open fls    search(alltext,string)
  359.  
  360.      17. Contents lists
  361.  
  362.      @C{0}{key}    Full list {starting with key}    full(key)
  363.      @C1{key}      Matching frames { " }            matched(key)
  364.      @C2{key}      Unmatched frames { " }           unmatched(key)
  365.      @C3key        Start list at frame "            startat(key)
  366.      @C4key        Titles starting with key         titlekey(key)
  367.      @C5key        Start at title starting key      starttitle(key)
  368.  
  369.      18. Iterators
  370.  
  371.      !{key}        Read next {matching} record     readrec(key)
  372.      !F{key}       Read next {matching} record     readnext(key)
  373.      !L{key}       Read first {matching} record    lookuprec(key)
  374.      !Bkey         Fast lookup (sorted text files) fastlookup(key)
  375.      !R{key}       Next {matching} reference       nextref(key)
  376.      !C            Associated comment              comment(key)
  377.      !Dwildcard    First matching filename         firstfile(wildcard)
  378.      !D            Next matching filename          nextfile()
  379.  
  380.         HyperShell Version 4.0 - Quick Reference Guide           Page 8
  381.  
  382.      19. Function codes
  383.  
  384.      &Ac     - ASCII value of 1st char              asc(c)
  385.      &Bp     - Scale value to p decimal places      scale(p,value)
  386.      &Cn     - Character of ASCII value nn          chr(nn)
  387.      &D      - Display (0-CGA,1-MDA,2-EGA,3-VGA)    adaptor()
  388.      &Ekk    - Extended key mapping                 mapping(kk)
  389.      &Fcss   - String from character c onwards      fromchar(c,ss)
  390.      &Gtt    - Get key with timeout                 keytimed(timeout)
  391.      &H      - Time of day as hundredths            timehun()
  392.      &Icss   - Position of char c in string ss      instr(c,ss)
  393.      &J      - Time difference (hundredths)         timediff()
  394.      &Kss    - Key pressed from popup prompt        getkey(message)
  395.      &Lss    - Length of string ss                  length(ss)
  396.      &Mk     - String mapped to key k               mapone(k)
  397.      &Nnss   - nth character in string ss           nthchar(n,ss)
  398.      &OX     - Application flag value (X=A-Z)       flagval(flag)
  399.      &P      - Pick word at mouse cursor            pickword()
  400.      &Q      - Pick reference action at mouse       pickref()
  401.      &Rnn    - Run option value (nn = 0 to 21)      optval(nn)
  402.      &Snss   - Substring of ss starting nth         frompos(n,ss)
  403.      &Tss    - Title of frame with name ss          title(frame)
  404.      &Ucss   - String up to character c             upto(c,ss)
  405.      &Vnn    - Configuration string nn              configval(nn)
  406.      &Wss    - Whole string (guard)                 whole(ss)
  407.      &X      - X (column) from graphic seln         selcol()
  408.      &Y      - Y (line) from graphic seln           selline()
  409.      &Z      - Key pressed from graphic seln        selkey()
  410.      &i{def} - input string at text cursor position textin(default)
  411.      &vv     - Variable address as far pointer      varptr(v)
  412.      &cparam - HyperShell Resident Extension        hrx(param)
  413.      &t      - Name of last(current) typed file     typedfile()
  414.      &pn     - Last typed file parameters           typedparam(n)
  415.      &#vstr  - Convert variable 'v' using string    convert(v,string)
  416.      &l      - [IDE] Size of current hyperfile      filesize()
  417.      &f{d}   - [IDE] Free space on cur{named} drive diskfree(d)
  418.  
  419.      20. Expression operators
  420.  
  421.      +,-,*,/,%                - arithmetic operators
  422.      expr?true exp:false exp  - triadic operation
  423.      expr!expr                - arithmetic or
  424.      expr&expr                - arithmetic and
  425.      expr^expr                - exclusive or
  426.      @expr                    - 1's complement
  427.  
  428.      -- Boolean expression operators - 1 if TRUE, 0 if FALSE ---
  429.  
  430.      expra>exprb              - a greater than b
  431.      expra<exprb              - a less than b
  432.      expra=exprb              - a equal to b
  433.      ~expr                    - not expr (0->1,1->0)
  434.      #c                       - Truth of condition code 'c'
  435.      "vxxxx"c                 - combined variable comparison and test
  436.  
  437.         HyperShell Version 4.0 - Quick Reference Guide           Page 9
  438.  
  439.      21. Conversion string commands
  440.  
  441.      l      - convert to lowercase
  442.      u      - convert to uppercase
  443.      s      - strip superfluous spaces
  444.      tv     - translate according to variable v
  445.      rv     - remove characters in variable v
  446.      ic     - (before command) conditional on 'c'
  447.  
  448.      22. Pattern Match operators
  449.  
  450.      <             at start - match start of string
  451.      >             at end - match end of string
  452.      ?             match any character
  453.      _             match one or more space or TAB characters
  454.      (alt1/alt2)   match alt1 or alt2 (if only one, it is optional)
  455.      [abc]         match 'a', 'b' or 'c'
  456.      [^abc]        match any character but 'a','b' or 'c'
  457.      [x-y]         match any char in range x to y (eg. [a-zA-Z] match letter)
  458.      {             start of word
  459.      }             end of word
  460.      x#            zero or more of the character or subexpression x
  461.      x+            one or more of the character or subexpression x
  462.      *             any string (equivalent to ?#)
  463.      \x            character 'x' (allows metachars to be used literally)
  464.  
  465.      23. Conditions
  466.  
  467.      e    equal                                _equal
  468.      n    not equal                            _notequal
  469.      g    greater than                         _greater
  470.      l    less than                            _less
  471.      d    defined                              _defined
  472.      u    undefined                            _undefined
  473.      c    contains                             _contains
  474.      w    contained within                     _within
  475.      m    pattern match                        _match
  476.      f    pattern fail match                   _fail
  477.      s    errorcode set                        _error
  478.      o    error code O.K.                      _ok
  479.      r    actn mod. returned string            _result
  480.      b    actn mod. returned nothing           _noresult
  481.      z    file operation failure               _filerror
  482.      A-Z  Application flags
  483.      v    [IDE] set during view mode           _viewmode
  484.      i    [IDE] set for IDE only               _IDE
  485.  
  486.      --- Local to frame ---
  487.  
  488.      0-9  local flags
  489.      /    matching frame flag                  _matching
  490.      :    frame has been visited               _visited
  491.      <    frame over one screen                _overscreen
  492.  
  493.         HyperShell Version 4.0 - Quick Reference Guide          Page 10
  494.  
  495.      24. Reserved characters in Actions
  496.  
  497.      ----- (character 2,3) ------
  498.  
  499.      @     Dynamic menu
  500.      &     String function
  501.      !     Read record
  502.      =     Expression evaluation
  503.      %     Environment variable
  504.      ?     Prompted input
  505.  
  506.      ----- (any character) -----------
  507.  
  508.      $     Variable expansion token
  509.      |     Action modifier pattern spec
  510.      ^     (Within frame names) Hyperfile sep
  511.      ;     Multiple action separator
  512.  
  513.      ----- (In frame / note text) --------
  514.  
  515.      ~     Reference and formatting flag
  516.      $     Variable expansion token
  517.      .     (At beginning of line) Keyword
  518.  
  519.      25. Options
  520.  
  521.      O0 - 0 = Do not produce restart file
  522.           1 = Use restart file for notes
  523.           2 = Use for notepad, vars and frame
  524.      O1 - 0 = Show funct keys, but not symbols
  525.           1 = Show symbols
  526.           2 = Use 1st letter, no Func keys
  527.           4 = Immediate menus on top line
  528.      O2 - 0 = No backtrack recording
  529.           1 = Record backtrack
  530.      O3 - 0 = No frame extns in notepad
  531.           1 = Add file name as ref extension
  532.           2 = Suppress INS/DEL notepad actions
  533.      O4 - 0 = No autoreference
  534.           1 = Autoreference frame names
  535.           2 = Application specified autoref
  536.           4 = Autoreference global notes
  537.      O5 - 0 = 'o' output to bottom line
  538.           1 =  output to printer ( -p flag)
  539.           2 =  to standard text output
  540.           3 =  to AUX device
  541.           4 =  to output file (opened by 'w')
  542.      O6 - 0 = exit without displaying memory
  543.           1 = Display remaining space on exit
  544.           2 = Swap HS.EXE to disk on DOS command
  545.      O7 - 0 = No tracing
  546.           1 = Trace script labels
  547.      O8 - 0 = Don't warn if item not found
  548.           1 = Give warnings for item not found
  549.      O9 - 0 = 'T' listing interpret ref flags
  550.           1 = 'T' listing give verbatim list
  551.           2 = As 1, also strips 8th bit
  552.  
  553.         HyperShell Version 4.0 - Quick Reference Guide           Page 11
  554.  
  555.      26. Extended options
  556.  
  557.      O*0 - 0 = ESC key does not cancel
  558.            1 = ESC key cancels script
  559.      O*1 - 0 = No shadows on popups
  560.            1 = Shadow edges on popups
  561.      O*2 - 0 = No blinking
  562.            1 = Blink mouse cursor
  563.            2 = Blink cursor and refs
  564.      O*3 - 0 = Mouse cursor, keys step 1
  565.            1 = Suppress mouse cursor
  566.            2 = Cursor keys step as TAB
  567.      O*4 - 0 = Autoref typed files
  568.            1 = Autoref files & frames
  569.      O*5 - 0 = Accept characters < 128
  570.            1 =    less than 176
  571.            2 =    less than 255
  572.      O*6 - 0 = Search all frames
  573.            1 = Search matching only
  574.            2 = Search frames not matched
  575.            3 = as for 1 and 2, but reset
  576.            4 =   to 0 after next search
  577.            5 to 9 - as 0 to 4 with non-stop
  578.      O*7 - n = Tab width (1 to 9)
  579.      O*8 - 0 = No comments on noted refs
  580.            1 = Request comment on notes
  581.      O*9 - 0 = Key mapping case sensitive
  582.            1 = Key mapping case insensitive
  583.  
  584.      27. Colour schemes
  585.  
  586.      A      wB      Action reference
  587.      B      Wk(bl)  Blink
  588.      C      KC      Menu choice
  589.      D      KW      Default title
  590.      E      yK      Frame reference (replace)
  591.      F      wK      Frame reference (stack)
  592.      G      KK      Popup shadow edge
  593.      H      KY      Menu heading
  594.      I      yY      Input field
  595.      J      KG      Note heading and border
  596.      K      yG      Note
  597.      L      RK      Low intensity
  598.      M      KW      Menu reference
  599.      N      gK      Note reference
  600.      O      yB      Menu selection
  601.      P      yr(bl)  Popup message
  602.      Q      Kk(bl)  XOR mask for ref blink (O*22)
  603.      R      KW      Request / message
  604.      S      yG      Script reference
  605.      T      WK      Frame text
  606.      U      YK      (User 1)
  607.      V      MK      (User 2)
  608.      W      GK      (User 3)
  609.      X      RK      (User 4)
  610.      Y      BK      (User 5)
  611.      Z      rK      (User 6)
  612.  
  613.         HyperShell Version 4.0 - Quick Reference Guide           Page 12
  614.  
  615.      28. Colour codes
  616.  
  617.      K      Black                        _black
  618.      B      Blue                         _blue
  619.      G      Green                        _green
  620.      C      Cyan                         _cyan
  621.      R      Red                          _red
  622.      M      Magenta                      _magenta
  623.      Y      Yellow (Brown)               _yellow
  624.      W      White (light grey)           _white
  625.      k      Dark grey                    _grey
  626.      b      Light blue                   _lightblue
  627.      g      Light green                  _lightgreen
  628.      c      Light cyan                   _lightcyan
  629.      r      Light red                    _lightred
  630.      m      Light magenta                _lightmagenta
  631.      y      Light yellow                 _lightyellow
  632.      w      Bright white                 _lightwhite
  633.  
  634.      29. Configuration strings
  635.  
  636.      KH1 - Popup directory heading
  637.      KH2 - '?' key mapping for frame display
  638.      KH3 - '?' key for paged display (menuname)
  639.      KH4 - ESCAPE mapping       [ZC]
  640.      KH5 - HOME mapping         [y]
  641.      KH6 - END mapping          [ZR]
  642.      KH7 - PgUp mapping         [y-]
  643.      KH8 - PgDn mapping         [y+]
  644.      KH9 - Backspace mapping    [B]
  645.      KH0 - Control menu heading
  646.  
  647.      KG1 - Default action for RETURN / LEFT Mouse button
  648.      KG2 - Default for RETURN / LEFT Mouse button in typed file
  649.      KG3 - Default for ESCAPE / RIGHT button in typed file
  650.      KG4 - End of title line for Type file and @G list
  651.      KG5 - Variable expansion spec for @G formatted list
  652.      KG6 - Selection expression for @G list
  653.      KG7 - Format line for @G list
  654.      KG8 - Character translation - from string
  655.      KG9 - Character translation - to string
  656.      KG0 - - Reserved -
  657.  
  658.      30. Control menu
  659.  
  660.      KM1 - HOME
  661.      KM2 - CONTENTS
  662.      KM3 - BACKTRACK
  663.      KM4 - SELECT BACK
  664.      KM5 - NOTEPAD
  665.      KM6 - SEARCH TEXT
  666.      KM7 - TYPE FILE
  667.      KM8 - DO ACTION
  668.      KM9 - DOS SHELL
  669.      KM0 - EXIT
  670.  
  671.         HyperShell Version 4.0 - Quick Reference Guide           Page 13
  672.  
  673.      31. Error codes
  674.  
  675.      1 - Operation cancelled
  676.      2 - No selection from menu
  677.      3 - End of file
  678.      4 - Cant open file
  679.      5 - File not open
  680.      6 - File open
  681.      7 - File changed
  682.      8 - At start of backtrack
  683.      9 - Divide by zero
  684.      10 - Value not expected
  685.      11 - Value expected
  686.      12 - Undefined opcode
  687.      13 - Unmatched parenthesis
  688.      14 - Syntax error
  689.      15 - Script not available
  690.      16 - Menu not available
  691.      17 - Note not available
  692.      18 - Frame not available
  693.      19 - Key not defined
  694.      20 - Invalid key code
  695.      21 - Local ref can't be noted
  696.      22 - Not at reference
  697.      23 - Key not mapped
  698.      24 - No action or disabled
  699.      25 - Invalid action code
  700.      26 - No command
  701.      27 - Env var not present
  702.      28 - Invalid dynamic menu
  703.      29 - Line too wide for screen
  704.      30 - String too long
  705.      31 - Too many lines in frame
  706.      32 - Max script reached
  707.      33 - Maximum menu size reached
  708.  
  709.         HyperShell Version 4.0 - Quick Reference Guide           Page 14
  710.  
  711.          ================ INTEGRATED ENVIRONMENT REFERENCE =================
  712.  
  713.      32. Edit actions
  714.  
  715.      #Atname~tafter    Add item and enter edit mode.         add(item,after)
  716.      #atname~tfrom     Add item, copied from other           copy(item,from)
  717.      #Bmessage         Load paged list message/edit string   before(string)
  718.      #Ctname           Check item.                           check(item)
  719.      #Ftname           Find item, set 'd' or 'u'             lookfor(item)
  720.      #Mtname~tafter    Move item.                            move(item,toafter)
  721.      #Dtname           Delete item.                          delete(item)
  722.      #Utname~tafter    Undelete item.                        undelete(item)
  723.      #Vtname           view item.                            view(item)
  724.      #Etname           edit item.                            edit(item)
  725.      #Onvalue          Edit option setting                   editopt(opt,value)
  726.      #Lmmmmm;          Left margin default string for frame  lmargin(mmmmmm)
  727.      #Wnn              Right margin default for frame        rmargin(nn)
  728.      #Ptname           Print item, interpreting flags.       print(item)
  729.      #ptname           Print item verbatim (no interp).      printv(item)
  730.      #Rtname~tnewnm    Rename or change details.             rename(item,to)
  731.      #TFframe~newtit   Change title string for frame.        rentitle(item,to)
  732.      #Ztname           zap deleted item.                     zapdel(item)
  733.      #X                save and exit.                        savexit()
  734.      #Yfilename        save as 'filename' and exit           saveas(filename)
  735.      #Q                quit with no saves.                   quitedit()
  736.      #QQ               delete change file, and quit no save  quitedit(Q)
  737.      #S                save file and continue.               save()
  738.      #I                Incremental save.                     saveinc()
  739.                      - save changes and index
  740.                      - can Q after this and index and changes
  741.                        will be read on next run of HI
  742.      #Knnn string      Set config string (edit key mapping)  setconfig(nn,strg)
  743.  
  744.      Parameters
  745.  
  746.      'tname' (and tafter etc) is made up of 't' and 'name'
  747.      't' is the item type specifier
  748.              N,n,M,m,S,s  -   as expected
  749.              F            -   FRAME
  750.              R            -   REMARK              t_remark()
  751.              E            -   END                 t_end()
  752.              P            -   PRINT directive     t_print(directive)
  753.              C            -   CHECK directive     t_check(settings)
  754.              T            -   Text file           t_file(filename)
  755.  
  756.      Extra types
  757.  
  758.      These types may be specified for certain operations
  759.              U           -   HEADER               t_header()
  760.              V           -   FOOTER               t_footer()
  761.              I           -   INDEX                t_index()
  762.              Z           -   SHARE                t_share()
  763.  
  764.         HyperShell Version 4.0 - Quick Reference Guide           Page 15
  765.  
  766.      33. Extra dynamic menus
  767.  
  768.      @I        Global item list                 globals()
  769.      @i        Local item list                  locals()
  770.      @Z        Deleted item list                deleted()
  771.  
  772.      @P{n}{title}  Global item popup menu       globalpop(n,title)
  773.      @p{n}{title}  Local item popup menu        localpop(n,title)
  774.                    Values for 'n' are
  775.                    0        MENU
  776.                    1        NOTE
  777.                    2        SCRIPT
  778.                    3        PRINT
  779.                    4        CHECK
  780.                    5        REMARK
  781.                    6        END
  782.      @Ystring      Global item search           searchglob(string)
  783.      @ystring      Local item search            searchloc(string)
  784.      @U            Check frame texts            checkframes()
  785.      @V            Check global items           checkglobal()
  786.      @v            Check local items            checklocal()
  787.  
  788.      34. Flags in lists
  789.  
  790.            blank    Item is in original file
  791.            M        Item is in memory
  792.            C        Item is in the change file
  793.            R        Item is readonly control item (not displayed)
  794.            ?        Item failed last scan check
  795.  
  796.      35. Extra Functions
  797.  
  798.      &f{d}           Free space on default (specified) drive
  799.      &l              Length of current hyperfile
  800.      &idefault       Input text from current screen position
  801.  
  802.      &0 to &9        Edit mode variables
  803.                      0 is macro
  804.                      1 is search string
  805.                      2 is replace string
  806.                      3,4 are user definable
  807.                      5 is edited item name
  808.                      6 is edited item type name
  809.                      7 is last deleted (part) line
  810.                      8 is kill buffer
  811.                      9 is left margin
  812.  
  813.      36. Environment options
  814.  
  815.      Set via #Onvalue, where n is one of
  816.        0  1       Create backup on save (set by -eb)
  817.        1  0       (Create file -ec)
  818.        2  1       scrollbar (0 = none, 1 = scrollbar)
  819.        3  0       assumed indent (for edit mode/checks)
  820.  
  821.      Run option values for &R
  822.          28        Edit location (0 = in memory, 1 = from file '-ef')
  823.          29        Number of edits so far
  824.  
  825.         HyperShell Version 4.0 - Quick Reference Guide           Page 16
  826.  
  827.      37. Edit mode primitive function codes
  828.  
  829.      A                Autoref global
  830.      a                Autoref local
  831.      B                Beginning of line
  832.      b                Beginning of word
  833.      C                Toggle cursor tracking (actual / displayed)
  834.      cspec            Convert according to 'spec' (see CALL extns)
  835.      D                Delete current char
  836.      d                Delete previous char
  837.      E                End of line
  838.      e                End of word
  839.      F                Autoref from frame list
  840.      ffspec           Append file
  841.      Gnn              Goto line number nn
  842.      gnn              Goto column nn
  843.      H                Toggle flag interpretation
  844.      hnspec           Popup note
  845.      I                Toggle Insert/Overwrite
  846.      iispec           Append item
  847.      J                Join lines
  848.      j                Fill / justify / centre paste buffer
  849.      K                Kill (delete) current line
  850.      kstring          Load kill buffer
  851.      L                Insert newline character
  852.      l                Set temp left margin
  853.      M                Toggle margins
  854.      m                Set position at mouse (or scrollbar)
  855.      N                Next page
  856.      n                Next line
  857.      O                open line before
  858.      o                open line after
  859.      P                Prev page
  860.      p                Prev line
  861.      Q                Quit edit
  862.      q                Save edit buffer to EDITBUFF.SAV
  863.      R                Refresh screen
  864.      r                Set temp right margin
  865.      S                Toggle symbol shift
  866.      ssspec           Insert string
  867.      T                Insert TAB character
  868.      tfspec           Append text screen
  869.      U                Undelete line as separate line
  870.      u                Undelete line inline
  871.      V                Verbatim character (from keyboard)
  872.      v                Verify (Check) edit buffer
  873.      W                wipe reference flags from word
  874.      wfspec           Append screen with attributes
  875.      X                Exit edit with save
  876.      xsspec           Execute function string
  877.      Ymessage         Ask for confirmation (multiple action line)
  878.      ystring          Search for string and position cursor
  879.      Z                Delete to start of line
  880.      z                Delete to end of line
  881.  
  882.         HyperShell Version 4.0 - Quick Reference Guide           Page 17
  883.  
  884.      0                User settable
  885.      1                  edit mode
  886.      2                  variables for
  887.      3                  use with &0 to &4
  888.      4                  functions
  889.      #                Store current column,line in &3,&4
  890.      .                Mark start line
  891.      -                Cut from start line
  892.      +                Paste cut lines
  893.      ^                Paste first line 'in line'
  894.      /filename        Save paste buffer to named file
  895.      =c               actual character 'c'
  896.      *                copy character from mouse position
  897.      <                Previous char
  898.      >                Next char
  899.      {                Beginning of paragraph (first line)
  900.      }                End of paragraph (last line)
  901.      (                Start of repeat range (must have ; after)
  902.      )                End of repeat range (end of multi-string)
  903.      !action          Do action (limited actions only !!!)
  904.  
  905.      Parameters - nspec,fspec,sspec,ispec
  906.  
  907.      Can be a literal string or from action modifier
  908.  
  909.      nspec        Note spec = tname,Nname,nname
  910.      ispec        Item spec = nname,Nname,mname,Mname,sname,Sname,Fname
  911.      fspec        File spec = filename.ext
  912.      sspec        String = any string
  913.  
  914.      38. Graphics characters showing mappings in Symbol shift
  915.  
  916.      `abcdefghijklmnopqrstuvwxyz+,./{}|  3 4 5 6 7 8 9 = ; : @ < >
  917.      αßΓπΣσµτΦΘΩδ∞φε∩≡±≥≤⌠⌡÷≈°∙·½¼«»√²ⁿ  │ ┤ ╡ ╢ ╖ ╕ ╣ ╜ ╗ ║ └ ╝ ╛
  918.  
  919.      A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
  920.      ┴ ┬ ├ - ┼ ╞ ╟ ╚ ╔ ╩ ╦ ╠ ═ ╬ ╧ ╨ ╤ ╥ ╙ ╘ ╒ ╓ ╫ ╪ ┘ ┌
  921.  
  922.        ┌─┬─┐  ZDBD?   ╔═╦═╗  IMKM;   ░  0        â ä à å Ä Å á
  923.        ├─┼─┤  CDED4   ╠═╬═╣  LMNM9   ▒  1        Ç ç
  924.        │ │ │  3 3 3   ║ ║ ║  : : :   ▓  2        é ê ë è É
  925.        └─┴─┘  @DADY   ╚═╩═╝  HMJM<   █  [        ï î ì í
  926.                                                  ¢ £ ¥ ₧ ƒ ⌐ ¬ ¡
  927.        ╒═╤═╕  UMQM8   ╓─╥─╖  VDRD7   ▌  ]        ô ö ò Ö ó
  928.        │ │ │  3 3 3   ║ ║ ║  : : :   ▐  ^        ü û ù Ü ú
  929.        ╞═╪═╡  FMXM5   ╟─╫─╢  GDWD6   ▀  _        æ Æ
  930.        ╘═╧═╛  TMOM>   ╙─╨─╜  SDPD=   ▄  \        ÿ ñ Ñ ª º ¿
  931.  
  932.         HyperShell Version 4.0 - Quick Reference Guide           Page 18
  933.  
  934.      39. Default Key Mappings
  935.  
  936.      Enter                      - Insert new line / break current line
  937.      Backspace                  - Delete previous character
  938.      Escape or Right Mouse      - Edit menu
  939.      LEFT Mouse                 - Position cursor / use scrollbar
  940.      Cursor Up,Down,Left,Right  - Prev line, Next line, Prev char, Next char
  941.      Home, End                  - Beginning of line, End of line
  942.      Ctrl Home, Ctrl End        - Go to start of word, end of word
  943.      Page Up, Page Down         - Previous page, Next page
  944.      Ctrl PgUp, Ctrl PgDn       - Go to start, end of buffer
  945.      Insert                     - Toggle Insert mode
  946.      Delete                     - Delete next character
  947.      Ctrl Left, Ctrl Right      - Delete to start, end of line
  948.  
  949.      40. Control Keys
  950.  
  951.      ^A    - open new line After current
  952.      ^B    - open new line Before current
  953.      ^D    - Delete inline (from ^X position)
  954.      ^E    - Enter EDIT command
  955.      ^F    - reformat paragraph
  956.      ^G    - Toggle flag interpretation
  957.      ^J    - Join current line to next line
  958.      ^K    - Kill (delete) current line
  959.      ^L    - Set temporary Left margin
  960.      ^N    - Save edit buffer to file EDITBUFF.SAV
  961.      ^O    - Toggle margins (clear temporary margins)
  962.      ^Q    - Quote verbatim character (next char typed)
  963.      ^R    - Set temporary Right margin
  964.      ^T    - Toggle cursor Tracking (actual / visible char)
  965.      ^U    - Undelete line
  966.      ^V    - Verify (check) buffer
  967.      ^W    - Wipe reference flags
  968.      ^X    - Mark start for inline cut (^D to cut)
  969.      ^Y    - paste in line
  970.      ^Z    - duplicate character from mouse position
  971.  
  972.      41. Function Keys
  973.  
  974.            UNSHIFTED      SHIFT(flag as)  CONTROL (insert)  ALTERNATE
  975.      F1  - Help menu      Frame step      Frame reference   Frame autoref
  976.      F2  - Refresh        Frame ref       Global item ref   Global note autoref
  977.      F3  - Macro (check)  Global note     Local item ref    Local note autoref
  978.      F4  - Swap with mark Local note      Append Frame      Search/replace
  979.      F5  - Mark for cut   Global menu     App Global item   Search again
  980.      F6  - Cut from mark  Local menu      App Local item    Search for string
  981.      F7  - Paste lines    Global Script   App File text     Copy to kill buffer
  982.      F8  - Symbol shift   Local Script    App Screen file   Paste kill buffer
  983.      F9  - QUIT edit      Action          App Screen (att)  DOS exit
  984.      F10 - Save & exit    Input field     App saved buffer  Save PASTE buffer
  985.  
  986.         HyperShell Version 4.0 - Quick Reference Guide           Page 19
  987.  
  988.      42. HyperShell Reader
  989.  
  990.      hs {options} hyperfile {frame}
  991.  
  992.        -n  Restart file for notes
  993.        -r  Restart for notes,variables,frame
  994.        -s  Save screen for redisplay on exit
  995.        -m  Force use of mouse emulator
  996.        -f  Suppress symbols on menus
  997.        -b  Suppress backtrack recording
  998.        -a  Switch on autoreferencing
  999.        -u  Display available memory on exit
  1000.        -x  Suppress file suffix on notepad
  1001.        -t  Trace labels in scripts
  1002.        -h  MDA/Hercules highlighting scheme
  1003.        -g  CGA/EGA highlighting scheme
  1004.        -z  Flash mouse cursor
  1005.        -l  Verbatim Type file listing
  1006.        -k  Verbatim and strip 8th bit
  1007.        -d  Use BIOS for display
  1008.        -q  Stop Crl-C/Ctrl-Break
  1009.        -vVstring Set variable V to string
  1010.  
  1011.      43. HyperShell Integrated Environment
  1012.  
  1013.      hi {options} hyperfile {frame}
  1014.  
  1015.        OPTIONS AS FOR HS - PLUS
  1016.  
  1017.        -ef   Work against file, rather than in memory
  1018.        -eb   Delete original, rather than saving as .BAK
  1019.  
  1020.      44. HyperShell Checker
  1021.  
  1022.      hc {options} hyperfile
  1023.  
  1024.        -t            suppress audit trail
  1025.        -h            translate .HSL source to .HYP first
  1026.        -j            just translate .HSL file
  1027.        -dname=defn   define source variable (name=val)
  1028.        -ifile        include file
  1029.        -l            list complete hyperfile
  1030.        -n            suppress line numbers in listing
  1031.        -e            list with embedded errors, (sets -l, -n and -o)
  1032.        -c            create unrefd frames etc
  1033.        -u            suppress error messages for unrefd items
  1034.        -g            extended autogeneration (sets -e -c -u -o_
  1035.        -b            autoreference
  1036.        -k            extended autoreference (sets -l -n -u -b -o)
  1037.        -o            produce file filename.CHK
  1038.        -a            do action checks for menus with actions
  1039.        -x            suppress menu length check
  1040.        -f            do frame reference checks for menus without actions
  1041.        -p            suppress frame length check (paged frames)
  1042.        -r            produce reference counts
  1043.        -s            suppress summary totals
  1044.        -z            produce cross reference file
  1045.  
  1046.         HyperShell Version 4.0 - Quick Reference Guide           Page 20
  1047.  
  1048.      45. HyperShell Print program
  1049.  
  1050.      hp {options} hyperfile {frame name}
  1051.  
  1052.        -p  output straight to printer
  1053.        -e  output to printer using print effects
  1054.        -l      with -p or -e, set letter quality
  1055.        -tn  assume tab size of 'n'
  1056.        -mn  assume left margin on frames of n
  1057.        -hnn  page height nn rather than 66
  1058.        -s  soft formfeeds
  1059.        -n  Do not do page breaks, or index
  1060.        -w  Format for word processor (sets -n)
  1061.        -d  use default heading, rather than first title
  1062.        -r  list reference details after frame
  1063.        -g  include notes (glossary)
  1064.        -f  full list including items
  1065.        -o  print one frame (with notes if -f)
  1066.        -i  ignore print directives
  1067.        -a  stop and ask before each new page
  1068.        -v  configuration file diagnostic display
  1069.  
  1070.      46. HyperShell Compress program
  1071.  
  1072.      hcx {-c/-r/-s){-x/-p/-o/-n}{-t} file
  1073.  
  1074.        COMPRESSION
  1075.         -c   compress
  1076.         -r   rename
  1077.         -s   secret (one way compression for primary hyperfile only)
  1078.        EXPANSION
  1079.         -x   expand to file
  1080.         -p   paged display
  1081.         -o   expand to output
  1082.         -n   just show filename
  1083.        BOTH
  1084.         -t   remove/add <CR> chars
  1085.  
  1086.      47. BLOAD image tagger
  1087.  
  1088.      tagbload filename.ext {mode}
  1089.  
  1090.       Mode           Resolution        Colours
  1091.  
  1092.       0 or 1       40x25   text     - 16
  1093.       2 or 3       80x25   text     - 16
  1094.       4 or 5       320x200 graphics - 4
  1095.       6            640x200 graphics - 2
  1096.       7            80x25   text     - Monochrome with attributes
  1097.       7            720x350 graphics - Hercules monochrome
  1098.       13           320x200 graphics - 16
  1099.       14           640x200 graphics - 16          (1 showing)
  1100.       15           640x350 graphics - 4
  1101.       16           640x350 graphics - 16          (1 showing)
  1102.       17           640x480 graphics - 2
  1103.       18           640x480 graphics - 16          (1 showing)
  1104.       54 to 59  and other special modes may also work, depending on adaptor
  1105.  
  1106.         HyperShell Version 4.0 - Quick Reference Guide           Page 21
  1107.  
  1108.      48. HyperShell subset popup program
  1109.  
  1110.      hypop filename.ext           install
  1111.      hypop -u                     uninstall
  1112.      ---- Subset capabilities
  1113.       .FRAME name (up to 35)
  1114.       .TITLE title string (up to 35)
  1115.       text up to 22 lines of 79 columns MAXIMUM.
  1116.      Default mode referencing uses reference flags ~F and ~E
  1117.      Automatic mode referencing (.REMARK AUTO) uses autoreference
  1118.      ---- Invocation
  1119.       Hotkey Alt-/
  1120.      ---- Operation
  1121.       Keys TAB, BackTAB, cursors, alphabetic keys, to move.
  1122.       RETURN to select.
  1123.       Home, PgUp and PgDn move to first, previous and next frames.
  1124.       F3 is backtrack
  1125.       F10 key or the ESCAPE key exits
  1126.  
  1127.      49. HyperShell Floating Point
  1128.  
  1129.      hrxfp -i             install
  1130.      hrxfp -u             uninstall
  1131.  
  1132.      ---- Functions
  1133.      sin, cos, tan, atan, asin, acos, log, ln, sqrt, exp
  1134.      c_i, i_c, m_f, f_m, k_m, m_k, k_p, p_k, g_o, o_g, l_g, g_l
  1135.      d_r, r_d, c_f, f_c
  1136.      ---- Options
  1137.      #d - decimal
  1138.      #o - octal
  1139.      #x - hexadecimal
  1140.      #b - binary
  1141.      #c - character
  1142.      #pn - decimal places
  1143.  
  1144.      50. HyperShell File Extensions
  1145.  
  1146.      .HYP            Hyperfile
  1147.      .HIX            Hyperfile index
  1148.      .MNU            Menu file
  1149.      .HSF            Script file
  1150.      .NTE            Note file
  1151.      .CFG            Configuration file
  1152.      .HXC            Integrated environment index file
  1153.      .TMP            IDE temporary file
  1154.      .BAK            IDE Backup file
  1155.      .HCM            Compressed file default extn
  1156.      .HXP            Expanded file default extn
  1157.      .PIC            BLOAD image
  1158.      .PCX            Microsoft Paintbrush image
  1159.      .DAT            Database or data file
  1160.      .TXT            Raw text file
  1161.      .HSL            HSL source file
  1162.      .HSI            HSL include file
  1163.      .CHK            HC check output file
  1164.      .XRF            Cross reference
  1165.