1 FSHELP
2 ENGLISH
  FSHELP is a screen-oriented help utility. It makes use of SMG routines to 
  display help on video terminals. It has the following features

  1. Full screen display of normal .HLB files (scrolling in both directions)
     and also of .OLB, .MLB, .TLB files. It includes the possibility to
     do an analyze/obj of modules in an .OLB file.
  2. Selecting subtopics by just typing the name of the subtopic.
  3. Allows cross-referencing of help modules via the F12 key
  4. Allows header lines to remain on screen when scrolling.
  5. Allows you to look back at the last 20 topics via the F13 key
  6. Allows you to mark some help topics for easy return to this topic
              via the F17,F18,F19,F20 key.
  7. Allows you to toggle 132/80 columns (f9 key), and scroll horizontally
  8. On all screens help can be displayed via the HELP or PF2 key
  9. FSHELP checks for all libraries via the help$library* logicals
     and let you select one of then via the TAB key
 10. FSHELP also interfaces to the HELP/MESSAGE databases so you can
     define FSHELP as your normal help utility (HELP:=$'directory'FSHELP)
 11. There is a sharable image that can be called from any other application
     to display help (lib$find_image_symbol).
 12. FSHELP messages are in English, Nederlands(Dutch) or in Frysk. 
     You can easily add you own language. (see the .MSG file for help).
  
 13. You can search text within a help page (PF3), or on this page and all
     deeper levels (FIND). If you are on the top page of the help library,
     you can search through the whole library.

  The normal input is a normal help file, gathered in a normal HLB library.
  There are some extra commands in the text which are invisable in the normal
  VMS HELP command. These commands start with an ! in the first colomn, and
  VMS HELP ignores these lines. FSHELP ignores these lines also, except for
  the commands as described in Help_file_format

