home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / vos2-121.zip / v / emx / Readme < prev   
Text File  |  1999-03-12  |  8KB  |  215 lines
  1. Introduction
  2. ============
  3.  
  4. This is the second release of the OS/2 port of V. It is released at
  5. version 1.21a, the current version of V for Windows and X.  It also
  6. includes popup menu support, a feature to be added in the future to all 
  7. platforms for version 1.22.
  8.  
  9.  
  10. Getting Started
  11. ===============
  12.  
  13. You will need to first download vos2-121.zip.  This file includes
  14. the source code and the HTML documentation for the V library including 
  15. generic installation instructions (mainly for X and Windows, but much 
  16. also applies to the OS/2 port).  
  17.  
  18. To read the HTML documentation you will need a browser that
  19. supports frames such as the newly released Netscape v4.04 for OS/2.
  20. Netscape v2.02 will also work.  To get the new Netscape v4 go to 
  21. http://www.software.ibm.com/os/warp/netscape/
  22.  
  23. To unpack v121os2.zip:
  24.  
  25.   1. Download it to a directory where you want to install it.
  26.   2. Change directory to a location where you want to install 
  27.      V GUI for OS/2 and use PK-Zip or InfoZip tools to unzip archive.
  28.   4. Open v\doc\v.htm with your browser
  29.  
  30. The port has been tested with Borland C++ for OS/2 v2.0, EMX v0.9c, 
  31. and IBM's VisualAge 3.0.  There is a makefile for Watcom C++, however, 
  32. it was developed for v1.17 and has not been updated for v1.21.  Since
  33. I do not have access to Watcom, hopefully someone else can update
  34. it for me and send along the new project files. 
  35.  
  36. To make things easier, I have included pre-built (without debug info) 
  37. libraries for Borland C++ v2.0, IBM's visualAge 3.0, and EMX 0.9c.  
  38. These libraries include support for OpenGL, but of course, you need 
  39. to install the IBM OpenGL runtime code on your system before you can 
  40. take advantage of OpenGL on your system.
  41.  
  42. For more info on OpenGL and OS/2, point your browser at
  43.  http://www.utsi.com/~kgl/os2-opengl/
  44.  
  45. NOTE: V1.21 is not source compatible with apps written
  46. for V1.17.  There are some differences in a few functions.
  47.  
  48.  
  49. V for OS/2 Compile Instructions
  50. ===============================
  51.  
  52. The following info gives specific details for compiling the libraries and
  53. sample applications for the specific compilers supported. 
  54.  
  55.  
  56. Borland C++ for OS/2 v2.0
  57. =========================
  58.  
  59. The V port was developed primarily using Borland C++ for OS/2 v2.0.  A
  60. complete set of project files for all the sample applications included
  61. with V can be found in the directory V\BCOS2.  You will need to
  62. reconfigure the project directories settings for your particular system.
  63.  
  64. The included projects here are for compiling the V library and
  65. all the standard V apps included with the windows
  66. and X versions of V. Since I use Borland as my IDE of choice,
  67. the project files here are very complete.
  68.  
  69. The main V library comes prebuilt as V\lib\os2\vos2.lib.  It was 
  70. compiled with debugging turned off.
  71.  
  72. If you wish to rebuild the main V library, use vos2.prj and copy the 
  73. resulting vos2.lib file to V/lib/os2 from V/obj/os2. 
  74.  
  75. Once you have built the main V library, you should proceed
  76. to build test.prj to build the testapp application demonstrating 
  77. V's capabilities. 
  78.  
  79. To test out the OpenGL capabilities, try compiling any of the apps
  80. in the V\vopengl\ directory such as vbounce.prj.  
  81.  
  82.  
  83. EMX 0.9c
  84. ========
  85.  
  86. Start by editing the CfgEMX.mk file for your system. The file can be
  87. found in the V\emx directory. For most systems, only HOMEV will need 
  88. editing, everything else can remain as is.  Also, make sure the emx binaries
  89. are in your PATH.
  90.  
  91. When you are happy with it, copy it to the root V directory and
  92. call it config.mk.  
  93.  
  94. The main V library comes prebuilt as V\lib\os2\vos2.a.  It was 
  95. compiled with debugging turned off.  In addition, there is another
  96. library V\lib\os2\vos2gl.a that includes the routines needed to support
  97. OpenGL.
  98.  
  99. If you wish to compile the main libraries yourself, then go to V\srcos2 
  100. and run GNU make on the Makefile in there.  Note that all the makefiles 
  101. assume Gnu make.  They will not work for IBM's nmake!!  Gnu make for OS/2 is 
  102. available from most os/2 sites.
  103.  
  104. If that goes okay, go to the V\test directory and run the Makefile
  105. in there.  That should build the testapp application 
  106. demonstrating V's capabilities.
  107.  
  108. There is a nice integrated development environment (VIDE) written for V in
  109. the directory V\vide.  You may wish to compile that next to
  110. get going with your own V apps.
  111.  
  112. To test out the OpenGL capabilities, try compiling any of the apps
  113. in the V\vopengl\ directory.  Use the included makefile.os2 with gmake to 
  114. build each app.
  115.  
  116.  
  117. IBM Visual Age C++ 3.0
  118. ======================
  119.  
  120. In V\ibmcpp you'll find makefiles for the V lib (v.mak and vopengl.mak) 
  121. and the included sample applications (vtest.mak, vide.mak, etc.)
  122.  
  123. 1) Edit cfgibm.mkh for your system.  Further helpful hints can
  124. be found in the file itself.
  125.  
  126. 2) Build the V library.  If you intend to use OpenGL and have 
  127. installed it on your system use the vopengl.mak file, otherwise
  128. use the v.mak file.
  129.  
  130. OpenGL not wanted:
  131. -----------------
  132. nmake DEBUG=1 /f v.mak        builds the debug basic V library
  133. nmake /f v.mak                builds the release basic V library
  134.  
  135. OpenGL wanted:
  136. -------------
  137. nmake DEBUG=1 /f vopengl.mak  builds the debug openGL V library
  138. nmake /f vopengl.mak          builds the release openGL V library
  139.  
  140. (Note: Use Selective Install in OS/2 System Tools if you want to install 
  141.        OpenGL on your system)
  142.  
  143. These makefiles will not work for Gnu make, make sure you use IBM's nmake!!  
  144.  
  145. If that goes okay, the library will be placed in V\lib\os2, and the
  146. object files in V\obj\os2\ibmcpp
  147.  
  148.  
  149. 3) Build the test application.
  150.  
  151. nmake DEBUG=1 /f vtest.mak  builds the debug version of vtest.exe
  152. nmake /f vtest.mak          builds the release version of vtest.exe
  153.  
  154. Go to the V\bin\os2\ibmcpp directory and you should find vtest.exe.
  155. Run the vtest.exe application to get a demonstration of some of
  156. V's capabilities.
  157.  
  158. There is a nice integrated development environment (IDE) written for V in
  159. the directory V/vide.  You may wish to compile that next (vide.mak) to
  160. get going with your own V apps.
  161.  
  162. To test out the OpenGL capabilities, try compiling any of the apps
  163. in the V\vopengl\ directory (vshapes.mak, vbounce.mak, etc).
  164.  
  165.  
  166. Watcom C++ for OS/2
  167. ===================
  168.  
  169. An incomplete and out-of-date (v1.17) makefile can be found in the
  170. directory V\WATOS2.  The included makefile here is for compiling the
  171. V library. They were provided by a third party and I cannot give any
  172. support since I do not have Watcom myself.  Since they are for v1.17, 
  173. you will also need to add several new source files to successfully compile
  174. the main library for v1.21.  Those files are vstartup.cpp, vos.cpp, 
  175. vpopmenu.cpp, vslist.cpp, and optionally vbglcnv.cpp (this is the 
  176. OpenGL canvas).
  177.  
  178. Once you have built the main V library, you should proceed
  179. to the V\test directory and build the testapp application 
  180. demonstrating V's capabilities.  At present I do not have 
  181. any makefiles for that.
  182.  
  183. There is a nice integrated development environment (IDE) written for V in
  184. the directory V/vide.  You may wish to compile that next to
  185. get going with your own V apps.
  186.  
  187. To test out the OpenGL capabilities, try compiling any of the apps
  188. in the V\vopengl\ directory.  
  189.  
  190.  
  191. Debugging
  192. =========
  193.  
  194. V includes a built-in configurable debugging system that is described
  195. fully in the V users guide.  In the X port, the debugging output is
  196. written to stderr using printf.  In Windows and OS/2, printf does not
  197. work and so it would seem the debugging routines are pretty much
  198. useless.  While this is true for Windows, there is a workaround for
  199. OS/2.  The public domain program PMPRINTF, written by Mike Cowlishaw of
  200. IBM, will allow debug output to be viewed in a separate PM window as
  201. your V program executes.
  202.  
  203.  
  204. Jon Hacker
  205. V port to OS/2
  206. Mar 12/99.
  207.  
  208.  
  209. For technical support join the V users mailing list.
  210.  
  211. To subscribe send a mail with the subject "subscribe" to 
  212. vgui-discuss-REQUEST@other.debian.org. For regular
  213. submission please use vgui-discuss@other.debian.org. The list 
  214. will be archived on www.debian.org/Lists-Archives/ 
  215.