home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d08xx / d0827.lha / FRequest / FRequest.dok < prev    next >
Text File  |  2001-02-25  |  14KB  |  370 lines
  1.  
  2.  
  3.  
  4.  
  5.                       Dokumentation zu FRequest Version 1.55
  6.  
  7.  
  8.                              geschrieben 1993
  9.  
  10.  
  11.                          « 1992/93 H.P.G  FREEWARE
  12.  
  13.  
  14. Index:
  15.  
  16.     ▄berblick
  17.     ─nderungen
  18.     Geschichte
  19.     Rechtliches
  20.     Leistungsmerkmale
  21.     Start Parameter
  22.     Installation
  23.     Beispiele
  24.     Technisches
  25.     Adresse
  26.     Liste der Dateien
  27.  
  28. ▄berblick:
  29.  
  30.  
  31.         FRequest  lΣuft  nur  unter  OS  2.xx  Versionen gr÷▀er als  36.
  32.  
  33.         FR ist ein Tool, mit dem man eine Datei oder ein Verzeichnis mit
  34.         dem neuen OS 2.xx ASLFileRequester auswΣhlen kann, und dann eine
  35.         CLi-Kommandozeile mit der Selektion ausfⁿhren kann.
  36.  
  37.         FRequest benutzt viele OS 2.xx Features,  daher  ist  es  leider
  38.         unter 1.3 und 1.2 nicht lauffΣhig.
  39.  
  40.         Der Requester kann in vielen Wegen vom Benutzer definiert werden.
  41.         Alle Texte, die Auswahl, das PatternGadget und viel mehr kann vom
  42.         Benutzer modifiziert werden.
  43.         Wird eine dieser Optionen nicht genutzt, benutzt FR seine vorein-
  44.         gestellten Werte.
  45.  
  46.         FR macht es m÷glich, eine angegebene  Kommandozeile  zu starten,
  47.         genauso wie man sie im Cli-Fenster eingeben wⁿrde. Wird  in  der
  48.         Kommandozeile dann ein '[]'  eingegeben,  wird  '[]'  durch  die
  49.         Auswahl ersetzt.
  50.         Falls keine Selektion erfolgte, passiert nichts.
  51.  
  52.         FR kann auch benutzt werden,  um  Programme  ohne  PARAMETER  zu
  53.         starten.
  54.  
  55.  
  56.  
  57.  
  58. ─nderungen:
  59.  
  60.              von Version 1.5 zu 1.55:
  61.  
  62.                     Die deutsche Version ist jetzt komplett in deutsch gefa▀t.
  63.                     Also auch die Kommandozeilenparameter.
  64.  
  65.                     Ich habe drei neue Kommandozeilenparameter hinzugefⁿgt:
  66.  
  67.                     Hoehe=H/K/N   gibt die H÷he des Filerequesters an.
  68.  
  69.                     MULTI=U/S     erm÷glicht mehrere Dateien auf einmal auszu-
  70.                                   wΣhlen.
  71.  
  72.                     Speichern=S/S startet den Filerequester mit anderen Farben
  73.                                   und schaltet die Doppelklickauswahl ab.
  74.  
  75.                     Au▀erdem habe ich einige Enforcer Hits entfernt. Erst jetzt,
  76.                     weil ich einen neuen A4000 bekommen habe und eine Version von
  77.                     Enforcer, die auch damit lΣuft.
  78.  
  79. Geschichte:
  80.  
  81.     Version 1.5     Erste allgemeine Ver÷ffentlichung.
  82.  
  83.     Version 1.51    Einige Enforcer Hits entfernt.
  84.  
  85.     Version 1.52    Neuer Speichern Parameter eingefⁿgt. Einige Enforcer Hits
  86.                     entfernt.
  87.  
  88.     Version 1.53    Neuer MULTI Parameter eingefⁿgt. Au▀erdem die M÷glichkeit
  89.                     die H÷he des Filerequesters anzugeben.
  90.  
  91.     Version 1.55    Einige Enforcer Hits und Fehler entfernt..
  92.                     Zweite allgemeine Ver÷ffentlichung.
  93.  
  94.  
  95. Rechtliches:
  96.  
  97.  
  98.         Ich habe mich entschlossen dieses Programm und alle  beigefⁿgten
  99.         Dateien und Scripts, sowie aller  Anleitungen  als  FREEWARE  zu
  100.         deklarieren.
  101.  
  102.         D.h.:
  103.  
  104.             Jeder kann FRequest benutzen.
  105.             Jeder darf FRequest weitergeben, wenn:
  106.  
  107.                 1. alle unten aufgefⁿhrten Programme mit weitergegeben
  108.                    werden,
  109.  
  110.                 2. keinerlei VerΣnderungen unten aufgefⁿhrten Programmen
  111.                    vorgenommen wurden,
  112.  
  113.                 3. bei   Nachkompilierungen  der  Quell-Codes  mu▀   ein
  114.                    Hinweis auf den Orginal-Programmierer vorhanden sein,
  115.                    bei Herausgabe dieser, mu▀ eine Kopie an mich gesandt
  116.                    werden.
  117.  
  118.                 4. FRequest darf nicht verkauft werden.
  119.  
  120.                        Au▀nahme: Es darf eine geringe  Kopiergebⁿhr  er-
  121.                                  hoben werden, die aber 5  DM  bzw.  den
  122.                                  entsprechenden  Gegenwert  in   anderen
  123.                                  WΣhrungen nicht ⁿbersteigt.
  124.  
  125.                 5.  FRequest  darf  nur  als  Teil  eines  kommerziellen
  126.                    Produktes herrausgegeben werden,  mit  ausdrⁿcklicher
  127.                    schriftlicher Genehmigung des Autors
  128.                    (Adresse siehe unten).
  129.  
  130.                 Zuwiderhandlungen  der  oben  Aufgefⁿhrten   Konditionen
  131.                 werden zivilrechtlich verfolgt.
  132.  
  133.  
  134.         Ferner wird fⁿr die Funktion  des  Programmes  ,sowie  m÷glicher
  135.         Folgen der Benutzung des Programmes sowie  der  u.  a.  Dateien,
  136.         keinerlei GewΣhrleistung ⁿbernommen.
  137.  
  138.         !!! Alle Risiken trΣgt der Benutzer allein !!!
  139.  
  140.  
  141.  
  142. Leistungsmerkmale:
  143.  
  144.             Man kann das Verzeichnis angeben, da▀ FR beim ╓ffnen anzeigt.
  145.  
  146.             Man kann die Datei angeben, die beim ╓ffnen im  Datei-Gadget
  147.             von FR steht. Wenn man sie nicht angibt,  bleibt  das  Datei
  148.             Gadget leer.
  149.  
  150.             Man kann Pattern (AmigaDOS Standart) angeben, die im Pattern
  151.             Gadget erscheinen angeben. Wenn man sie nicht  angibt,  wird
  152.             '#?' benutzt.
  153.  
  154.             Man kann den GadgetText des positiven und negativen  Gadgets
  155.             angeben. Die Voreingestellten Werte sind: 'OKAY' und 'CANCEL'.
  156.  
  157.             Man kann die H÷he des FileRequesters angeben.
  158.  
  159.             Man kann FRequest mit der MULTI Option starten. Dies erm÷glicht
  160.             die Auswahl mehrerer Dateien zur gleichen Zeit, indem man die
  161.             Shift-Taste gedrⁿckt hΣlt und die Dateien mit der linken Maus-
  162.             taste anklickt. Die Auswahl wird dann mit Doppelklick auf den
  163.             letzten Dateinamen beendet.
  164.  
  165.             Man kann die Speichern Option benutzen. Dies ÷ffnet den File-
  166.             requester mit anderen Farben. Die Doppelklickauswahl ist dabei
  167.             aus Sicherheitsgrⁿnden abgeschaltet.
  168.  
  169.  
  170.             Man kann einen Titel  fⁿr  das  Fenster  des  FileRequesters
  171.             angeben. Der Voreingestellte Wert ist:
  172.             'Bitte Datei auswΣhlen'.
  173.  
  174.             Man kann eine Kommandozeile angeben, bei der  '[]'  mit  der
  175.             Selektion ersetzt werde. Werden keiene '[]' angegeben,  wird
  176.             die Auswahl einfach an das Ende der Kommandozeile angehΣngt.
  177.             Wird keine Kommandozeile angegeben, wird die Auswahl einfach
  178.             zum Cli-Fenster geschickt.
  179.  
  180.             Man kann FR  auch  zum  Start  von  CLI_Kommandos  benutzen.
  181.  
  182.             Wenn man die QUIET-Option benutzt,  wird  keine  Information
  183.             ⁿber die Auswahl zum Fenster geschickt. Dies  ist  besonders
  184.             fⁿr BatchScripts nⁿtzlich.
  185.  
  186.  
  187.  
  188.  
  189.  
  190. Start Parameter:
  191.  
  192.             FR hat die folgende CLI SYNTAX:
  193.  
  194.     Syntax:  Frequest [Titel=T/K][Ok=O/K][Abbruch=A/K][Verz=V/K][Datei=D/K]
  195.                       [Muster=M/K][Hoehe=H/K/N][Speichern=S/S][MULTI=U/S]
  196.                       [QUIET=Q/S][EXE/S][COM/K]
  197.  
  198.     ErklΣrung:
  199.  
  200.  
  201.     TITEL:   Zeichenkette   wird TITEL  gefolgt  von  einer  Zeichenkette
  202.                             angegeben, wird diese in die Titelzeile  des
  203.                             Requesters kopiert. Der Voreingestellte Wert:
  204.                             'Bitte eine Datei auswΣhlen'.
  205.  
  206.     OK:      Zeichenkette   wird OK gefolgt von einer  Zeichenkette  an-
  207.                             gegeben, wird die Zeichenkette als Text  fⁿr
  208.                             das positive Gadget benutzt.  Voreingestellt
  209.                             ist: 'OKAY'.
  210.  
  211.     ABBRUCH: Zeichenkette   wird Abbruch gefolgt von einer Zeichenkette
  212.                             angegeben, wird diese als Text fⁿr  das  ne-
  213.                             gative   Gadget   benutzt.   Voreinstellung:
  214.                             'ABBRUCH'.
  215.  
  216.     VERZ:    Zeichenkette   wird VERZ gefolgt von einer Zeichenkette an-
  217.                             gegeben, so wird diese als  Verzeichnis  be-
  218.                             nutzt, da▀ der Requester beim Start anzeigt.
  219.                             Voreinstellung: das  momentane  Verzeichnis.
  220.  
  221.     DATEI:   Zeichenkette   wird DATEI gefolgt von einer Zeichenkette an-
  222.                             gegeben, wird diese in das Datei-Gadget  ko-
  223.                             piert. Wird DATEI nicht angegeben, bleibt das
  224.                             Datei-Gadget leer.
  225.  
  226.     MUSTER:  Zeichenkette   wird MUSTER gefolgt von einer Zeichenkette an-
  227.                             gegeben, wird diese  in  das  Muster-Gadget
  228.                             des Requesters kopiert. FRequest zeigt  dann
  229.                             nur Dateien an, die dem MUSTER-Muster  ent-
  230.                             sprechen. Voreingestellt ist: '#?'
  231.  
  232.     HOEHE:   Zahl           wird HOEHE gefolgt von einer Zahl angegeben, wird
  233.                             versucht den Filerequester mit der H÷he in Pixels
  234.                             zu ÷ffnen.
  235.  
  236.     SPEICHERN  ----------   Wird dieser Schalter angegeben, ÷ffnet sich der
  237.                             Filerequester mit anderen Farben. Die Doppelklick-
  238.                             auswahl ist abgeschaltet. Diese Option sollte fⁿr
  239.                             Speicheroperationen verwendet werden.
  240.  
  241.     MULTI:   ------------   Wird dieser Schalter angegeben, startet der File-
  242.                             requester im Multimode. Man kann jetzt mehrere
  243.                             Dateien auf einmal auswΣhlen, indem man die Shift-
  244.                             Taste gedrⁿckt hΣlt und die Dateien mit der linken
  245.                             Maustaste anklickt. Der FileRequester wird mittels
  246.                             Doppelklick auf die letze Auswahl beendet.
  247.  
  248.  
  249.     QUIET:   ------------   Dies ist ein Schalter.
  250.                             Ohne Angabe von QUIET, zeigt FR die  Komman-
  251.                             dozeile im Cli-Fenster an, bevor er sie aus-
  252.                             fⁿhrt. Mit QUIET wird dies verhindert.  Dies
  253.                             ist besonders bei Batch Scripts nⁿtzlich.
  254.  
  255.     EXE:     ------------   Dies ist ebenfalls ein Schalter. Wird  weder
  256.                             COM  noch  EXE  angegeben,  (  siehe  weiter
  257.                             unten ) dann zeigt FRequest nur die Selektion
  258.                             an, ohne etwas auszufⁿhren. Wird EXE angege-
  259.                             ben, fⁿhrt FR die Auswahl ohne PARAMETER als
  260.                             CLI-Kommando aus.
  261.  
  262.     COM:     Zeichenkette   wird COM gefolgt von einer Zeichenkette  an-
  263.                             gegeben, wird diese als Kommandozeile benutzt.
  264.                             Alle '[]' in dieser Kommandozeile werden mit
  265.                             der Auswahl ersetzt. Werden keine '[]' ange-
  266.                             geben, wird die Auswahl an die Kommandozeile
  267.                             angehΣngt.
  268.  
  269.     Anderes: Wird der FileRequester abgebrochen, passiert  nichts,  d.h.
  270.              es erfolgt weder eine Ausgabe noch  wird  irgendetwas  aus-
  271.              gefⁿhrt. Will man nur die Einstellungen testen,  dann  kann
  272.              man FR einfach  ohne  Angabe  von  EXE  und  COM  aufrufen.
  273.  
  274.              Man kann COM und EXE nicht zugleich angeben. Wird dies  ge-
  275.              macht, gibt FR einen kleinen Hilfstext aus. Dies  geschieht
  276.              ebenfalls, wenn Falsche Angaben gemacht werden.
  277.  
  278.  
  279. Installation:
  280.  
  281.              Einfachst. Nur FRequest ins C: oder irgend ein anderes Ver-
  282.              zeichnis im aktuellen Suchpfad kopieren.
  283.  
  284.  
  285. Beispiele:
  286.  
  287.                 Ich gehe bei diesen Beispielen davon aus, da▀ die deutsche
  288.                 Version unter dem Namen FRequest im Pfad der Shell vorhanden
  289.                 ist. Bei Σlteren Versionen von FRequest war die deutsche und
  290.                 die englische Version von den Kommandozeilenparametern her
  291.                 gleich. Also bitte Σltere Versionen l÷schen.
  292.  
  293.                 1. das ist das einfachste Beispiel, wie man FR aufrufen
  294.                    kann
  295.  
  296.     SHELL 1.> FRequest
  297.  
  298.                 -   FR ÷ffnet  einen  Requester  mit  dem  Titel  'Bitte
  299.                     eine  Datei  auswΣhlen'  und  zeigt  das   momentane
  300.                     Verzeichnis an.  Die  GadgetTexte  sind  'OKAY'  fⁿr
  301.                     das  positive  und   'CANCEL'   fⁿr   das   negative
  302.                     Gadget.  Wird  eine  Auswahl  gemacht,  wird   diese
  303.                     im Cli-Fenster ausgegeben.
  304.  
  305.                 2. Benutzen von FR in einem alias, um  das  FONTS:  Ver-
  306.                    zeichnis zu wechseln:
  307.  
  308.     SHELL 1.> alias FAss FRequest TITEL "Bitte neues Fonts: Verz wΣhlen"
  309.                 OK "ASSIGN" ABBRUCH "STOP" COM "assign fonts:"
  310.  
  311.                 Wird nun FAss aufgerufen,
  312.  
  313.                 SHELL 1.> FAss
  314.  
  315.                 ÷ffnet FR den  Requester  mit  dem  Titel  'Bitte  neues
  316.                 Fonts:  Verz  wΣhlen'  und  zeigt  den  Inhalt  der  mo-
  317.                 mentanen  Verzeichnisses  an.   Die   GadgetTexte   sind
  318.                 nun 'ASSIGN' und  'STOP'.  Wird  eine  Auswahl  gemacht,
  319.                 wird diese mittels der Kommandozeile
  320.  
  321.                     'assign fonts: <Auswahl>'
  322.  
  323.                 als Cli-Kommando ausgefⁿhrt.
  324.  
  325.                 3. Nun ein Beispiel, bei dem fast alle  Angaben  benutzt
  326.                    wurden, die bei FR benutzt werden k÷nnen.
  327.                    Dieses Beispiel kopiert eine oder mehrere Dateien zu
  328.                    RAM:
  329.  
  330.  
  331.     SHELL 1.> Frequest TITEL "Bitte Datein zum Kopieren auswΣhlen" OK "KOPIERE" MULTI
  332.                        MUSTER "#?.(c|h)" COM "copy [] to RAM:"
  333.  
  334.  
  335. Technisches:
  336.  
  337.             FR ist mit dem MANX Aztec C Compiler Version 5.2a  kompilert
  338.             worden. Die Gr÷▀e von FR ist ziehmlich klein ( im  Gegensatz
  339.             zu manch anderen Σhnlichen Programmen).
  340.             Das ist darauf zurⁿckzufⁿhren, da▀ ich viele  System-Library
  341.             Calls an Stelle von C-Library Calls benutzt habe.
  342.  
  343.  
  344. Adresse:
  345.  
  346.     Grⁿ▀e etc.:
  347.  
  348.                 Hans-Peter Guenther
  349.                 Gruener Weg 5
  350.                 W-3501 Fuldatal 2
  351.                 B.R.D (Germany)
  352.  
  353.  
  354. Liste der Dateien:
  355.  
  356.    (Fehlt eine der folgenden Dateien, ist diese Ver÷ffentlichung inkomplett)
  357.  
  358.    FRequest            : Das englische Programm
  359.    FRequest.info
  360.    FRequest_D          : Das deutsche Programm
  361.    FRequest_D.info
  362.    FRequest.doc        : Die englische Anleitung
  363.    FRequest.doc.info
  364.    FRequest.dok        : Die deutsche Anleitung
  365.    FRequest.dok.info
  366.  
  367.  
  368.    *******************************************************************************************
  369.  
  370.