home *** CD-ROM | disk | FTP | other *** search
/ The Developer Connection…ice Driver Kit for OS/2 3 / DEV3-D1.ISO / devtools / os2tk21j / c / samples / semaph / semaph.ip_ / semaph.ipf
Encoding:
Text File  |  1993-03-12  |  10.9 KB  |  237 lines
  1. .*==============================================================*\
  2. .*                                                              *
  3. .* SEMAPH.IPF - Information Tag Language file for the Help menu *
  4. .*              help panels.                                    *
  5. .*                                                              *
  6. .*==============================================================*/
  7. :userdoc.
  8.  
  9. .*--------------------------------------------------------------*\
  10. .*  Main window extended help panel
  11. .*      res = PANEL_MAIN
  12. .*--------------------------------------------------------------*/
  13. :h1 res=9110 name=PANEL_MAIN.About SEMAPH
  14. :i1 id=aboutMain.About SEMAPH
  15. :p.  The SEMAPH application is a sample Presentation Manager application
  16. which demonstrates the use of Mutex, Event and Mux Semaphores.
  17. In the application several threads are sharing access to the same
  18. resource.  A mutex semaphore is used to guarantee that only one thread
  19. has access to the resource at a time.  An event semaphore is used to
  20. signal the thread to give up the resource.  The event semaphore can
  21. by posted by the user or the application can be run in auto mode, in which
  22. case the event semaphore will be posted at fixed time intervals.
  23. A Mux semaphore is used to check for a stop event or a user signal to give
  24. up the resource.  This application also serves as a template than can be
  25. easily modified by an application developer.
  26.  
  27. .*--------------------------------------------------------------*\
  28. .*  Main Help menu                                              *
  29. .*      res = PANEL_HELP                                        *
  30. .*--------------------------------------------------------------*/
  31. :h1 res=9120 name=PANEL_HELP.Help Menu
  32. :i1 id=Help.Help Menu
  33. :p.Use the choices on the Help pull-down to display:
  34. :dl tsize=5 break=all.
  35. :dt.:hp2.Help index:ehp2.
  36. :dd.Displays the index of help menu.
  37. :dt.:hp2.General Help:ehp2.
  38. :dd.Displays some information about Semaph sample program.
  39. :dt.:hp2.Keys Help:ehp2.
  40. :dd.Displays a list of keys usage.
  41. :dt.:hp2.Using Help:ehp2.
  42. :dd.Provides detailed information on the kinds of help available and how to
  43. use help.
  44. :edl.
  45.  
  46. .*--------------------------------------------------------------*\
  47. .*  Help menu item Extended help... help panel                  *
  48. .*      res = PANEL_GENERALHELP                                 *
  49. .*--------------------------------------------------------------*/
  50. :h1 res=9130 name=PANEL_GENERALHELP.General Help
  51. :i2 refid=Help.Extended help
  52. :p.Use this choice to get general help for the program. General help
  53. provides general information about the Semaph sample program.
  54. :p.Map above displays the number of hits for each thread.
  55. :p.Squares below change color as are hit by a thread.
  56.  
  57. .*--------------------------------------------------------------*\
  58. .*  Help menu item Help for help... help panel                  *
  59. .*      res = PANEL_USINGHELP                                   *
  60. .*--------------------------------------------------------------*/
  61. :h1 res=9140 name=PANEL_USINGHELP.Extended
  62. :i2 refid=Help.Help for Help
  63. :p.Use this choice to obtain information on how to
  64. use the Help facility.
  65.  
  66. .*--------------------------------------------------------------*\
  67. .*  Help menu item Keys help... help panel                      *
  68. .*      res = PANEL_TUTORIAL                                    *
  69. .*--------------------------------------------------------------*/
  70. :h1 res=9150 name=PANEL_TUTORIAL.Tutorial of Keys
  71. :i2 refid=Help.Keys Help
  72. :p.Use this choice to see a list of keys and a description of the
  73. function of the keys.
  74.  
  75. .*--------------------------------------------------------------*\
  76. .*  Keys help panel                                             *
  77. .*      res = PANEL_KEYSHELP                                    *
  78. .*--------------------------------------------------------------*/
  79. :h2 res=9180 name=PANEL_KEYSHELP.Key Assigments
  80. :p.The list of keys is arranged in groups.
  81. :p.:hp2.ACCELERATOR KEYS:ehp2.
  82. :dl tsize=2 break=all.
  83. :p.:hp2.HELP KEYS:ehp2.
  84. :dl tsize=5 break=all.
  85. :dt.F1
  86. :dd.Get help
  87. :dt.Esc
  88. :dd.Previous Help Panel, or End help if only one panel
  89. :dt.Alt
  90. :dd.Switch IN/OUT action bar
  91. :dt.Alt+F4
  92. :dd.End help or End program
  93. :edl.
  94. :p.:hp2.SYSTEM KEYS:ehp2.
  95. :dl tsize=5 break=all.
  96. :dt.Alt+Esc
  97. :dd.Switch to the next program, including full-screen programs
  98. :dt.Ctrl+Esc
  99. :dd.Switch to the Task List
  100. :edl.
  101. :p.:hp2.WINDOW KEYS:ehp2.
  102. :dl tsize=5 break=all.
  103. :dt.Underlined letter
  104. :dd.Move among the choices on the action bar and pull-downs submenu or
  105. execut the function chosen
  106. :edl.
  107.  
  108. .*--------------------------------------------------------------*\
  109. .*  Help menu item Help index... help panel                     *
  110. .*      res = PANEL_HELPINDEX                                   *
  111. .*--------------------------------------------------------------*/
  112. :edl.
  113. :h1 res=9160 name=PANEL_HELPINDEX.Index
  114. :i2 refid=Help.Help Index
  115. :p.Use this choice to display the help index.
  116. :p.The help index lists the titles of the help information that is available.
  117.  
  118. .*--------------------------------------------------------------*\
  119. .*  Help menu item Product... help panel                        *
  120. .*      res = PANEL_HELPPRODINFO                                *
  121. .*--------------------------------------------------------------*/
  122. :h1 res=9170 name=PANEL_HELPPRODINFO.Information
  123. :i2 refid=Help.PRODUCTINFO Information
  124. :p.This dialog displays information about the application, such as version
  125. number and copyright notice.
  126.  
  127. .*--------------------------------------------------------------*\
  128. .*  Help menu item ProductOK... help panel                      *
  129. .*      res = PANEL_PRODUCTINFO_OK                              *
  130. .*--------------------------------------------------------------*/
  131. :h1 res=9211 name=PANEL_PRODUCTINFO_OK.Information
  132. :i2 refid=HELP.PRODUCTOK Information
  133. :p.The OK button closed dialog box.
  134.  
  135. .*--------------------------------------------------------------*\
  136. .*  Help menu item NumberThread... help panel                   *
  137. .*      res = PANEL_NTHRDSHELP                                  *
  138. .*--------------------------------------------------------------*/
  139. :h1 res=9181 name=PANEL_NTHRDSHELP.Information
  140. :i2 refid=HELP.THREADS Information
  141. :p.This menu item will bring up four choices that indicated the number
  142. which thread will be created.
  143.  
  144. .*--------------------------------------------------------------*\
  145. .*  Help menu item 2Thread... help panel                        *
  146. .*      res = PANEL_THRDS2HELP                                  *
  147. .*--------------------------------------------------------------*/
  148. :h1 res=9182 name=PANEL_THRDS2HELP.Information
  149. :i2 refid=HELP.2THREADS Information
  150. :p.This menu item indicated there are 2 threads will be created.
  151.  
  152. .*--------------------------------------------------------------*\
  153. .*  Help menu item 2Thread... help panel                        *
  154. .*      res = PANEL_THRDS4HELP                                  *
  155. .*--------------------------------------------------------------*/
  156. :h1 res=9183 name=PANEL_THRDS4HELP.Information
  157. :i2 refid=HELP.4THREADS Information
  158. :p.This menu item indicated there are 4 threads will be created.
  159.  
  160. .*--------------------------------------------------------------*\
  161. .*  Help menu item 8Thread... help panel                        *
  162. .*      res = PANEL_THRDS8HELP                                  *
  163. .*--------------------------------------------------------------*/
  164. :h1 res=9184 name=PANEL_THRDS8HELP.Information
  165. :i2 refid=HELP.8THREADS Information
  166. :p.This menu item indicated there are 8 threads will be created.
  167.  
  168. .*--------------------------------------------------------------*\
  169. .*  Help menu item 16Thread... help panel                        *
  170. .*      res = PANEL_THRDS16HELP                                  *
  171. .*--------------------------------------------------------------*/
  172. :h1 res=9185 name=PANEL_THRDS16HELP.Information
  173. :i2 refid=HELP.16THREADS Information
  174. :p.This menu item indicated there are 16 threads will be created.
  175.  
  176. .*--------------------------------------------------------------*\
  177. .*  Help menu item Start... help panel                          *
  178. .*      res = PANEL_STARTHELP                                   *
  179. .*--------------------------------------------------------------*/
  180. :h1 res=9186 name=PANEL_STARTHELP.Information
  181. :i2 refid=HELP.START Information
  182. :p.This menu item starts the program.
  183.  
  184. .*--------------------------------------------------------------*\
  185. .*  Help menu item AUTO Start... help panel                     *
  186. .*      res = PANEL_AUTOHELP                                    *
  187. .*--------------------------------------------------------------*/
  188. :h1 res=9187 name=PANEL_AUTOHELP.Information
  189. :i2 refid=HELP.AUTO Information
  190. :p.This menu item indicated the program will create semaphs and events
  191. by program.
  192.  
  193. .*--------------------------------------------------------------*\
  194. .*  Help menu item Manual Start... help panel                   *
  195. .*      res = PANEL_MANUALHELP                                  *
  196. .*--------------------------------------------------------------*/
  197. :h1 res=9188 name=PANEL_MANUALHELP.Information
  198. :i2 refid=HELP.MANUAL Information
  199. :p.This menu item indicated the program will create semaphs and events
  200. by user.
  201.  
  202. .*--------------------------------------------------------------*\
  203. .*  Help menu item Time out... help panel                       *
  204. .*      res = PANEL_TIMEOUTHELP                                 *
  205. .*--------------------------------------------------------------*/
  206. :h1 res=9189 name=PANEL_TIMEOUTHELP.Information
  207. :i2 refid=HELP.TIMEOUT Information
  208. :p.This menu item will bring up a dialog box which can let user change
  209. minimum interval for posting event semaphore.
  210.  
  211. .*--------------------------------------------------------------*\
  212. .*  Help menu item Stop... help panel                           *
  213. .*      res = PANEL_STOPHELP                                    *
  214. .*--------------------------------------------------------------*/
  215. :h1 res=9191 name=PANEL_STOPHELP.Information
  216. :i2 refid=HELP.STOP Information
  217. :p.This menu item will stop program running in automatic mode.
  218.  
  219. .*--------------------------------------------------------------*\
  220. .*  Help menu item Resume automode... help panel                *
  221. .*      res = PANEL_RESUMEHELP                                  *
  222. .*--------------------------------------------------------------*/
  223. :h1 res=9192 name=PANEL_RESUMEHELP.Information
  224. :i2 refid=HELP.RESUME Information
  225. :p.This menu item will resume program running in automatic mode.
  226.  
  227. .*--------------------------------------------------------------*\
  228. .*  Help menu item Post... help panel                           *
  229. .*      res = PANEL_POSTHELP                                    *
  230. .*--------------------------------------------------------------*/
  231. :h1 res=9193 name=PANEL_POSTHELP.Information
  232. :i2 refid=HELP.POST Information
  233. :p.This menu item will create and post an event and semaphore to a thread,
  234. once each time.
  235.  
  236. :euserdoc.
  237.