home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / PROGRAM / CLIPPER / NFTROFF / 16.TR < prev    next >
Text File  |  1993-12-01  |  6KB  |  282 lines
  1. .de }n
  2. .bp
  3. .sp .5i
  4. ..
  5. .wh -.8i }n
  6. .sp .5i
  7. .po -.4i
  8. .ll 7.5i
  9. .ps 9
  10. .vs 9
  11. .in 0i
  12. .sp 2
  13. .ne 20
  14. .ps +3
  15. .vs +3
  16. Recompiling the source code
  17. .br
  18. .ps -3
  19. .vs -3
  20. .sp 2
  21. .sp
  22. .in 0.32i
  23. \fBThe Nanforum Toolkit Master Makefile
  24. .sp
  25. This makefile will allow you to use RMAKE, provided with every
  26. Clipper 5\.0 package, to maintain your own copy of the Nanforum
  27. Toolkit\.  It is also a good example of how to use RMAKE on a
  28. large project\.  This is the exact copy used by the Nanforum Toolkit
  29. librarian\.
  30. .sp
  31. To use it, you must first understand what it does, and what your
  32. limitations are\.  A discussion of MAKE utlities is beyond the scope
  33. of this comment; read the Clipper documentation, or the Norton Guide
  34. file, for more information on RMAKE\.
  35. .sp
  36. \fB*** Compilers and Assemblers you need
  37. .sp
  38. Note that currently, Nanforum Toolkit sources are written in
  39. Assembly language, Clipper, and C\.  Within the realm of assembly
  40. language, our contributors have submitted code that is designed
  41. for Borland\'s Turbo Assembler (TASM) and Microsoft\'s Macro Assembler
  42. (MASM)\.  So, right now, in order to do a perfect re-build of the
  43. Nanforum Toolkit, you must have these tools:
  44. .sp
  45. .in 0.72i
  46. .br
  47. Microsoft C (v5\.1 or later)
  48. .br
  49. Microsoft Macro Assembler (v 5\.1 or later)
  50. .br
  51. Borland Turbo Assembler
  52. .br
  53. Nantucket Clipper v5\.0 or later
  54. .sp
  55. .in 0.32i
  56. If you know much about assembly language, you can convert MASM
  57. sources to TASM and vice versa, but that is up to you\.
  58. .sp
  59. \fB*** Library Utility
  60. .sp
  61. In addition, you must have a library utility\.  Microsoft supplies
  62. LIB\.EXE with its Compiler products, for example\.  LIB will work
  63. fine with this makefile\.  Note that we assume a command line syntax
  64. for library utilities that works like this:
  65. .sp
  66. .in 0.72i
  67. lib <libname> -+ objname
  68. .sp
  69. .in 0.32i
  70. .ta 4.4i
  71. Note the "-+" directive, indicating "replace module\."    If your
  72. .br
  73. .ta
  74. library utility does not support this syntax on the command line,
  75. then you will have to edit the relevant lines in the makefile\.
  76. .sp
  77. \fB*** Assumptions about your environment
  78. .sp
  79. NFMAKE\.RMK makes just a few assumptions about your environment:
  80. .sp
  81. .in 1.2i
  82. .ta 1.76i
  83. Assumption    What to change if we\'re wrong
  84. .br
  85. .ta
  86. .ta 1.76i
  87. ----------    -----------------------------
  88. .br
  89. .ta
  90. .sp
  91. .in 0.32i
  92. .ta 2.64i
  93. Relevant environment    Either edit the makefile to
  94. .br
  95. .ta
  96. .ta 2.64i
  97. variables for each compiler/    set the envars, or setup your
  98. .br
  99. .ta
  100. .ta 2.64i
  101. assembler are already    autoexec\.bat to set them on bootup\.
  102. .br
  103. .ta
  104. .ta 2.64i
  105. set (i\.e\., LIB=, INCLUDE=)    See your compiler doc\.
  106. .br
  107. .ta
  108. .sp
  109. .ta 2.64i
  110. Microsoft C is being    Look for the \.C source inference
  111. .br
  112. .ta
  113. .ta 2.64i
  114. used    rule below, and change it to your
  115. .br
  116. .ta
  117. .in 2.96i
  118. compiler, making sure your switches
  119. are correct\.  Note that some source
  120. may not compile without MSC, so edits
  121. may be required\.  Try to use MSC\.
  122. .sp
  123. .in 0.32i
  124. .ta 2.64i
  125. Microsoft Assembler    Look for all occurences of MASM in
  126. .br
  127. .ta
  128. .ta 2.64i
  129. executable is called    this makefile and change them to
  130. .br
  131. .ta
  132. .ta 2.64i
  133. MASM\.EXE    whatever *you* call MASM\.
  134. .br
  135. .ta
  136. .sp
  137. .ta 2.64i
  138. Clipper compiler executable    Look for all occurences of "Clipper" in
  139. .br
  140. .ta
  141. .ta 2.64i
  142. is called CLIPPER\.EXE    this makefile and change them to
  143. .br
  144. .ta
  145. .in 2.96i
  146. whatever *you* call Clipper\.
  147. .sp
  148. .in 0.32i
  149. .ta 2.64i
  150. Microsoft C executable is    Look for all occurences of "CL" in this
  151. .br
  152. .ta
  153. .ta 2.64i
  154. called CL\.EXE    makefile and change them to whatever
  155. .br
  156. .ta
  157. .in 2.96i
  158. *you* call CL\.
  159. .sp
  160. .sp
  161. .in 0.32i
  162. \fB*** Customizing the Makefile
  163. .sp
  164. We have tried not to assume anything about your environment except
  165. what is described above\.  To achieve that flexibility, you must
  166. check and set some macros that can be found just below this
  167. documentation\.  They are:
  168. .sp
  169. .in 0.72i
  170. .ta 0.8i
  171. l    Path to the resulting library (i\.e\., \\nanfor\\lib)
  172. .br
  173. .ta
  174. .ta 0.8i
  175. o    Path to where \.obj files should be put
  176. .br
  177. .ta
  178. .ta 0.8i
  179. s    Path to where the source code is found
  180. .br
  181. .ta
  182. .in 0.64i
  183. .ta 0.88i
  184. c5    Path to Clipper 5\.0 compiler \.EXE
  185. .br
  186. .ta
  187. .ta 0.88i
  188. ma    Path to Microsoft Macro Assembler \.EXE
  189. .br
  190. .ta
  191. .ta 0.88i
  192. ta    Path to Turbo Assembler \.EXE
  193. .br
  194. .ta
  195. .ta 0.88i
  196. mc    Path to Microsoft C 5\.1
  197. .br
  198. .ta
  199. .ta 0.88i
  200. ml    Path and name of library utility (i\.e\., \\bin\\lib)
  201. .br
  202. .ta
  203. .sp
  204. .in 0.4i
  205. Note that directory paths should *not* end in a backslash\.
  206. If you like to keep your \.obj and source files in the same
  207. directory, simply point the paths to the same place\.
  208. .sp
  209. \fB*** What happens when you don\'t have a compiler
  210. .sp
  211. If RMAKE can\'t find the compiler in the directory you specified,
  212. then the relevant files designed for that compiler will not be
  213. built, and the resultant objs won\'t be replaced in your library\.
  214. You will get an error message\.
  215. .sp
  216. \fB*** Suggestions for setting up a "rebuilding environment"
  217. .sp
  218. Should you want to rebuild, the following is suggested:
  219. .sp
  220. First, make sure you keep an unmodified NANFOR\.LIB, downloaded
  221. from the forum, in a safe place\.  Do not modify it\.
  222. .sp
  223. Next, create a directory structure like this
  224. .sp
  225. \\nanfor
  226. .in 0.72i
  227. \\obj
  228. \\src
  229. .sp
  230. .in 0.4i
  231. Put this makefile in \\nanfor, and all source code into
  232. \\nanfor\\src\.
  233. .sp
  234. Customize the makefile in \\nanfor for your environment\.
  235. The default macros below assume you\'re using this arrangement\.
  236. .sp
  237. Type RMAKE NFMAKE\.RMK\.  The \.obj files should be left in
  238. \\nanfor\\obj, and the new NANFOR\.LIB should be in \\nanfor\.
  239. .sp
  240. Note that as new releases of the library come out, you may have
  241. a lot of work incorporating additions and modifications\.  So,
  242. plan your rebuilding efforts carefully\.
  243. .sp
  244. \fB*** Problems, bugs, support
  245. .sp
  246. Support for this makefile can be found on CompuServe, in the
  247. Nantucket Forum (NANFORUM)\.  Leave messages in section 5 ("User
  248. Lib")\.  Updates and patches will be posted in Library 7\.
  249. .in 0i
  250. .sp
  251. .in 1.5i
  252. .ti -1.5i
  253. .ta 1.5i
  254. .ft B
  255. See Also:    
  256. .ft R
  257. Recompiling the Norton Guide
  258. .ta
  259. .in 0i
  260. .sp 2
  261. .ne 20
  262. .ps +3
  263. .vs +3
  264. Recompiling the Norton Guide
  265. .br
  266. .ps -3
  267. .vs -3
  268. .sp 2
  269. .sp
  270. .sp
  271. .in 0.32i
  272. *** instructions on how to rebuild the NG go here ***
  273. .in 0i
  274. .sp
  275. .in 1.5i
  276. .ti -1.5i
  277. .ta 1.5i
  278. .ft B
  279. See Also:    
  280. .ft R
  281. Recompiling the source code
  282.