3 Help_file_format
  
  Help files are in the same format as normal VMS help files. The format
  is described in the 
  VMS LIBRARIAN UTILITY MANUAL, chapter 5 : HELP Libraries
  with the following additions.

  a. !# Signal the end of header lines in a help text. Th(is)(ese) lines
        (upto 4) will remain on screen, even if the text is scrolled.
  b. ![text on screen]@library topic topic ...
        FSHELP will save this information, and when you type the 
        F12 key, a list of topics will be displayed, from which you 
        can select. @library is optional. This gives a possibility to
        make see-also entries.
        If you specify /ONLINE, see-also's can also be defined
        with the syntax 
         [[text on screen]@library topic topic..]. 
        Again @library is optional, and this syntax can appear anywhere
        on the line, not just the beginning.
        You can appoint a see-also to a automatic see-also if you insert
        an asterix just after the [. If FSHELP detect a page with an automatic
        see-also, FSHELP will jump to to the requested page (without asking),
        and if you return from that page FSHELP will return to the original
        page.
  c. !@[text on screen]DCL command|dcl command...
	FSHELP will save this information, and when you type the
	PF1-E (execute) command, FSHELP will let you select from
	one of the execute-scripts.
        FSHELP will generate a batch-job in the queue FSHELP_QUEUE (default
        SYS$BATCH) containing the above lines (separated by |). In these
        commands  you can specify symbols that will asked from you.
        These symbols are separated by '. FSHELP will check if there is
        a symbol with that name. If this symbol exists FSHELP will substitute
        the value of that symbol, otherwise FSHELP will ask you for
        a substitution.
        Example  !@[header]$compute 'test'/out=q.q|$print/delete q.q
        will try to find the symbol test, and if not found will ask
        you to specify a new value for 'test'. Then a batchjob will be 
        submitted in the queue in the symbol FSHELP_QUEUE (default SYS$BATCH)
        containing the lines:
         $compute new_value/out=q.q
         $print/delete q.q
        where new_value is the value found in the symbol TEST or the value
        given by you.
        There are some predefined symbols
          THIS_LIBRARY : the filename of the current library
          THIS_TOPICS  : A string containing all (sub)topics of this page
          THIS_TOPIC_n : n=1-9 : the 'n'th (sub)topic of this page
  VMS HELP will ignore all lines starting with ! (as will FSHELP), so these
  lines can be included without interfering with VMS HELP.

3 Parameters

  You can enter help topics on the command line, just as VMS HELP.
  The format is

  [@libraryname] [topic [subtopic...]]

  FSHELP will search all libraries (im- or ex-plicitly defined) for 
  the (main) topic. If the topic is found in a file, the search will
  continue for the subtopics in that help library. 
  FSHELP will display as much subtopics as found.
  Example
  FSHELP open /append /dunnow
   will display the help about open/append from HELPLIB.HLB 

3 Qualifiers

  Via the symbol FSHELP_DEFAULT_QUALIFIERS you can specify some
  default qualifiers. These qualifiers will be parsed before the 
  qualifiers on the command line, so they can be overruled.

/AUTOSIZE

  Normally the selection window is 5 lines wide. It the /automatic 
  qualifier is specified, the window will be large enough to accomodate
  all subtopics (upto the screen size).

/BINARY

  Treat the contents of the library as binary. The datarecords will be
  displayed in VMS-dump format
/COLOR
  
  If you specify /COLOR, some fields wil appear in colors.

/DOWN
 
  /DOWN (default)

  If you specify /NODOWN and he enters FSHELP with some topics
  on the command line, FSHELP will not allow you to return to lower
  level topics than the ones specified on the command line. This feature
  is useful if you want to display only a subset of all possible 
  help information to the users.

/IMAGELIB

  In this case the SYS$SHARE:IMAGELIB.OLB will be opened instead of
  a HELP file. For this library there are only toplevel topics, but
  it can be used as a normal help library. You can select any
  library by either defining the logicalname IMAGELIB or using the
  /LIBRARY=... qualifier. 
  The default filename is SYS$SHARE:.OLB
  You can change the default. See the instructions in the .MSG file.   

/INLINE
  Normally see-also's will not be displayed in the text of the topic, but
  can be selected via the the PF1-S key. If you specify /INLINE
  is specified, the see-also will be in the text display and can be 
  selected with a mouse-click.

/LANGUAGE
  /LANGUAGE=language
  Select the language for FSHELP.
  At this moment English, Nederlands (Dutch) and Frysk(a language spoken in
  northern Holland) are supported.

/LIBRARY         
  /LIBRARY=libname

  Normally FSHELP looks in PROCESS/GROUP/SYSTEM logical name table
  for HLP$LIBRARY(_nnn) for help libraries. You can select his
  own library by the /LIBRARY qualifier. The defaults for LIBNAME are
  SYS$HELP:.HLB.
  Libname can contain wildcards, so the command fshelp/lib=*.hlb
  will open all help-libraries in the sys$help directory. If you
  specify /load_all too, all text of all libraries will be read in memory
  (this will take some time). 
/LOAD_ALL
  When FSHELP opens a libary, it creates a list of toplevel topics.
  The text of those topics is not read to memory. If you select a toplevel
  all text of that level (and all it's sublevels) are read into memory, and
  stays there unit you exit FSHELP. So the second time you want to read a 
  toplevel, the text is already in memory. If you specify /LOAD_ALL
  FSHELP will read all text to memory. This will take some time, but after
  the startup all help pages will be in memory so the access is fast.
  You can see which page's are already in memory by typing the F7 key.

/MACRO

  In this case the SYS$SHARE:LIB.MLB will be opened instead of
  a HELP file. For this library there are only toplevel topics, but
  it can be used as a normal help library. You can select any
  library by either defining the logicalname LIB or using the
  /LIBRARY=... qualifier. 
  The default filename is SYS$SHARE:.MLB
  You can change the default. See the instructions in the .MSG file.   

   
/MOUSE
  /MOUSE (default)
  Normally FSHELP responds to mouse command (see also mouse_support).
  If you enter /NOMOUSE, FSHELP will ignore mouse input, and let
  DECWINDOWS/VXT handle the mouse.
![Mouse support ]fshelp english MOUSE_support

/OBJECT

  In this case the SYS$SHARE:STARLET.OLB will be opened instead of
  a HELP file. For this library there are only toplevel topics, but
  it can be used as a normal help library. You can select any
  library by either defining the logicalname STARLET or using the
  /LIBRARY=... qualifier. 
  The default filename is SYS$SHARE:.OLB
  Deeper topics include a page containing a raw dump of the module 
  and a page containing the analyze/object of the module.
  You can change the default. See the instructions in the .MSG file.   

/OWNHELP
  Display the help about FSHELP itself.

/SEARCHWILD

  /SEARCHWILD (Default)

   Normally when searching for items, the searchstring will match anywhere
   in the topic . If /NOSEARCHWILD is specified, the search will match only
   at the beginning of the item. So with /NOSEARCHWILD a search for C will 
   end up in CALL instead of ACCOUNTING in the normal HELPLIB


/SELECT
 /SELECT=OPTION
  /SELECT=HORIZONTAL (DEFAULT)

  Lets you choose between selection formats. Normally the selection
  screen will be a horizontal window. You can also select a vertical
  window, or an automatic format, where FSHELP selects between vertical and
  horizontal format, depending on the number of subtopics.
 
  option can be:

  HORIZONTAL		default
  VERTICAL		
  AUTOMATIC

/SKIPEMPTY
  /NOSKIPEMPTY (Default)

 If you specify /SKIPEMPTY, FSHELP will not display empty pages
 Normally FSHELP will output a screen containing 

 Type RETURN to continue
/SORT
  If you specify /SORT, all deeper help topics will be sorted before
  beeing displayed to you. Most help libraries have those topics sorted,
  but with this qualifier you can sort them if they are not.
/TAB

  /TAB  (default)

  If you specify /NOTAB FSHELP will not use TABS in the display.

/TEXT		
  
  In this case the SYS$SHARE:FORSYSDEF.TLB will be opened instead of
  a HELP file. For this library there are only toplevel topics, but
  it can be used as a normal help library. You can select any
  text library by either defining the logicalname FORSYSDEF or 
  using the /LIBRARY=... qualifier. 
  The default filespecification is SYS$SHARE:.TLB
  You can change the default. See the instructions in the .MSG file.   

/USERLIBRARY

 /USERLIBRARY=(tablename[,tablename...])

  /USERLIBRARY=ALL (default)

  Normally FSHELP looks in PROCESS/JOB//GROUP/SYSTEM logical name table
  for HLP$LIBRARY(_nnn) for help libraries. You can select which
  tables must be used by /USERLIBRARY=(nametable,nametable...)
  Possible tablenames are

  ALL     : Select all tables (default)
  SYSTEM  : Select only system  logical nametable
  GROUP   : Select only group   logical nametable
  JOB     : Select only job     logical nametable
  PROCESS : Select only process logical nametable

/VMS

  Use LBR$OUTPUT_HELP instead of FSHELP to display the help information.
  This results in the same result as VMS HELP.

![VMS help]@helplib HELP
  
 
/WHOLE

  Normally the cursor will remain on the first line of the display,
  and each movement will result in scrolling. If you specify
  /WHOLE, the cursor can freely move on the screen, and scrolling will
  occur only when necessary.

/MESSAGE
  Let FSHELP display the messagehelp libraries in the same layout
  as the VMS HELP/MESSAGE command, but with full screen display.

4 Qualifiers
/STATUS
 /STATUS=number
 /STATUS='$STATUS' Default

  With the /MESSAGE, display the help-message for the status value
/FACILITY
  /FACILITY=facname

  With the /MESSAGE, display the help-message for the reqquested facililty only.
  

3 CALLABLE_INTERFACE

  FSHELP is callable a shared library. The command to link is
  LINK application,fshelp_dir:FSHELP_SHARE_'architecture'/lib
  The call format is:

  CALL FSHELP_DISPLAY_HELP(LBRNAME,TOPICS,OPTIONS)

  LBRNAME is the /LIBRARY value (can be empty or all spaces)
  TOPICS  are the help topics   (can be empty or all spaces)
  OPTIONS is a list of long words
          The first is a bit mask containing the following bits. These bits
           are defined in fshelp_dir:fshelp_def.for
           (include 'fshelp_dir:fshelp_def'

	   fshelp_m_search_system  : search system logical name table
	   fshelp_m_search_group   : search group logical name table
	   fshelp_m_search_job     : search job logical name table
	   fshelp_m_search_process : search process logical name table
           fshelp_m_autosize       : autosize the subtopics window
                                           see /autosize
           fshelp_m_no_down        : do not allow lower help level
	                                  see /down
           fshelp_m_no_tabs        : Do not use tabs in display 
                                          see /tabs
           fshelp_m_vertical       : display subtopics vertical
           fshelp_m_automatic      : display subtopics automatic
                                          see /select 
           fshelp_m_vms            : Use VMS HELP
           fshelp_m_image          : Give help on the current image, the 
                                       help file is searched in the same
                                       directory, and with the same name
                                       as the current image
           fshelp_m_searchwild     : Searchstrings are anywhere in topics
                                      not only in the begin
           fshelp_m_colour         : Use colour in display
           fshelp_m_whole          : Let the cursor flow on the whole display
           fshelp_m_textlib        : Library is a .TLB file
           fshelp_m_macrolib       : Library is a .MLB file
           fshelp_m_shlib          : Library is a .OLB file (shareable imagelib)
           fshelp_m_nomouse        : Do not listen to mouse commands

          The second word contains the first four letters of the language
	  
    You can also call the library at runtime by the LIB$FIND_IMAGE_SYMBOL
    See coding example in the file FSHELP_OUTPUT_HELP_EXAMPLE.FOR

4 Example
   The following program shows how to call fshelp
   The file is called prog.for
 
	program prog
	implicit none
c
	integer*4 option(2)
	include 'fshelp_dir:fshelp_def'
c
	option(1) = fshelp_m_image
	option(2) = 'ENGL'   		!Language english
c
	call fshelp_display_help(' ','topic_1',option)
	end

   $FORTRAN PROG
   $LINK PROG,FSHELP_LIB/LIB
   $RUN PROG

  Will search help in the PROG.HLB help library in the same 
  disk and directory as the PROG program. In this library the help
  topic "TOPIC_1" is located and displayed.
  See also the example in FSHELP_OUTPUT_HELP_EXAMPLE.FOR

3 Mouse_support

  This version supports the mouse on DECWINDOWS/VXT terminals.

4 TEXT_windows

  The mouse has the following actions
  1. On the top line , when clicked on one of the (LVDS) chars on the right 
     size, the response will be 
	L=TAB   (Libraries), 
     	D=ENTER (deeper topics) 
	S=F12   (See-also's), 
	E=PF1-E (Execute).

  2. On line 2 the response will be as PF4 (back one level)  
  3. In the text window (line 3..n) the response will be as follows:
      When using left button
       a. Middle top    : Scroll 1 on more lines up.
       b. Middle bottom : Scroll 1 on more lines down.
       c. Left  middle  : Scroll left some lines.
       d. Right middle  : Scroll right some lines.
     When using middle buttom
       ENTER = Deeper help
     When using right buttom
       F12 = See-alsos

4 SELECTION_windows.

   Left button
     When clicked on a topic, that topic will be choosen.
     When clicked on right side (column 78..80)
      a. When clicked on top    half : Scroll up   1 line
      b. When clicked on bottom half : Scroll down 1 line
     When clicked outside selection window : PF4 go back to text display.

   Middle button

     a. When clicked above window : selection window is expanded by 1 line
     b. When clicked in    window : selection window is contracted by 1 line

   Right button

    Toggle between horizontal and vertical display

3 examples

 Below are two gages with examples
 The first page HEADER gives an example on page with headerlines
 The second page SEEALSO gives an exmple on see-also's
  
4 Header
Headerline 1
Scroll through the line and the headerlins will stay on screen.
Name      Addres      City
!#
Jansen    Straat 12   Amsterdam
Janse1    Straat 13   Amsterdam
Janse2    Straat 14   Amsterdam
Janse3    Straat 15   Amsterdam
Janse4    Straat 16   Amsterdam
Janse5    Straat 17   Amsterdam
Janse6    Straat 18   Amsterdam
Janse7    Straat 19   Amsterdam
Piet1     Pstraat12   Den haag                  
Piet2     Pstraat15   Den haag                  
Piet3     Pstraat16   Den haag                  
Piet4     Pstraat17   Den haag                  
Piet5     Pstraat18   Den haag                  
Piet6     Pstraat19   Den haag                  
Piet7     Pstraat20   Den haag                  
Jhan1     Jweg 43     Rotterdam
Jhan2     Jweg 44     Rotterdam
Jhan3     Jweg 45     Rotterdam
Jhan4     Jweg 46     Rotterdam
Jhan5     Jweg 48     Rotterdam
Jhan6     Jweg 49     Rotterdam
Jhan7     Jweg 50     Rotterdam
Jhan8     Jweg 51     Rotterdam
Jhan9     Jweg 52     Rotterdam
4 SEEALSO

 This page contains an see-also to the HEADER example ans also one to
 the help from HELPLIB about COPY (HELPLIB Must be loaded)
 Type PF1-S to see these see-also's
 Notice the S on the top left in eht header
 If you had specified /INLINE, these see-also's would be visible
 in screen and could be slected with a mouse-click.

![See-also to HEADER]fshelp neder voorbeelden kop
![See-also to COPY in helplib]@helplib copy
4 ACTION

 In this page is an execute script stored.
 Note the E in the top left of the header

!@[Execute example]help12/out=q.q @'this_library' 'this_topics'|print q.q/note="'this_topic_1'"/comm="'comment'"|delete q.q;0
2 NEDERLANDS
  FSHELP is een scherm-georienteerde help utility. Het maakt gebruik van 
  SMG routines om help te tonen op video terminals. Het heeft de volgende
  features

  1. Full screen display van normale .HLB files (scrolling in beide richtingen).
     en ook van .OLB, .MLB, .TLB files. Je hebt ook de mogelijkheid om
     een analyze/obj te zien van modules in een .OLB file.

  2. Selecteren van subtopics door het typen van de naam van de subtopic.
  3. Kent cross-referencing van help modules via de F12 toets.
  4. Laat kopregels op het scherm staan tijdens het scrollen.
  5. Laat de gebruiker de laatste 20 topics via de F13 toets snel terugvinden.
  6. Laat de gebruiker help topics markeren om snel te kunnen terugvinden
              via de F17,F18,F19,F20 toets.
  7. Laat de gebruiker de schermbreedte via de F9 toets omschakelen (80/132).
  8. Op alle schermen kan help worden vertoond via de HELP of PF2 toets.
  9. FSHELP controleert op alle libraries via de help$library* logicals
     en laat de gebruiker er een selecteren via de TAB toets
 10. FSHELP geeft ook toegang tot de HELP/MESSAGE databases, dus je kan
     FSHELP als je normale help utility definieren(HELP:=$'directory'FSHELP)
 11. Er is een sharable image dat vanuit andere applicaties kan worden
     aangeroepen om help te tonen (lib$find_image_symbol).
 12. FSHELP boodschappen zijn in het Engels, het Nederlands of het Frysk. 
     Je kan eenvoudig een nieuwe taal toevoegen (Zie de info in de .MSG file).
 13. Je kan binnen een pagina zoeken (PF3), of op de huidige en alle diepere
     pagina's (FIND). Als je op de top help-pagina staat, kun je de hele
     help-library doorzoeken.

  De normale invoer is een normale help file, opgeslagen in een normale 
  HLB library. Er zijn een aantal extra commando's in de tekst die onzichtbaar
  zijn voor het normale VMS HELP commando. Deze commando's beginnen met een ! 
  in de eerste kolom, en VMS HELP slaat deze regels overs. FSHELP slaat deze
  regels ook over, behalve de commandos zoals beschreven in Help_file_formaat

3 Help_file_formaat
  
  Help files zijn in hetzelfde formaat als normale VMS help files. Het formaat
  is beschreven in het 
  VMS LIBRARIAN UTILITY MANUAL, chapter 5 : HELP Libraries
  met de volgende uitbreidingen:

  a. !# De regels tot dit commando worden gezien als kop-regels. Deze regels
        (max 4) blijven op het scherm zelfs als de tekst scrollt.
  b. ![tekst op scherm]@library topic topic ...
        FSHELP bewaart deze informatie, en als de gebruiker de F12 toets intypt,
	worden deze topics getoond, en de gebruiker kan er een selecteren.
        Via deze mogelijkheid kan men verwijzingen in de tekst opnemen.
        Als /INLINE wordt meegegeven, kunnen verwijzingen overal in de
        regel worden geplaatst via de syntax
           [[tekst op scherm]@library topic topic..]
        en bovendien met de muis geselecteerd worden.
        Een see-also kan worden gebombardeerd tot aan automatische verwijderen
        door een ster(*) net na de [ toe te voegen. Als FSHELP een pagina 
        ontdekt met een automatische verwijzing zal FSHELP automatisch (zonder
        vragen) naar die pagina toespringen, en als je dan van die pagina
        terugkeert weer de oude pagina (die met de auto-verwijzing) 
        terugkeren.
       
  c. !@[tekst op scherm]DCL command|dcl command...
	FSHELP bewaart deze informatie, en als de gebruiker de PF1-U(itvoeren)
	toets intypt, worden deze topics getoond en de gebruiker kan er een 
	selecteren.
        FSHELP zal dan een batch-job creeeren in de queue FSHELP_QUEUE (default
        SYS$BATCH) waarin bovenstaande regels <ijn opgenomen(gescheiden door |).
	In deze commando's kunnen symbolen opgenomen worden waarvoor FSHELP
	de gebruiker zal vragen een waarde te specificeren.
        Deze symbolen zijn gescheiden door '. FSHELP controleert of er een
        symbool bestaat met die naam. Als het symbool bestaat zal FSHELP de
	waarde substitueren, anders zal FSHELP de gebruiker vragen een waarde
	op te geven.
        Voorbeeld: !@[header]$compute 'test'/out=q.q|$print/delete q.q
        FSHELP zoekt het symbool test, en als het niet bestaat zal de gebruiker
	gevraagd worden een waarde voor 'test' op te geven. Er zal dan een 
	batchjob worden gesubmit in de queue FSHELP_QUEUE (default SYS$BATCH)
        waarin de regels staan:
         $compute new_value/out=q.q
         $print/delete q.q
        waar new_value de waarde is die ofwel in het symbool TEST is gevonden 
	ofwel de waarde opgegeven door de gebruiker.
        Er zijn een aantal voorgedefinieerde symbolen
          THIS_LIBRARY : De filename van de huidige library
          THIS_TOPICS  : Een string met alle (sub)topics  van deze pagina
          THIS_TOPIC_n : n=1-9 : de 'n'de (sub)topic

  VMS HELP slaat alle regels beginnend met ! over (zet zoals FSHELP), dus deze
  regels kunnen in een help-file worden geplaatst zonder VMS-HELP te verstoren.

3 Parameters

  De gebruiker kan help topics op de commands-regel specificeren, net als met
  VMS HELP.
  Het formaat is

  [@libraryname] [topic [topic...]]

  FSHELP zoekt alle libraries (im- of ex-pliciet gedefinieerd) naar
  het (hoofd) topic. Als dit topic is gevonden in een file, dan gaat de 
  zoek door voor alle subtopics in die help library. 
  FSHELP zal zoveel mogelijk subtopics vertone als gevonden.
  b.v.
  FSHELP open /append /kweenie
  zal de help over open/append vertonen uit HELPLIB.HLB 


3 Qualifiers

  Via het symbool FSHELP_DEFAULT_QUALIFIERS kan de gebruiker de default 
  FSHELP qualifiers definieren. Deze qualifiers worden geparsed voor de 
  qualifiers op the commando-regels, zodat ze "overruled" kunnen worden.

/AUTOSIZE

  Normaal is het selectie-scherm 5 regels lang. Als de /autosize
  qualifier wordt meegegeven, zal het selectie-scherm groot genoeg zijn om
  alle topics te tonen (maximaal de scherm grootte).

/COLOR
  
  Als de gebruiker /COLOR specifeert, zullen sommige velden in kleur vertoond
  worden

/DOWN
 
  /DOWN (default)

  Als de gebruiker /NODOWN meegeeft, en FSHELP wordt opgestart met een aantal
  topics op de commando-regel line, zal FSHELP de gebruiker niet toestaan
  lagere nivos van help topics te bekijken. Deze functionaliteit kan nuttig
  zijn als de gebruiker slects een subset van hel-informatie mag(hoeft te)
  zien.

/IMAGELIB

  In dit geval zal SYS$SHARE:IMAGELIB.OLB worden geopend inplaats van een
  HELP file. Voor deze library zijn er alleen 1-nivo topics, maar het kan 
  worden gebruikt als een normale help library. De gebruiker kan een andere
  text library selecteren door de logicalname IMAGELIB te definieren of
  via de /LIBRARY=... qualifier. 
  De default filenaam is SYS$SHARE:.OLB
  De gebruiker kan de default aanpassen. Zie de help in de .MSG file.

/INLINE
  Normaal worden verwijzingen niet in de tekst pagina getoond, maar kunnen
  via de pf1-v toest worden geselecteerd. Als /INLINE wordt meegegeven, dan
  worden de verwijzigingen in de tekst pagina getoond en kunnen met een
  muis-click worden geselecteerd

/LANGUAGE
  /LANGUAGE=language
  Selecteer de taal voor FSHELP.
  Op dit moment worden English, Nederlands en Frysk ondersteund.
/LIBRARY         
  /LIBRARY=libname

  Normaal zoekt FSHELP in de PROCESS/JOB/GROUP/SYSTEM logical name tables
  naar HLP$LIBRARY(_nnn) voor help libraries. De gebruiker kan zijn eigen
  library via de /LIBRARY qualifier selecteren. De default filenaam voor
  LIBNAME is SYS$HELP:.HLB.
  Libname kan wildcards bevatten , dus het commando fshelp/lib=*.hlb
  zal alle help-libraries in the sys$help directory openen. Als de
  gebruiker dan oon nog /load_all meegeeft, dan wordt alle tekst van alle
  libraries in het geheugen gelezen (dat kan even duren).

/LOAD_ALL
  Als FSHELP een library benaderd maakt het een list van alle hoofonderwerpen.
  De text van deze onderwerpen wordt niet nog gelezen. Als de gebruiker dan
  een hoofdonderwerp selecteert wordt de tekst van dat onderwerp (en al
  zijn diepere help) in het geheugen gelezen, en blijft daar totdat FSHELP 
  wordt afgesloten. Als de gebruiker een bepaald hoofonderwerp dan voor de 
  tweede keer benadered is alle tekst al ingelezen en is dus snel toegankelijk.
  Als de gebruiker /LOAD_ALL specificeert wordeen alle onderwerpen in het
  geheugen gelezen. Dit duurt dan wel eventjes, maar daarna is alle helptekst
  in het geheugen aanwezig en dus snel toegankelijk.
  De gebruiker kan zien welke pagina's in het geheugen gelezen zijn via 
  de F7 toets.

/MACRO

  In dit geval zal SYS$SHARE:LIB.MLB worden geopend inplaats van een
  HELP file. Voor deze library zijn er alleen 1-nivo topics, maar het kan 
  worden gebruikt als een normale help library. De gebruiker kan een andere
  text library selecteren door de logicalname LIB te definieren of
  via de /LIBRARY=... qualifier. 
  De default filenaam is SYS$SHARE:.MLB
  De gebruiker kan de default aanpassen. Zie de help in de .MSG file.

/MOUSE
  /MOUSE (default)
  Normaal reageert FSHELP op muis commando's (see also muis_ondersteuning).
  Als de gebruiker /NOMOUSE meegeeft zal FSHELP muis-input niet accepteren
  en zal DECWINDOWS/VXT de muis commando's afhandelen.
![Muis support ]fshelp nederlands MUIS_ondersteuning

/OBJECT

  In dit geval zal SYS$SHARE:STARLET.OLB worden geopend inplaats van een
  HELP file. Voor deze library zijn er alleen 1-nivo topics, maar het kan 
  worden gebruikt als een normale help library. De gebruiker kan een andere
  text library selecteren door de logicalname STARLET te definieren of
  via de /LIBRARY=... qualifier. 
  Diepere help onderwerpen bevatten pagina met een ruwe dump van de module 
  en een pagina met de analyze/object van de module.
  De default filenaam is SYS$SHARE:.OLB
  De gebruiker kan de default aanpassen. Zie de help in de .MSG file.
 
/OWNHELP
  Toon de help over FSHELP.

/SEARCHWILD

  /SEARCHWILD (Default)

   Als gezocht wordt naar topics en /SEARCHWILD is aan (default), dan zal de
   tekst overal in het topic matchen. Als /NOSEARCHWILD wordt meegeven, dan
   moet de tekst aan het begin van het topic staan. Dus met /NOSEARCWILD
   wordt de zoek naar C gevonden in CALL in plaats van in ACCOUNTING in de
   normale HELPLIB

/SELECT
 /SELECT=OPTION
  /SELECT=HORIZONTAL (DEFAULT)

  Laat de gebruiker kiezen voor de het formaat van de selectie-scherm.
  Normaal is het selectie-scherm een horizontaal window. De gebruiker kan
  kiezen uit Horizontaal, Verticaal of een Automatisch formaat, waar FSHELP
  afhankelijk van het aantal topics kiest uit een horizontaal of vericaal
  formaat.
 
  option kan zijn :

  HORIZONTAL		default
  VERTICAL		
  AUTOMATIC

/SKIPEMPTY
  /NOSKIPEMPTY (Default)

 Als de gebuiker /SKIPEMPTY meegeeft zal FSHELP geen lege pagina's vertonen.
 Normaal zal FSHELP een pagina tonen met 
  Type RETURN om verder te gaan
/SORT
  Als de gebruiker /SORT meegeeft, worden alle helponderwerpen gesorteerd 
  voordat ze aan de gebuiker getoond worden. De meeste helplibraries hebben
  deze onderwerpen al gesorteerd, maar zo niet dan worden ze nu wel gesorteerd
  getoond.
/TAB

  /TAB  (default)

  Als de gebruiker /NOTAB specifeert, zal FSHELP geen TABS gebruiker voor de
  scherem display.

/TEXT		
  
  In dit geval zal SYS$SHARE:FORSYSDEF.TLB worden geopend inplaats van een
  HELP file. Voor deze library zijn er alleen 1-nivo topics, maar het kan 
  worden gebruikt als een normale help library. De gebruiker kan een andere
  text library selecteren door de logicalname FORSYSDEF te definieren of
  via de /LIBRARY=... qualifier. 
  De default filenaam is SYS$SHARE:.TLB
  De gebruiker kan de default aanpassen. Zie de help in de .MSG file.
 

/USERLIBRARY

 /USERLIBRARY=(tablename[,tablename...])

  /USERLIBRARY=ALL (default)

  Normaal zoekt FSHELP in de PROCESS/JOB/GROUP/SYSTEM logical name table
  naar HLP$LIBRARY(_nnn) voor help libraries. De gebruiker kan selecteren
  welke tables gebruikt moeten worden via de 
  /USERLIBRARY=(nametable,nametable...)
  Toegstane tablenames zijn

  ALL     : Selecteer alle tables (default)
  SYSTEM  : Selecteer alleen system  logical nametable
  GROUP   : Selecteer alleen group   logical nametable
  JOB     : Selecteer alleen job     logical nametable
  PROCESS : Selecteer alleen process logical nametable

/VMS

  Gebruik LBR$OUTPUT_HELP inplaats van FSHELP om help informatie te tonen.
  Dit levert hetzelfde resultaat als VMS HELP.

![VMS help]@helplib HELP
  
/WHOLE

  Normaal blijft de cursor op de eerste regel van het display en elke 
  verschuiving resulteert in een scroll. Als de gebruiker /WHOLE specifeert
  kan de cursor over het hele scherm lopen, en wordt alleen gescrolled als
  het nodig is.



/MESSAGE
  Laat FSHELP de messagehelp libraries tonen in dezelfde layout 
  als het VMS HELP/MESSAGE commando, maar met scroll mogelijkheden.

4 Qualifiers

/STATUS
 /STATUS=number
 /STATUS='$STATUS' Default

  Met /MESSAGE, vertoon de helpmessage voor de opgegeven statuswaarde.
/FACILITY
  /FACILITY=facname

  Met /MESSAGE, vertoon aleen de help-messages voor de gevraagde facililty.
  

   
!   qualifier debug
3 CALLABLE_INTERFACE

  FSHELP is aanroepbaar als shared library. het commando om te linken is
  LINK application,PUBLIC_DISK:[UTILITIES.FSHELP]FSHELP_SHARE/lib
  het call-formaat is:

  CALL FSHELP_DISPLAY_HELP(LBRNAME,TOPICS,OPTIONS)

  LBRNAME is de /LIBRARY waarde (kan ook leeg zijn)
  TOPICS  zijn de help topics   (kan ook leeg zijn)
  OPTIONS is een list van long-words 
	  Het eerste longword is een bitmaskter met daarin de volgende bits. 
           Deze bits worden gedefieerd in 
           public_disk:[utilities.fshelp]fshelp_lib.tlb
           in de module fshelp_def.
           (include 'public_disk:[utilities.fshelp]fshelp_lib(fshelp_def)'

	   fshelp_m_search_system  : doorzoek de system logical name table
	   fshelp_m_search_group   : doorzoek group logical name table
	   fshelp_m_search_job     : doorzoek job logical name table
	   fshelp_m_search_process : doorzoek process logical name table
           fshelp_m_autosize       : autosize het subtopics window
                                          zie /autosize
           fshelp_m_no_down        : Laat de gebruiker niet naar lager-nivo gaan
	                                  zie /down
           fshelp_m_no_tabs        : Gebruik geen tabs in display 
                                          zie /tabs
           fshelp_m_vertical       : Toon subtopics verticaal
           fshelp_m_automatic      : Toon subtopics automatisch
                                          zie /select 
           fshelp_m_vms            : Gebruik VMS HELP
           fshelp_m_image          : Geef help voor de huidige applicatiee, de 
                                       help file wordt gezocht in dezelfde
                                       directory, en met dezelfde naam als
                                       de huidige applicatie.
           fshelp_m_searchwild     : Searchstrings zijn overal in de topics en
                                      niet alleen in het begin.
           fshelp_m_colour         : Gebruik kleuren in display
           fshelp_m_whole          : Laat de cursor over het hele display lopen.
           fshelp_m_textlib        : Library is een .TLB file
           fshelp_m_macrolib       : Library is een .MLB file
           fshelp_m_imagelib       : Library is een .OLB file (shareableimagelib)
           fshelp_m_nomouse        : Luister niet maar muis commando's

          Het tweede longword bevat de eerste 4 letters  van de taal

    Je kunt ook de library op runtime aanroepen via LIB$FIND_IMAGE_SYMBOL
    Zie een voorbeeld in de file FSHELP_OUTPUT_HELP_EXAMPLE.FOR

4 Voorbeeld
   Het volgende programma laat zien hoe fshelp wordt aangeroepen
   De file heet prog.for

	program prog
	implicit none
c
	integer*4 option(2)
	include 'fshelp_dir:fshelp_def'
c
	option(1) = fshelp_m_image
	option(2) = 'NEDE'	!taal nederlangs 
c
	call fshelp_display_help(' ','topic_1',option)
	end

   $FORTRAN PROG
   $LINK PROG,FSHELP_LIB/LIB
   $RUN PROG

  Zoekt help in de PROG.HLB help library in dezelfde disk en directory
  als het PROG programma. In deze library wordt de topic "TOPIC_1" gezocht
  en getoond.
  Zie ook het voorbeeld in FSHELP_OUTPUT_HELP_EXAMPLE.FOR
 
3 Muis_ondersteuning

  Deze versie support de muis op DECWINDOWS/VXT terminals.

4 TEXT_windows

  De muis levert de volgende acties:
  1. Op de bonvenste regel, als op de een van de (LVD) karakters aan de 
     rechterkant, het effect is heltzelfde alsof de gebruiker heeft getypt:
     L=TAB  (Libraries),
     D=ENTER(diepere topics) 
     V=F12  (Verwijzingen), 
     U=PF1-E(Uitvoeren).

  2. Op regel 2 het effect zal een PF4 toets zijn (een nivo terug)
  3. In het tekst window (regel 3..n) het effect is het volgende:
      Linker muisknop
       a. Midden bovenaan : Scroll 1 of meer regels omhoog
       b. Midden onderaan : Scroll 1 of meer regels omlaag.
       c. Links  midden   : Scroll 1 of meer kolommen naar links
       d. Rechts midden   : Scroll 1 of meer kolommen naar rechts.
      Middelste muisknop.
       ENTER = Diepere help
      Rechtermuisknop 
       F12 = verwijzingen

4 SELECTIE_windows.

   Linker muisknop
     Als op een topic geclicked: selecteer dat topic.
     Als geclicked aan de rechterkant (kolom 78..80)
      a. Als geclicked op de bonvenste helft : Scroll 1 regel omhoog
      a. Als geclicked op de onderste  helft : Scroll 1 regel omlaag.
     Als geclicked buiten selectie window : PF4 een scherm terug.

   Middelste muisknop.

     a. Als geclicked bonven window : selectie window wordt een regel groter.
     b. Als geclicked in     window : selectie window wordt een regel kleiner.

   Rechter muisknop

    Schakel tussen horizontale en verticale display

3 Voorbeelden

 Hieronder staan twee pagina's met voorbeelden
 De eerste pagina KOP geeft een voorbeeld van een pagian met  kopregels
 De tweede pagina geeft een voorbeeld van verwijzingen.
  
4 KOP
Kopregel 1
Scroll door de regels en de kopinfo blijft op het scherm
Naam      Adres       woonplaats
!#
Jansen    Straat 12   Amsterdam
Janse1    Straat 13   Amsterdam
Janse2    Straat 14   Amsterdam
Janse3    Straat 15   Amsterdam
Janse4    Straat 16   Amsterdam
Janse5    Straat 17   Amsterdam
Janse6    Straat 18   Amsterdam
Janse7    Straat 19   Amsterdam
Piet1     Pstraat12   Den haag                  
Piet2     Pstraat15   Den haag                  
Piet3     Pstraat16   Den haag                  
Piet4     Pstraat17   Den haag                  
Piet5     Pstraat18   Den haag                  
Piet6     Pstraat19   Den haag                  
Piet7     Pstraat20   Den haag                  
Jhan1     Jweg 43     Rotterdam
Jhan2     Jweg 44     Rotterdam
Jhan3     Jweg 45     Rotterdam
Jhan4     Jweg 46     Rotterdam
Jhan5     Jweg 48     Rotterdam
Jhan6     Jweg 49     Rotterdam
Jhan7     Jweg 50     Rotterdam
Jhan8     Jweg 51     Rotterdam
Jhan9     Jweg 52     Rotterdam
4 Verwijzing

 Deze pagina beval een verwijzing naar het KOP voorbeeld en ook een naar
 de help uit HELPLIB over COPY (hiervoor moet helplib wel geladen zijn)
 Type PF1-V om deze verwijzingen te kunnen selecteren
 Hieronder staat twee teksten die 

 Als de gebruiker  /INLINE had meegegeven, dan waren de  verwijzingen 
 in de tekst pagina zichtbaar geweest en konden via een muis-click
 geselecteerd worden

![Verwijzing naar kop]fshelp neder voorbeelden kop
![verwijzing naar copy in helplib]@helplib copy

4 ACTIE

 Hieronder een voorbeeld van een uitvoer stukje
 Let op de U links bovenin het scherm

!@[Voorbeeld van uitvoeren]help12/out=q.q @'this_library' 'this_topics'|print q.q/note="'this_topic_1'"/comm="'comment'"|delete q.q;0
