******************************************************************************
*                                                                            *
*                   HDMenu, das individuelle MENSYSTEM                      *
*                              (C) 1993 by                                   *
*                                                                            *
*                  Engelhardt & Partner Systemconsulting                     *
*                           Am Schraffenberg 43                              *
*                            42799 Leichlingen                               *
*                                                                            *
*              Gesellschaft fr Software- und Netzwerkplanung                *
*                           Tel : 02175 / 1277                               *
*                           Fax : 02175 / 71247                              *
*                                                                            *
******************************************************************************


*********      Anleitung fr die Sharewareversion von HDMenu        **********
*********   Diese Sharewareversion soll/darf frei kopiert weden     **********

Inhaltsverzeichnis:

1. was leistet HDMenu?
2. Systemvoraussetzungen
3. Installation auf Festplatte
4. Erstellen einer Mensteuerdatei
5. bewegen eine Menfensters
6. Installation in einem Netzwerk
7. Unterschied zwischen Shareware- / Vollversion
8. Anwenderregistrierung



**************************
* 1. was leistet HDMenu? *
**************************

Das Program HDMenu ist eine komfortable Benutzeroberflche (SAA hnliche
Bedienung) fr PC-Arbeitsstationen. HDMenu kann ebenfalls als globales Men in
einem Netzwerk verwendet werden. HDMenu liest eine Menusteuerdatei ein, in der
die Menpunkte beschrieben und die zugehrigen Programmaufrufe enthalten sind.
Die Menpunkte knnen nun ber Hotkeys, Cursortasten oder eine angeschlossene
Maus aktiviert werden. Nach verlassen des Programmes, welches durch einen
Menpunkt aktiviert wurde, befinden Sie sich wieder im Mensystem.
Die Positionen der Menfenster knnen ber die Tastatur oder eine Maus
verndert werden, wobei die Fensterpositionen in der Mensteuerdatei
gespeichert werden.

HDMenu bentigt keinen Arbeitsspeicher nachdem ein Menpunkt aufgerufen
wurde!!!



****************************
* 2. Systemvoraussetzungen *
****************************

PC/MSDOS ab Version 3.3
512KB Hauptspeicher (oder mehr!!!)
ab Prozessor 80286



**********************************
* 3. Installation auf Festplatte *
**********************************

Um das Mensystem zu installieren sind PC/MSDOS Kenntnisse erforderlich.
(z.B. die Befehle MD, CD, COPY, DIR, EDIT sowie die Funktion/Konfiguration
der Datei "AUTOEXEC.BAT") Bitte lesen Sie in Ihrem PC/MSDOS Handbuch nach!!!

1. kopieren der bentigten Dateien in ein Verzeichnis

   Erstellen Sie ein Unterverzeichnis auf der Festplatte, und kopieren Sie
   folgende Dateien hinein:

       MENU.EXE           (Menprogramm)
       MENU.COL           (Farbdefinitionen)
       MENU.MEN           (Mensteuerdatei)
       M.BAT              (Hauptprogramm)

