home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / bookm2.zip / basic.inf (.txt) next >
OS/2 Help File  |  1994-09-25  |  11KB  |  200 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction (Page 1) ΓòÉΓòÉΓòÉ
  3.  
  4. This file will demonstrate building a simple INF or HLP file. The source for 
  5. this file is available as BASIC.IPF. 
  6.  
  7. This type of file can be created simply and easily by inserting pages, 
  8. paragraphs, lines and lists, one after the other using BookMaker.  Click 
  9. forward to see the next page which contains additional enhancements to simple 
  10. paragraphs. 
  11.  
  12. This page was created by selecting File/New, typing in a Title and then 
  13. clicking on page.  At the Insert Heading dialog, I typed in Introduction and 
  14. hit return. I then selected Paragraph and typed in each paragraph seperately. 
  15.  
  16. Because Options/Autosave is checked, the file is saved after every dialog is 
  17. presented. 
  18.  
  19.  
  20. ΓòÉΓòÉΓòÉ 2. Page 2 ΓòÉΓòÉΓòÉ
  21.  
  22. The second page was created the same way as the first.  Notice that the res 
  23. (resource id) number automatically jumped one.  Within the same session, the 
  24. res number is automatically increased with every new page. 
  25.  
  26. Click forward to see the next page. 
  27.  
  28.  
  29. ΓòÉΓòÉΓòÉ 3. Page 3 ΓòÉΓòÉΓòÉ
  30.  
  31. Surprise 
  32.  
  33. The preceeding word was enhanced.  This was done by creating the word with a 
  34. paragraph tag and then selecting the word in the main BookMaker window.  I then 
  35. clicked font and at the Font Dialog selected Helv  48x28.  The new font was 
  36. added to the begining of the selected word and the defaults were placed at the 
  37. end of the word.  In the following paragraph the same is done only this time an 
  38. entire paragraph is selected. 
  39.  
  40. The words in this paragraph are enhanced in two ways.  First they are selected 
  41. and the Font is changed.  They are selected once again and the color is 
  42. changed.  (It's OK to select the font tags with the text.  Just be sure to get 
  43. the whole thing.) 
  44.  
  45. You can select almost anything and apply tags to your selection.  The 
  46. exceptions are artwork, tables, lists, and autotags. 
  47.  
  48.  
  49. ΓòÉΓòÉΓòÉ 4. Page 4 (Primary) ΓòÉΓòÉΓòÉ
  50.  
  51. This page is listed as primary.  The box preceeding the heading in the TOC 
  52. indicates that there is a sub-heading.  Press forward to see the next page. 
  53.  
  54.  
  55. ΓòÉΓòÉΓòÉ 4.1. Page 4 Level 2 ΓòÉΓòÉΓòÉ
  56.  
  57. When this Heading was created I selected Heading 2.  This made the window a 
  58. sub-heading of Page 4 
  59.  
  60.  
  61. ΓòÉΓòÉΓòÉ 5. Page 5 Lines ΓòÉΓòÉΓòÉ
  62.  
  63. In this page we'll use lines of text.  Using this tag you won't have to add a 
  64. paragraph for each line. 
  65.  
  66. This is the first line.
  67. This is the second.
  68. This is the third.
  69. These lines are left justified.
  70.  
  71.                      This is a single line that is centered
  72.  
  73.                                   This is a single line that is right justified.
  74.                                       Notice that we changed the font and color.
  75.  
  76.  
  77. ΓòÉΓòÉΓòÉ 6. Page 7 Lists ΓòÉΓòÉΓòÉ
  78.  
  79. This page demonstrates lists. 
  80.  
  81. This is a caption (optional): 
  82.  
  83.  1. Item 1 
  84.  
  85.     a. This list is placed within another 
  86.  
  87.  2. Item 2 
  88.  
  89.  3. Item 3 
  90.  
  91.  4. Remember this is an ordered (numbered) list 
  92.  
  93. This is an unordered list: 
  94.  
  95. o Item 1 
  96.  
  97. o Item 2 
  98.  
  99. o Item 3 
  100.  
  101. This is a simple list: 
  102.  
  103. Item 1 
  104. Item 2 
  105. Item 3 
  106. Notice that this list is compact 
  107.  
  108. In the last list I changed the font. 
  109.  
  110.  
  111. ΓòÉΓòÉΓòÉ 7. Page 8 Example Text ΓòÉΓòÉΓòÉ
  112.  
  113. This page contains the example tag.  Notice that the font is automatically 
  114. changed.  This is used mostly for code examples. 
  115.  
  116. #define  INCL_DOS
  117. #include <os2.h>
  118. #include <malloc.h>
  119. #include <process.h>
  120. #include <stdio.h>
  121. #include <stdlib.h>
  122.  
  123.  
  124. int main( int argc, char * argv[] );
  125. void childcode( void * arg );
  126.  
  127. typedef struct            /* the thread information structure          */
  128. {                         /*                                           */
  129.    unsigned count;        /* the number of times to display the text   */
  130.    HEV      hev  ;        /* the individual thread's event semaphore   */
  131. }  THREAD_INFO ;          /* handle                                    */
  132.  
  133.  
  134. ΓòÉΓòÉΓòÉ 8. Page 9 (Highlighted Text) ΓòÉΓòÉΓòÉ
  135.  
  136. Within this paragraph  are selected words with various highlight 
  137. characteristics.  This was done by selecting certain words within the paragraph 
  138. and selecting Highlight. 
  139.  
  140.  
  141. ΓòÉΓòÉΓòÉ 9. Page 10 (Graphics) ΓòÉΓòÉΓòÉ
  142.  
  143. Graphics are one of the main enhancements to any INF file. This and the 
  144. following page include Three graphics examples. 
  145.  
  146. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  147. Γöé                            Γöé
  148. Γöé  This is a Character       Γöé
  149. Γöé  Graphics example.         Γöé
  150. Γöé  Its a simple way to       Γöé
  151. Γöé  to create boxesΓöîΓöÇΓöÇΓöÇΓöÇΓöÉ     Γöé
  152. Γöé                 Γöé    Γöé     Γöé
  153. Γöé                 ΓööΓöÇΓöÇΓöÇΓöÇΓöÿ     Γöé
  154. Γöé    and the like.           Γöé
  155. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  156. Γöé It takes some practice!    Γöé
  157. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  158.  
  159. This is a left aligned bitmap. 
  160.  
  161. Click forward to see the same bitmap as a full page graphic. 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ 9.1. Full Page Graphic ΓòÉΓòÉΓòÉ
  165.  
  166. In this example fit to page was selected.  The picture is stretched so it 
  167. appears strange.  You can manipulate pages to fix this.  See Windows.INF for 
  168. details on this. 
  169.  
  170.  
  171. ΓòÉΓòÉΓòÉ 10. Table ΓòÉΓòÉΓòÉ
  172.  
  173. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  174. ΓöéComputer  Γöé Monitor  Γöé CD-ROM   Γöé Modem    Γöé
  175. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  176. ΓöéPentium   Γöé NEC      Γöé NEC      Γöé Hays     Γöé
  177. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  178. Γöé486       Γöé STAR     Γöé Creative Γöé PracticalΓöé
  179. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  180. Γöé386       Γöé IBM      Γöé Philips  Γöé ZOOM     Γöé
  181. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  182.  
  183. This table was created by selecting the table option and inserting text into 
  184. each listbox.  The width of each column was changed to ten. Keep in mind that 
  185. you must fill all spaces in the first column for the other rows you wish to 
  186. show.  For example if the first column contains 4 items and one of the others 
  187. contains five, you must insert a blank space into the first column to make up 
  188. the difference. 
  189.  
  190.  
  191. ΓòÉΓòÉΓòÉ 11. A final word... ΓòÉΓòÉΓòÉ
  192.  
  193. Keep in mind that all rules for your IPF compiler still apply.  You can get a 
  194. better idea of what's really possible and not possible by going through 
  195. ipfc20.inf(included with your IPF compiler) first. 
  196.  
  197. My old bosses always got mad at me because I always made them read the manual! 
  198.  
  199. If you're new to IPF creation, play with the basics first.  When you're ready, 
  200. read the Linking.INF file.