home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d09xx / d0923.lha / MagicPubName / MagicPubName.dok < prev    next >
Text File  |  1993-10-07  |  6KB  |  129 lines
  1.  
  2.     --------------------------------------------------------------------
  3.     MagicPubName 1.3a (6.8.93) ⌐ Franz.Schwarz@mil.ka.sub.org - Freeware
  4.     --------------------------------------------------------------------
  5.  
  6. MagicPubName ist, wie der Name bereits impliziert, ein kleines, aber
  7. vielseitiges und mΣchtiges Utility, mit dem der Name von ÷ffentlichen
  8. Schirmen erfragt werden kann.  Die FunktionalitΣt und Sicherheit dieses
  9. Utilities geht weit ⁿber die anderer 'GetPubName'-Utilities hinaus.  Ab
  10. Version 1.2 kann MagicPubName zudem ÷ffentliche Schirme nach vorne bringen.
  11.  
  12. Anhand der Kommandozeilen-Argument-Schablone
  13.  
  14. RequireVisible=RV/S,RequireFront=RF/S,Default/S,Shanghai/S,ConsoleScr=Con/S
  15.         ScreenName=Scr,Case/S,WBOnFailure=WBF/S,ToFront/S,Quiet=Q/S
  16.  
  17. lΣ▀t sich die Funktion von MagicPubName erkennen:
  18.  
  19.  
  20. Es k÷nnen mehrere Schalter und der Name des ÷ffentlichen Schirms
  21. spezifiziert werden.  Der ÷ffentliche Schirm wird dann anhand dieser
  22. angefⁿhrten Argumente ermittelt und sein Name auf dem aktuellen
  23. Ausgabekanal ausgegeben, falls ein ÷ffentlicher Schirm gefunden wurde, der
  24. allen spezifizierten Argumenten gerecht wird.  Wenn kein passender Schirm
  25. gefunden wurde, wird kein Schirmname ausgegeben, sondern der Rⁿckgabewert
  26. auf WARN (5) gesetzt, es sei denn, es wurden dem Programm keine Argumente
  27. abgesehen von ToFront/S & Quiet=Q/S ⁿbergeben oder es wurde der
  28. WBOnFailure-Schalter spezifiziert:  in diesen FΣllen wird, wenn kein
  29. passender Schirm gefunden werden konnte, zusΣtzlich zum Rⁿckgabewert WARN
  30. der Name des standardmΣ▀igen ÷ffentlichen Schirms oder, falls dieser nicht
  31. ermittelt werden kann, "Workbench" ausgegeben.
  32.  
  33. Zu den Argumenten im einzelnen:
  34.  
  35. RequireVisible=RV/S:  wird dieser Schalter angegeben, dann mu▀ ein
  36. passender ÷ffentlicher Schirm (zumindest ein Teil des Schirms) gegenwΣrtig
  37. sichtbar sein.
  38.  
  39. RequireFront=RF/S:  falls dieser Schalter aufgefⁿhrt wird, so mu▀ ein
  40. passender ÷ffentlicher Schirm der oberste Schirm, der gegenwΣrtig angezeigt
  41. wird, sein.
  42.  
  43. Default/S:  die Angabe dieses Schalters bedeutet, da▀ ein passender
  44. ÷ffentlicher Schirm gleichzeitig der aktuelle standardmΣ▀ige ÷ffentliche
  45. Schirm sein mu▀.
  46.  
  47. Shanghai/S:  wenn dieser Schalter spezifiziert wird, dann mu▀ ein passender
  48. ÷ffentlicher Schirm gleichzeitig der Schirm sein, auf dem gegenwΣrtig die
  49. Fenster ge÷ffnet werden, deren NewWindow.Type-Eintrag auf WBENCHSCREEN
  50. gesetzt ist (z.B.  CON:-Fenster ohne /SCREEN- Spezifikation im Namen).
  51.  
  52. ConsoleScr=Con/S:  falls dieser Schalter angegeben wird, dann pa▀t ein
  53. ÷ffentlicher Schirm nur, wenn der aktuelle Eingabekanal eine interaktive
  54. Konsole darstellt, die zur Ein-/ Ausgabe ein Intuition-Fenster auf der
  55. selben Maschine verwendet, und deren Intuition-Fenster auf dem ÷ffentlichen
  56. Schirm ge÷ffnet ist.
  57.  
  58. ScreenName=Scr:  wenn ein Schirmname genannt wird, dann mu▀ ein passender
  59. ÷ffentlicher Schirm mit diesem Namen ⁿbereinstimmen.  StandardmΣ▀ig wird
  60. dabei zuerst ein Schirm gesucht, dessen Namen genau mit dem genannten Namen
  61. ⁿbereinstimmt.  Falls der Schalter Case/S nicht angegeben wurde, wird
  62. zusΣtzlich in einem zweiten Durchgang schlie▀lich auf Namensⁿbereinstimmung
  63. geprⁿft, ohne Gro▀-/ Kleinschreibung heranzuziehen.
  64.  
  65. Case/S:  dieser Schalter ist nur bei angegebenem ScreenName=Scr-Argument
  66. gⁿltig - andernfalls bricht MagicPubName mit Rⁿckgabewert 20 (FAIL) ab.
  67. Seine Funktion wird in der Dokumentation des ScreenName=Scr- Argumentes
  68. beschrieben.
  69.  
  70. WBOnFailure=WBF/S:  falls dieser Schalter spezifiziert wird, so gibt
  71. MagicPubName den Namen des standardmΣ▀igen ÷ffentlichen Schirms (bzw.
  72. "Workbench", falls der Name des standardmΣ▀igen ÷ffentlichen Schirms nicht
  73. in Erfahrung gebracht werden kann) auf dem aktuellen Ausgabekanal aus, wenn
  74. kein passender ÷ffentlicher Schirm, der allen angegebenen Argumenten
  75. gerecht wird, gefunden werden konnte.
  76.  
  77. ToFront/S:  dieser Schalter bewirkt, da▀ der ÷ffentliche Schirm, dessen
  78. Namen ausgegeben wird, nach vorne gebracht wird.
  79.  
  80. Quiet=Q/S:  Schalter, der MagicPubName anweist, ruhig zu sein (d.h.  nichts
  81. auszugeben) au▀er es schlΣge mit einem Rⁿckgabewert gr÷▀er Dos.warn (5)
  82. fehl.
  83.  
  84. Falls keines der Argumente RequireFront=RF/S, Default/S, Shanghai/S,
  85. ConsoleScr=Con/S und ScreenName=Scr angegeben wird, dann wird der vorderste
  86. (teilweise) sichtbare ÷ffentliche Schirm oder, falls kein ÷ffentlicher
  87. Schirm gegenwΣrtig sichtbar ist, der standardmΣ▀ige ÷ffentliche Schirm als
  88. passend betrachtet, sofern er den Bedingungen der anderen angegebenen
  89. Argumente genⁿgt.
  90.  
  91.  
  92. Durch die Rⁿckgabe von WARN (5), falls kein passender ÷ffentlicher Schirm
  93. gefunden wird, und durch die vielen Filter-Arguemnte, allen voran das
  94. ConsoleScr=Con-Argument, eignet sich MagicPubName besonders zum Einbau in
  95. eigene ARexx-Skripte und Stapelverarbeitungsdateien.
  96.  
  97. Aus KompatibilitΣtsgrⁿnden mit bestehenden ARexx-Skripten,
  98. Stapelbearbeitungsdateien und Alias-Definitionen, wird empfohlen,
  99. MagicPubName ins Verzeichnis c:  zu kopieren, und es dann mit 'MakeLink
  100. c:GetPubName c:MagicPubName Hard' au▀erdem unter dem ⁿblicherweise fⁿr die
  101. trivialen GetPubName-Utilities ⁿblichen Namen zugΣnglich zu machen.
  102.  
  103. MagicPubName ist reentrant, 'pure'.  Da es zudem trotz seiner
  104. LeistungsfΣhigkeit ziemlich klein ist, wird empfohlen, es resident zu
  105. machen.  ('resident c:MagicPubName' oder / und 'resident c:GetPubName')
  106.  
  107.  
  108. MagicPubName ist Freeware, i.e., es ist frei kopierbar, das
  109. Urheberrecht liegt aber weiterhin beim Autor.  Eine Haftung des
  110. Autors fⁿr SchΣden, die unmittelbar oder mittelbar von dem Gebrauch
  111. von MagicPubName herrⁿhren, ist definitiv ausgeschlossen.  Die
  112. Verwendung von MagicPubName erfolgt auf Ihr eigenes Risiko.  In
  113. angelsΣchsischem Jargon wird dies gemeinhin als 'Use At Your Own
  114. Risk' bezeichnet.
  115.  
  116.  
  117.     MagicPubName geschrieben und urheberrechtlich geschⁿtzt, ⌐ 1993 by 
  118.        Franz Schwarz, Mⁿhlenstra▀e 2, D-78591 Durchhausen, Germany.
  119.           uucp: Franz.Schwarz@mil.ka.sub.org; Fido: 2:241/7506.18
  120.  
  121.  
  122. Anregungen, Kritik, Flames, Geld, Gold, Disketten, Bier, Schokolade, nette
  123. Postkarten, e-mails, etc. sind jederzeit herzlich willkommen!;-)
  124.  
  125.  
  126.     Bye
  127.       Franz 'Blacky' Schwarz
  128.  
  129.