Browse Source

add instructions for using nmake

David Rose 21 years ago
parent
commit
a178f2f9a5
1 changed files with 30 additions and 16 deletions
  1. 30 16
      doc/INSTALL

+ 30 - 16
doc/INSTALL

@@ -528,6 +528,17 @@ or in bash:
   PANDA_ROOT='C:\Cygwin'
   PANDA_ROOT='C:\Cygwin'
   export PANDA_ROOT
   export PANDA_ROOT
 
 
+(In fact, you do not actually have to set PANDA_ROOT if Cygwin is
+installed into C:\Cygwin, since this is Panda's default behavior if
+C:\Cygwin exists.  But it's important to understand what Panda is
+doing to remap directories, and in particular that there is no
+relationship to any actual Cygwin mount points.)
+
+There is one additional point: you will need to ensure that the Visual
+Studio command-line utilities (like cl.exe) are available on your
+path.  Set your path appropriately to point to them, if necessary (or
+run vcvars32.bat to do it for you; see the paragraph below.)
+
 Follow the instructions under HOW TO BUILD PANDA FOR A UNIX
 Follow the instructions under HOW TO BUILD PANDA FOR A UNIX
 ENVIRONMENT, above.
 ENVIRONMENT, above.
 
 
@@ -535,14 +546,17 @@ ENVIRONMENT, above.
 
 
 HOW TO BUILD PANDA ON A WINDOWS SYSTEM, WITHOUT CYGWIN
 HOW TO BUILD PANDA ON A WINDOWS SYSTEM, WITHOUT CYGWIN
 
 
-Note: although Panda can be built without Cygwin, for the moment we
-have dropped support for the Microsoft nmake program (which is not
-really supported by Microsoft either).  Thus, even though you do not
-need to have all of Cygwin installed, you will need to have at least
-GNU make, as well as a few associated tools.  These programs are
-available from Cygwin (make.exe, sh.exe, cp.exe, rm.exe); you can copy
-these programs from someone who has installed Cygwin.  You will also
-need the support DLL, cygwin1.dll.
+You will have to make sure that you installed the command-line
+utilities on your system path when you installed Visual Studio, or you
+can run the batch file vcvars32.bat to put these utilities on your
+path for the current session (this batch file is in a directory like
+c:\Program Files\Microsoft Visual Studio .Net\Vc7\bin).
+
+Microsoft provides a command-line make utility with Visual Studio
+called nmake, although it's nowhere near as robust as the GNU make
+utility provided with Cygwin.  But Panda can generate Makefiles that
+follow the nmake convention, and will do so by default if your
+ppremake was not built with the Cygwin tools.  
 
 
 You will need a directory for holding the installed Panda.  This can
 You will need a directory for holding the installed Panda.  This can
 be anywhere you like; the default is C:\Panda3d.  If you choose to
 be anywhere you like; the default is C:\Panda3d.  If you choose to
@@ -614,16 +628,16 @@ way you expect.
 Now that you have run ppremake, you can build the Panda3D sources.
 Now that you have run ppremake, you can build the Panda3D sources.
 Begin with dtool (the current directory):
 Begin with dtool (the current directory):
 
 
-  make
-  make install
+  nmake
+  nmake install
 
 
 Once you have successfully built and installed dtool, you can then
 Once you have successfully built and installed dtool, you can then
 build and install panda:
 build and install panda:
 
 
   cd \Panda3d\panda
   cd \Panda3d\panda
   ppremake
   ppremake
-  make
-  make install
+  nmake
+  nmake install
 
 
 After installing panda, you are almost ready to run the program
 After installing panda, you are almost ready to run the program
 "pview," which is a basic model viewer program that demonstrates some
 "pview," which is a basic model viewer program that demonstrates some
@@ -636,8 +650,8 @@ if you intend to use the Python interfaces.
 
 
   cd \Panda3d\direct
   cd \Panda3d\direct
   ppremake
   ppremake
-  make
-  make install
+  nmake
+  nmake install
 
 
 And you may build pandatool.  You only need to build this if you want
 And you may build pandatool.  You only need to build this if you want
 to take advantage of model conversion utilities for Panda like
 to take advantage of model conversion utilities for Panda like
@@ -645,8 +659,8 @@ maya2egg and egg2bam, or if you want to use other tools like pstats.
 
 
   cd \Panda3d\pandatool
   cd \Panda3d\pandatool
   ppremake
   ppremake
-  make
-  make install
+  nmake
+  nmake install