home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_01 / PC_V11_B.LZH / PC_HELP / PC_HELP.DOC < prev    next >
Text File  |  1991-06-18  |  4KB  |  99 lines
  1. Pure C for Atari ST/TT                                       18.06.91
  2. ----------------------------------------------------------------------
  3.  
  4. (c) 1990 by Borland International
  5.  
  6. PC_HELP
  7. -------
  8.  
  9. Dieses  kleine  Programm  stellt  Ihnen  das  Help  aus  dem  Pure  C
  10. Entwicklungssystem als Standalone Anwendung zu Verfügung. Sie können
  11. es sowohl als Applikation als auch als Deskaccesory anwenden. Au₧erdem
  12. enthält  es  eine  Programmierschnittstelle,   so  da₧  es  von  jeder
  13. beliebigen GEM-applikation aufgerufen werden kann.
  14.  
  15. Installation
  16.  
  17. Kopieren Sie einfach das Programm in das Verzeichnis, in dem sich auch
  18. Turbo C  und die Helpfiles befinden.  Sie können es aber  auch mit der
  19. Extension   ACC  versehen,  es   in  das  Wurzelverzeichnis   Ihres
  20. Bootlaufwerks kopieren  und den Atari  Rechner neu starten.  In diesem
  21. Fall  benötigt  es  aber  noch  den  Pfad,  in  dem die Helpfiles sich
  22. befinden.
  23.  
  24. Pfadangabe
  25.  
  26. Beim Start des Programms oder  beim Booten des Systems (DeskAccessory)
  27. wird der Helppfad mit folgenden Methoden gesucht:
  28.  
  29. - PC_HELP.INF: befindet  sich diese Datei  im aktuellen Directory,  so
  30.   wird der Pfad, der mit einem einfachen Editor reingeschrieben werden
  31.   kann, als der Turbo C Pfad erkannt und installiert.
  32.  
  33. - PC.HLP: kann das Programm diese  Datei mit shel_find finden, so wird
  34.   der zugehörige Pfad installiert.
  35.  
  36. - PC:   fruchtet    all   dies   nichts,    so   wird   nach    dieser
  37.   Environmentvariablen gesucht und der entsprechnede Pfad installiert.
  38.  
  39. - Ansonsten wird der gerade aktuelle Pfad verwendet.
  40.  
  41. Aufruf
  42.  
  43. Beim Aufruf vom Desktop oder  als DeskAccessory erhält man eine kleine
  44. Dialogbox  in der  man entweder  eines der  vordefinierten HelpScreens
  45. durch  Mausklick  auswählen  kann,   oder  Sie  geben  das  gewünschte
  46. Schlüsselwort  ein  und  wählen  den  OK-Button.  Verwenden  Sie einen
  47. Kommandointerpreter,  so können  Sie  dem  Programm auch  sofort einen
  48. Parameter   übergeben,   der    dann   als   gesuchtes   Schlüsselwort
  49. interpretiert wird.
  50.  
  51. Shortcuts
  52.  
  53. UNDO                                   zeigt den vorherigen Hilfetext.
  54. Control-U bzw. Control-Q                    schlie₧t das HIlfefenster.
  55. Control-C        kopiert den aktuellen Hilfetext in das GEM-Klemmbrett.
  56.  
  57. Programmierschnittstelle
  58.  
  59. Als  DeskAccessory versteht  das Programm  neben den  Standardmessages
  60. auch  eine selbstdefinierte  Message mit  der Nummer  1025. Damit kann
  61. eine andere Applikation das  Accessory beauftragen das Hilfefenster zu
  62. Öffnen. Der Aufbau des Messagebuffers ist folgender:
  63.  
  64. msgBuf[0] = 1025          (AC_HELP)
  65. msgBuf[1] = senderId      (von appl_init)
  66. msgBuf[2] = 0
  67. msgBuf[3] = Highword eines Zeigers auf das Schlüsselwort
  68. msgBuf[4] = Lowword    "      "     "   "         "
  69. msgBuf[5-8] werden ignoriert.
  70.  
  71. Als zweite  Nachricht kann man  das Accessory nach  der Versionsnummer
  72. fragen. Der Aufbau des Messagebuffers ist folgender:
  73.  
  74. msgBuf[0] = 1027          (AC_VERSION)
  75. msgBuf[1] = senderId      (von appl_init)
  76. msgBuf[2] = 0
  77. msgBuf[3-8] werden ignoriert.
  78.  
  79. Als letzte Nachricht kann man das Accessory beauftragen, den aktuellen
  80. Helptext in das GEM-Klemmbrett zu sichern.
  81.  
  82. msgBuf[0] = 1028          (AC_COPY)
  83. msgBuf[1] = senderId      (von appl_init)
  84. msgBuf[2] = 0
  85. msgBuf[3-8] werden ignoriert.
  86. Die Antwort hat folgenden Aufbau:
  87. msgBuf[0] = 1026          (AC_REPLY)
  88. msgBuf[1] = senderId      (Kennung des Accessories)
  89. msgBuf[2] = Versionsnummer
  90. msgBuf[3] = WindowHandle des Accessories
  91.  
  92. Hinweis:
  93.  
  94. Aus technischen Gründen ist es leider nicht möglich, da₧ auf das Turbo
  95. Debugger Helpfile zugegriffen wird. Der Speicherbedarf liegt bei 29862
  96. Bytes.
  97.  
  98. Viel Spa₧ wünscht Ihnen das Pure C Team
  99.