home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d7xx / d743 / frequest.lha / FRequest / FRequest.dok < prev    next >
Text File  |  1992-10-11  |  11KB  |  303 lines
  1.  
  2.  
  3.  
  4.  
  5.                       Dokumentation zu FRequest Version 1.5
  6.  
  7.  
  8.                              geschrieben 1992
  9.  
  10.  
  11.                          von H.P.G  FREEWARE
  12.  
  13.  
  14. Überblick:
  15.  
  16.  
  17.         FRequest  läuft  nur  unter  OS  2.xx  Version  größer  als  36.
  18.  
  19.         FR ist ein Tool, mit dem man eine Datei oder ein Verzeichnis mit
  20.         dem neuen OS 2.xx ASLFileRequester auswählen kann, und dann eine
  21.         CLi-Kommandozeile mit der Selektion ausführen kann.
  22.  
  23.         FRequest benutzt viele OS 2.xx Features,  daher  ist  es  leider
  24.         unter 1.3 und 1.2 nicht lauffähig.
  25.  
  26.         Der Requester kann in vielen Wegen vom Benutzer definiert werden.
  27.         Alle Texte, die Auswahl, das PatternGadget und viel mehr kann vom
  28.         Benutzer modifiziert werden.
  29.         Wird eine dieser Optionen nicht genutzt, benutzt FR seine Vorein-
  30.         gestellten Werte.
  31.  
  32.         FR macht es möglich eine angegebene  Kommandozeile  zu  starten,
  33.         genauso wie man sie im Cli-Fenster eingeben würde. Wird  in  der
  34.         Kommandozeile dann ein '[]'  eingegeben,  wird  '[]'  durch  die
  35.         Auswahl ersetzt.
  36.         Falls keine Selektion erfolgte, passiert nichts.
  37.  
  38.         FR kann auch benutzt werden,  um  Programme  ohne  PARAMETER  zu
  39.         starten.
  40.  
  41.  
  42. ----------------
  43.  
  44. Rechtliches:
  45.  
  46.  
  47.         Ich habe mich entschlossen dieses Programm und alle  beigefügten
  48.         Dateien und Scripts, sowie aller  Anleitungen  als  FREEWARE  zu
  49.         deklarieren.
  50.  
  51.         D.h.:
  52.  
  53.             Jeder kann FRequest benutzen.
  54.             Jeder darf FRequest weitergeben, wenn:
  55.  
  56.                 1. alle unten aufgeführten Programme mit weitergegeben
  57.                    werden,
  58.  
  59.                 2. keinerlei Veränderungen unten aufgeführten Programmen
  60.                    vorgenommen wurden,
  61.  
  62.                 3. bei   Nachkompilierungen  der  Quell-Codes  muß   ein
  63.                    Hinweis auf den Orginal-Programmierer vorhanden sein,
  64.                    bei Herausgabe dieser, muß eine Kopie an mich gesandt
  65.                    werden.
  66.  
  67.                 4. FRequest darf nicht verkauft werden.
  68.  
  69.                        Außnahme: Es darf eine geringe  Kopiergebühr  er-
  70.                                  hoben werden, die aber 5  DM  bzw.  den
  71.                                  entsprechenden  Gegenwert  in   anderen
  72.                                  Währungen nicht übersteigt.
  73.  
  74.                 5.  FRequest  darf  nur  als  Teil  eines  kommerziellen
  75.                    Produktes herrausgegeben werden,  mit  ausdrücklicher
  76.                    schriftlicher Genehmigung des Autors
  77.                    (Adresse siehe unten).
  78.  
  79.                 Zuwiderhandlungen  der  oben  Aufgeführten   Konditionen
  80.                 werden zivilrechtlich verfolgt.
  81.  
  82.  
  83.         Ferner wird für die Funktion  des  Programmes  ,sowie  möglicher
  84.         Folgen der Benutzung des Programmes sowie  der  u.  a.  Dateien,
  85.         keinerlei Gewährleistung übernommen.
  86.  
  87.         !!! Alle Risiken trägt der Benutzer allein !!!
  88.  
  89. ----------------
  90.  
  91. TECHNICAL:
  92.  
  93.             FR ist mit dem MANX Aztec C Kompiler Version 5.0d  kompilert
  94.             worden. Die Größe von FR ist ziehmlich klein ( im  Gegensatz
  95.             zu manch anderen ähnlichen Programmen).
  96.             Das ist darauf zurückzuführen, daß ich viele  System-Library
  97.             Calls an Stelle von C-Library Calls benutzt habe.
  98.  
  99.  
  100. FEATURES:
  101.  
  102.             Man kann das Verzeichnis angeben, daß FR beim Öffnen anzeigt.
  103.  
  104.             Man kann die Datei angeben, die beim Öffnen im  Datei-Gadget
  105.             von FR steht. Wenn man sie nicht angibt,  bleibt  das  Datei
  106.             Gadget leer.
  107.  
  108.             Man kann Pattern (AmigaDOS Standart) angeben, die im Pattern
  109.             Gadget erscheinen angeben. Wenn man sie nicht  angibt,  wird
  110.             '#?' benutzt.
  111.  
  112.             Man kann den GadgetText des positiven und negativen  Gadgets
  113.             angeben. Die Voreingestellten Werte sind: 'OKAY' und 'CANCEL'.
  114.  
  115.             Man kann einen Titel  für  das  Fenster  des  FileRequesters
  116.             angeben. Der Voreingestellte Wert ist:
  117.             'Bitte Datei auswählen'.
  118.  
  119.             Man kann eine Kommandozeile angeben, bei der  '[]'  mit  der
  120.             Selektion ersetzt werde. Werden keiene '[]' angegeben,  wird
  121.             die Auswahl einfach an das Ende der Kommandozeile angehängt.
  122.             Wird keine Kommandozeile angegeben, wird die Auswahl einfach
  123.             zum Cli-Fenster geschickt.
  124.  
  125.             Man kann FR  auch  zum  Start  von  CLI_Kommandos  benutzen.
  126.  
  127.             Wenn man die QUIET-Option benutzt,  wird  keine  Information
  128.             über die Auswahl zum Fenster geschickt. Dies  ist  besonders
  129.             für BatchScripts nützlich.
  130.  
  131.  
  132. ----------------
  133.  
  134.  
  135. START und
  136. PARAMETER:
  137.  
  138.             FR hat die folgende CLI SYNTAX:
  139.  
  140. Syntax:  Frequest [HAIL/K][OK/K][CANCEL/K][DIR/K][FILE/K][PAT/K][QUIET/S]
  141.                   [EXE/S|COM/K]
  142.  
  143.  
  144. Erklärung:
  145.  
  146.  
  147.     HAIL:    Zeichenkette   wird HAIL  gefolgt  von  einer  Zeichenkette
  148.                             angegeben, wird diese in die Titelzeile  des
  149.                             Requesters kopiert. Der Voreingestellte Wert:
  150.                             'Bitte eiene Datei auswählen'.
  151.  
  152.     OK:      Zeichenkette   wird OK gefolgt von einer  Zeichenkette  an-
  153.                             gegeben, wird die Zeichenkette als Text  für
  154.                             das positive Gadget benutzt.  Voreingestellt
  155.                             ist: 'OKAY'.
  156.  
  157.     CANCEL:  Zeichenkette   wird CANCEL gefolgt von  einer  Zeichenkette
  158.                             angegeben, wird diese als Text für  das  ne-
  159.                             gative   Gadget   benutzt.   Voreinstellung:
  160.                             'CANCEL'.
  161.  
  162.     DIR:     Zeichenkette   wird DIR gefolgt von einer Zeichenkette  an-
  163.                             gegeben, so wird diese als  Verzeichnis  be-
  164.                             nutzt, daß der Requester beim Start anzeigt.
  165.                             Voreinstellung:  das  momentane  Verzeichnis
  166.  
  167.     FILE:    Zeichenkette   wird FILE gefolgt von einer Zeichenkette an-
  168.                             gegeben, wird diese in das Datei-Gadget  ko-
  169.                             piert. Wird FILE nicht angegeben, bleibt das
  170.                             FILE-Gadget leer.
  171.  
  172.     PAT:     Zeichenkette   wird PAT gefolgt von einer Zeichenkette  an-
  173.                             gegeben, wird diese  in  das  Pattern-Gadget
  174.                             des Requesters kopiert. FRequest zeigt  dann
  175.                             nur Dateien an, die dem PATTERN-Muster  ent-
  176.                             sprechen. Voreingestellt ist: '#?'
  177.  
  178.     QUIET:   ------------   Dies ist ein Schalter.
  179.                             Ohne Angabe von QUIET, zeigt FR die  Komman-
  180.                             dozeile im Cli-Fenster an, bevor er sie aus-
  181.                             führt. Mit QUIET wird dies verhindert.  Dies
  182.                             ist besonders bei BatchScripts nützlich.
  183.  
  184.     EXE:     ------------   Dies ist ebenfalls ein Schalter. Wird  weder
  185.                             COM  noch  EXE  angegeben,  (  siehe  weiter
  186.                             unten ) dann zeigt FRequest nur die Selektion
  187.                             an, ohne etwas auszuführen. Wird EXE angege-
  188.                             ben, führt FR die Auswahl ohne PARAMETER als
  189.                             CLI-Kommando aus.
  190.  
  191.     COM:     Zeichenkette   wird COM gefolgt von einer Zeichenkette  an-
  192.                             gegeben, wird diese als Kommandozeile benutzt.
  193.                             Alle '[]' in dieser Kommandozeile werden mit
  194.                             der Auswahl ersetzt. Werden keine '[]' ange-
  195.                             geben, wird die Auswahl an die Kommandozeile
  196.                             angehängt.
  197.  
  198.     Anderes: Wird der FileRequester abgebrochen, passiert  nichts,  d.h.
  199.              es erfolgt weder eine Ausgabe noch  wird  irgendetwas  aus-
  200.              geführt. Will man nur die Einstellungen testen,  dann  kann
  201.              man FR einfach  ohne  Angabe  von  EXE  und  COM  aufrufen.
  202.  
  203.              Man kann COM und EXE nicht zugleich angeben. Wird dies  ge-
  204.              macht, gibt FR einen kleinen Hilfstext aus. Dies  geschieht
  205.              ebenfalls, wenn Falsche Angaben gemacht werden.
  206.  
  207.  
  208. INSTALLATION:
  209.  
  210.              Einfachst. Nur FRequest ins C: oder irgend ein anderes Ver-
  211.              zeichnis im aktuellen Suchpfad kopieren.
  212.  
  213.  
  214. ----------------
  215.  
  216.  
  217. TUTORIAL:
  218.                 1. das ist das einfachste Beispiel, wie man FR aufrufen
  219.                    kann
  220.  
  221.     SHELL 1.> FRequest
  222.  
  223.                 -   FR öffnet  einen  Requester  mit  dem  Titel  'Bitte
  224.                     eine  Datei  auswählen'  und  zeigt  das   momentane
  225.                     Verzeichnis an.  Die  GadgetTexte  sind  'OKAY'  für
  226.                     das  positive  und   'CANCEL'   für   das   negative
  227.                     Gadget.  Wird  eine  Auswahl  gemacht,  wird   diese
  228.                     im Cli-Fenster ausgegeben.
  229.  
  230.                 2. Benutzen von FR in einem alias, um  das  FONTS:  Ver-
  231.                    zeichnis zu wechseln:
  232.  
  233.     SHELL 1.> alias FAss FRequest HAIL "Bitte neues Fonts: Verz wählen"
  234.                 OK "ASSIGN" CANCEL "STOP" COM "assign fonts:"  <return>
  235.  
  236.                 Wird nun FAss aufgerufen,
  237.  
  238.                 SHELL 1.> FAss
  239.  
  240.                 öffnet FR den  Requester  mit  dem  Titel  'Bitte  neues
  241.                 Fonts:  Verz  wählen'  und  zeigt  den  Inhalt  der  mo-
  242.                 mentanen  Verzeichnisses  an.   Die   GadgetTexte   sind
  243.                 nun 'ASSIGN' und  'STOP'.  Wird  eine  Auswahl  gemacht,
  244.                 wird diese mittels der Kommandozeile
  245.  
  246.                     'assign fonts: <Auswahl>'
  247.  
  248.                 als Cli-Kommando ausgeführt.
  249.  
  250.                 3. Nun ein Beispiel, bei dem fast alle  Angaben  benutzt
  251.                    wurden, die bei FR benutzt werden können.
  252.                    Dies ist ein Beispiel  für  den  Einsatz  von  FR  in
  253.                    einem BatchScript. Dieses Script kopiert  eine  Datei
  254.                    in ein anderes Verzeichnis.
  255.  
  256.                 .key Quelle
  257.                 .ket {
  258.                 .bra }
  259.  
  260.                 ; Quelle ist die QuellVerzeichnis, von dem eine Datei
  261.                 ; kopiert werden soll
  262.  
  263.                 set Ziel `FRequest HAIL "Bitte Ziel Verz auswählen'
  264.                          OK "In Ornung" CANCEL "Abbruch" PAT "#?" DIR sys:`
  265.  
  266.                 if $Ziel EQ ""
  267.                     quit 0
  268.                 endif
  269.  
  270.                 FRequest HAIL "Welche Datei soll ich kopieren ?"
  271.                          OK "Kopiere" PAT "#?.(c.h)" DIR {Quelle}
  272.                          COM "copy {Quelle}/[] to $Ziel"
  273.  
  274.                 quit 0
  275.  
  276.  
  277. ------------
  278.  
  279. Grüße etc.:
  280.  
  281.                 Hans-Peter Guenther
  282.                 Gruener Weg 5
  283.                 W-3501 Fuldatal 2
  284.                 B.R.D (Germany)
  285.  
  286.  
  287. Liste der Dateien:
  288.  
  289. (Fehlt eine der folgenden Dateien, ist diese Veröffentlichung inkomplett)
  290.  
  291. FRequest            : Das englische Programm
  292. FRequest.info
  293. FRequest_D          : Das deutsche Programm
  294. FRequest_D.info
  295. FRequest.doc        : Die englische Anleitung
  296. FRequest.doc.info
  297. FRequest.dok        : Die deutsche Anleitung
  298. FRequest.dok.info
  299.  
  300.  
  301. *******************************************************************************************
  302.  
  303.