2. ndern der Datei "AUTOEXEC.BAT"

   Suchpfad hinzufgen (fr die Datei "M.BAT"):

   SET PATH=C:\DOS;C:\MENU;...              (C:\MENU in Suchpfad einfgen)


   Umgebungsvariable "MENUPATH" setzen:

   SET MENUPATH=C:\MENU\                    (letztes "\" nicht vergessen!!!)


   Umgebungsvariable "MENUFILE" setzen:

   SET MENUFILE=TEST.MEN                    (Mensteuerdatei)
   Die umgebungsvariable "MENUFILE" mu nur gesetzt werden, wenn die
   Mensteuerdatei NICHT "MENU.MEN" heit.

   starten des Mensystems:
   M

  ...jetzt sieht die Datei "AUTOEXEC.BAT" folgendermaen aus:

    @ECHO OFF
    CLS
    SET COMSPEC=C:\DOS\COMMAND.COM
    SET PROMPT=$P$G
    SET TEMP=C:\
    SET MENUPATH=C:\MENU\
    SET PATH=C:\DOS;C:\MENU
    CLS
    LH DOSKEY
    LH C:\MOUSE\MOUSE
    LH KEYB GR,437,C:\DOS\KEYBOARD.SYS
    M



**************************************
* 4. Erstellen einer Mensteuerdatei *
***************************************

Eine Mensteuerdatei ist eine Textdatei, die die Mendefinitionen
und Anweisungen fr das Betriebssystem beinhaltet.
Der Name der Mensteuerdatei kann beliebig gewhlt werden (wenn er NICHT
"MENU.MEN" ist, mu die Umgebungsvariable "MENUFILE" auf diesen Namen
gesetzt werden). Die Mensteuerdatei mu im gleichen Verzeichnis angelegt
werden, wo die Datei "MENU.EXE" steht. Zum erstellen der Mensteuerdatei wird
ein Texteditor bentigt z.B.: Edit.

Verwenden Sie fr Ihre ersten Versuche eine Kopie der beigefgten
Mensteuerdatei MENU.MEN.

In der Mensteuerdatei knnen bis zu 8 Programmgruppen definiert werden
(waagerechte Menpunkte).
z.B.:
    waagerechte Menpunkte: Utilities, Text, Windows...Gruppe8

    senkrechte Menpunkte: Ausfhrbare Menpunkte, die gruppenbezogene
                           Programmteile ausfhren, sowie in weitere Men-
                           ebenen verzweigen.


Definition der waagerechten Menpunkte in der Mensteuerdatei:

       Menu1     : @Utilities
       MenuHelp1 : Norton Commander / XTree / PCTools

Erklrung: In dem Men erscheint als waagerechter Menpunkt der Text
           "Utilities", und als Hilfstext in der letzten Zeile der Text
           "Norton Commander / XTree / PCTools", wenn der Menpunkt Utilities
           aktiviert ist.
           Das Zeichen nach dem Zeichen "@" ist der HotKey dieses Menpunktes.
           Zum aktivieren des Menpunktes "Utilities" mittels Hotkey, mu die
           Tastenkombination "<ALT> <u>" eingegeben werden.


...daraus folgt die Definition weiterer Gruppen:

       Menu2     : @Text
       MenuHelp2 : Word 5.0 / Wordstar

...usw!!!

Jetzt mssen noch gruppenbezogenen Mens erstellt werden.
Ein Menfenster besteht aus einer Startzeile, den Mendefinitionen, den
Betriebssystem Anweisungen und einer Endzeile. Die Definition eines
Menfensters kann irgendwo in der Mensteuerdatei stehen.

z.B. die Definition des Fensters der 1. Gruppe (Utilities):

       ; Men fr 1. Gruppe
       MenuStart1
         &Utilities
           Utils
         #@DOS Befehl ausfhren
           $Dos Befehl:
           CLS
           ECHO DOS Befehl: "$"
           $
           PAUSE
       MenuEnd1

       Utils
         #@Norton Commander
           ?0815
           NC
         #@XTree
           XTG
         #@Compress
           F:
           CD F:\PCT
           COMPRESS
       MenuEnd
       ; Menende fr 1. Gruppe

Erklrung: MenuStart1 / MenuEnd1 bilden die  Start- / Endzeile des 1.Mens,
           dazwischen stehen die Mendefinitionen und Betriebssystem
           Anweisungen.

           Gltige Mendefinitionen: & -> neues Menfenster ffnen
                                          (Untermen). Es sind ebenso
                                          Unter Unter... Mens erlaubt.

                                     # -> Menauswahl, bei Anwahl werden die
                                          nachstehenden Anweisungen
                                          ausgefhrt (Programmwahl).

                                     $ -> Befehlszeile einlesen
                                          Das Zeichen "$" wird nach dem
                                          einlesen durch die Befehlszeile
                                          ersetzt.

                                     ? -> Passworteingabe
                                          nachfolgende Anweisungen werden nur
                                          bei Eingabe des richtigen Passwortes
                                          ausgefhrt.

                                     ; -> Remark, ist ein Semikolon das erste
                                          Zeichen einer Zeile, so wird diese
                                          Zeile ignoriert.

                                     @ -> HotKey s.o.

In HDMenu ist auch ein Bildschirmschoner integriert, dessen Aktivierungszeit
in der Mensteuerdatei eingestellt werden kann.
Eintrag in der Mensteuerdatei:

       ScreenSaveTime : 120

(Die Aktivierungszeit wird in Sekunden angegeben)


...und zum Schlu noch eine Mensteuerdatei, die Sie als Beispiel verwenden
knnen:

; ******************************************
; ***      18.03.1993 Dirk Engelhardt    ***
; ***  Konfigurationsdatei fr MENU.EXE  ***
; ******************************************
;----------------------------------------------------------------------------
; ACHTUNG!!!
; Die Umgebungsvariable MENUPATH mu auf den Pfad
; von MENU.EXE gesetzt werden
; z.B. SET MENUPATH=C:\MENU\
;----------------------------------------------------------------------------
; ACHTUNG!!!
; Die Umgebungsvariable MENUFILE mu auf den Namen der Menudatei
; gesetzt werden, wenn dieser nicht MENU.MEN ist.
; z.B. SET MENUFILE=DUMMY.MEN
;----------------------------------------------------------------------------
; ACHTUNG!!!
; Bei Netzwerkbetrieb mu die Umgebungsvariable
; MENUUSER an jeder Arbeitsstaion unterschiedlich
; gesetzt werden
; z.B. SET MENUUSER=1
; (es sind Werte zwischen 1 und 999 erlaubt)
;----------------------------------------------------------------------------
; Sekunden bis zum Start des Bilschirmschoners (1..99999 Sekunden)
ScreenSaveTime               : 120
;----------------------------------------------------------------------------
; Namen der MenuEintrge (maximal 8 Eintrge, 18 Zeichen)
Menu1                        : @Sprachen
Menu2                        : @DaTec
Menu3                        : @Utilities
Menu4                        : D@F
Menu5                        : @Novell
Menu6                        : @Windows
Menu7                        :
Menu8                        :
;----------------------------------------------------------------------------
; Namen der MenuHelpEintrge (maximal 8 Eintrge, 48 Zeichen)
MenuHelp1                    : Turbo/Borland Pascal, Turbo-C
MenuHelp2                    : Fibu, Adressen, Auftrag
MenuHelp3                    : Utilities
MenuHelp4                    : DF-Programme
MenuHelp5                    : Novell Netware-Lite
MenuHelp6                    : Windows-Programme
MenuHelp7                    :
MenuHelp8                    :
;----------------------------------------------------------------------------
; # -> Start Menu
; & -> neues Untermenu
; @ -> Hotkey
;----------------------------------------------------------------------------
MenuStart1 [7,3]
  &@Pascal 7.0
    Pascal
  #Turbo @C++ 1.01
    c:
    cd c:\tc\work
    tc
MenuEnd
Pascal [24,6]
  #@Turbo Pascal 7.0
    e:
    cd e:\work
    turbo
  #@Borland Pascal 7.0
    e:
    cd e:\work
    bp
MenuEnd
;----------------------------------------------------------------------------
MenuStart2 [17,3]
  #@Datei 4.5N
    d:
    cd d:\datec\datei45n
    datei45n
    call touchdir
  &@FiBu 1.0 1991 bis 1993
    FiBu
  #@Auftrag
    d:
    cd d:\datec\auftrag
    auftrag
    call touchdir
  #@Postleitzahlen
    d:
    cd d:\datec\plz
    plz
MenuEnd
FiBu [44,7]
  ?4711
  #FiBu 1.0 199@1
    d:
    cd d:\datec\fibu91
    fibu10
    call touchdir
  #FiBu 1.0 199@2
    d:
    cd d:\datec\fibu92
    fibu10
    call touchdir
  #FiBu 1.0 199@3
    d:
    cd d:\datec\fibu93
    fibu10
    call touchdir
MenuEnd
;----------------------------------------------------------------------------
MenuStart3 [24,3]
  #@XTreeGold 2.5
    $Laufwerk:
    XTGOLD $
  #@Norton Commander
    NC
  #@PC Compress 7.1
    D:
    CD D:\PCT
    COMPRESS
  #Disk@Form 1.5
    DISKFORM
  #EZ @Tape 3.1
    c:
    cd c:\eztape
    eztape
  #Fast@Lynx 1.0
    C:
    CD C:\FAST
    FX
  #Video @Ein
    call tvon
  #Video @Aus
    call tvoff
  #@QCopy Pro 1.5
    C:
    CD C:\QCOPYPRO
    QCOPYPRO
  #@DOS Befehl ausfhren
    $DOS Befehl:
    cls
    echo DOS Befehl: "$"
    $
    pause
 MenuEnd
;----------------------------------------------------------------------------
MenuStart4 [35,3]
  #Teli@x 3.21
    d:
    cd d:\telix
    telix
    call touchdir
  #@Term 1.2
    $Baudrate:
    c:
    cd c:\
    term $ n com2 3
  #Compu@Serve
    c:
    cd c:\cserve
    cim
    call touchdir
  #@Carbon Copy (CCHelp)
    c:
    cd c:\cc1
    cchelp
MenuEnd
;----------------------------------------------------------------------------
MenuStart5 [40,3]
  #@Netware Printer Capture
    call printin
  #Netware @Printer Logout
    call out
  #@TCPIP Protokoll laden
    call tcp_ip
  #NW@Lite V1.1 Utilities
    c:
    cd c:\nwlite
    NET
  #Start NWLite (@Client)
    c:
    cd c:\nwlite
    call NWCLIENT
  #Start NWLite (@Server)
    c:
    cd c:\nwlite
    call NWSERVER
 MenuEnd
;----------------------------------------------------------------------------
MenuStart6 [48,3]
  #@Windows 3.1
    c:
    cd c:\windows
    win
MenuEnd
;----------------------------------------------------------------------------
MenuStart7
MenuEnd
;----------------------------------------------------------------------------
MenuStart8
MenuEnd
;----------------------------------------------------------------------------
; ********************************
; *** Konfigurationsdatei Ende ***
; ********************************



*********************************
* 5. bewegen eines Menfensters *
*********************************

Ein Menfenster kann mit der Maus (anklicken der 1. Fensterzeile) oder
mit der Tastatur (SHIFT-Cursortasten) verschoben werden. Die vernderten
Positionen werden in der Mensteuerdatei gespeichert.

In der Mensteuerdatei stehen in den eckigen Klammern die Positionen der
Menfenster. Diese Positionen brauchen Sie NICHT einzugeben, sie werden
automatisch vom Programm erzeugt, und beim verschieben eines Fensters
erneut gespeichert.



*************************************
* 6. Installation in einem Netzwerk *
*************************************

Istallieren Sie das Mensystem in einem Verzeichnis auf dem Server wie
in Punkt 3 beschrieben. Das Mensystem jann nun von jedem User verwendet
werden. Damit das Mensystem weis auf welcher Arbeitsstation das Men
aktiviert wurde, mu fr jede Arbeitsstation eine Nummer vergeben werden.
Diese Nummer mu mit der Umgebungsvariable "MENUUSER" gesetzt werden.

ACHTUNG!!! die vergebene Nummer mu im Netzwerk EINMALIG sein!!!
           (es sind Werte zwischen 1 und 999 erlaubt)

Vergeben Sie diese Nummer am einfachsten in der Datei "AUTOEXEC.BAT"

z.B.: SET MENUUSER=1

    Hinweis:
    ...nur fr Novell Netware ab Version 2.x
    Die Nummer kann auch im System-Login-Script vergeben werden.

    z.B.: DOS SET MENUUSER=STATION


****************************************************
* 7. Unterschied zwischen Shareware- / Vollversion *
****************************************************

Es gibt KEINEN funktionellen Unterschied zwischen der Shareware- /
Vollversion.



****************************
* 8. Anwenderregistrierung *
****************************

Wenn Sie nach einem Test weiterhin vorhaben das Programm HDMenu
zu verwenden, so lassen Sie sich als Anwender registrieren.
Als registrierter Anwender erhalten Sie die neuste Version von HDMenu
ohne den Shareware Hinweis.

Durch die Registrierung knnen Sie unseren telefonischen Support
bezglich des registrierten Produktes in Anspruch nehmen.
(Telefon: 02175/1277, FAX: 02175/71247)

Drucken Sie das Bestellformular aus z.B.:

       type bestell.txt > prn

Sie erhalten ein leeres Bestellformular. Schicken, oder faxen Sie uns das
ausgefllte Formular zu.

Dirk Engelhardt, Januar 1994

ps.: bei Fragen und Verbesserungsvorschlgen rufen Sie uns doch einfach mal an
     oder faxen Sie uns Ihre Mitteilung.

     Sollten Sie an individuellen Softwarelsungen interessiert sein, so sind
     wir gerne bereit fr Sie geeignete Lsungen zu entwickeln.
