See howto.install_panda_on_windows.txt instead

panda/src/doc/howto.install_panda_on_windows.cygwin-1.0

@@ -1,249 +0,0 @@
-WARNING: This document is an internal VR Studio document describing
-how to set up Panda on a new PC using our internal development
-environment.  It is not useful for programmers who are not within the
-VR Studio firewall.
-
-If you are looking for documentation on installing Panda for the rest
-of the world, see INSTALL in the root directory of the panda3d tree
-(or in the doc CVS module).
-
-
-
-
-To install Panda3D on WinNT/Win2000/Win98:
--------------------------------------
-Notes:
-  Lines preceeded by ">" are instructions to be typed on the command line. 
-  On WinNT, make sure your system clock is not set to GMT (only worry about
-    this if your makedepend seems out of sync, i.e. you constantly reinstall
-    old files over more current ones).
-  Opengl appears to be installed with the os for both WinNT and Win98, but I
-    read somewhere that we might want to do our own version control for
-    this eventually using "VerInstallFile" to install our own version of
-    OpenGl.
-  "Touch" doesn't quite work properly on WinNT or Win98 currently.
-  Make sure you run ftp in "binary" mode to fetch tarballs.
-  "ftp" doesn't currently read "backspace" in rxvt, so you'll just have to be
-    precise at the ftp prompt for now ("delete" doesn't work either).
-    If this really bugs you, you can create a shortcut on the Desktop to
-    "tcsh.exe" and run ftp properly from there rather than from rxvt.
-  Occasionally, a freshly opened shell will hang in the middle of
-    attaching or something.  This appears to be a race condition in
-    cshrc that appears only on multiprocessor machines.  If this
-    happens, go ahead and kill the tcsh process (or ftp or rxvt
-    process) using the Task Manager and try again.
-  Make sure your machine has enough disk space - I'd start with the largest
-    open space on any of your partitions.
-  Make sure your machine has networking (IP, gateway, etc.) so you can use
-    ftp to get to mother.
-    
-Step 0: Map network drive to build tools drive
-  - right click on Network Places, choose Map Network Drive
-  - Map Network Drive V: to \\dimbo\panda
-  - select reconnect drive at startup
-  - if this doesnt work, you can install the build tools from CD
-
-Step 1: Install Visual C++ (v6.0)
-  - Run V:\msvc-6.0\setup.exe, or install from CD.  
-    For a faster install, select custom install and uncheck everything
-    but Visual C++, Data Access, ActiveX, and Tools
-  - On WinNT, you will be prompted to register environment variables for
-    running the compiler from the command line - do it.
-  - Install MSVC Service Pack 5 by running V:\msvc-sp5\setupsp5.exe, or from CD
-    You may need to run v:\msvc-sp5\mdac_typ.exe first (setup will tell you if so)
-  - Install the MSDN Library documentation if this is a primary dev machine.
-    Install from CD, or by running V:\msdn-apr01\setup.exe.  To save time and
-    disk space, choose custom install and uncheck everything but Text-Search 
-    Index, VC++, Platform SDK, Knowledge Base, and All Other Files.
-  
-Step 2: Install MS Platform SDK to get updated VC libs and headers
-  - Install MS Platform SDK MSDN CD in default location. 
-  - Run v:\platform-sdk\setup.exe to install the Feb 2001 Platform SDK. 
-    (there may be problems with other versions of the Platform SDK) 
-    This should prepend the Platform SDK paths to your PATH,INCLUDE, and
-    LIB dirs.  Building libpandadx requires this step (needs DX7 headers/libs)
-
-Step 3: Install Cygwin (v1.0)
-  - Install Cygwin by running V:\cygwin-1.0\setup.exe, or from CD
-  - Open up a shell by running (and, if you desire, creating a shortcut to)
-    tcsh.exe in: 
-       C:/Cygwin/contrib/bin 
-    Alternately, you can run a bash shell by going to the "Start"
-    button at the bottom left of your screen, selecting "Programs",
-    "Cygwin" and "bash".  You can then run "tcsh" at the bash prompt to make 
-    things easier.  
-  - Set up the Cygwin environment:
-    - Check for directories /bin /etc /tmp /usr and create them using 
-      mkdir if they don't exist.  
-    - Make the following directories:
-      > mkdir /c /f /g /h /i /j /v
-      > mkdir /msvc98 /mscommon /mspsdk
-      > mkdir /usr/local
-      > mkdir /usr/local/bin
-      > mkdir /usr/local/etc
-    - Create some links expected by the attach scripts:
-      > ln -s /contrib/bin/tcsh /bin/csh
-      > ln -s /contrib/bin/perl /usr/local/bin/perl
-      > ln -s /bin/bash /usr/local/bin/bash
-    - Connect the network drives:
-      > net use f: "\\nufat\fat" /persistent:yes
-      > net use g: "\\nufat\bit" /persistent:yes
-      > net use h: "\\dimbo\usr2" /persistent:yes
-      > net use i: "\\nufat\big" /persistent:yes
-      > net use j: "\\nufat\for" /persistent:yes
-      > net use v: "\\dimbo\panda" /persistent:yes
-    - Mount directories.  Note the use of -b for the unix mounts. The
-      VC++ mounts assume VC++ was installed in C:\Program Files:
-      > mount -s c:/ /c
-      > mount -s -b f:/ /f
-      > mount -s -b g:/ /g
-      > mount -s -b h:/ /h
-      > mount -s -b i:/ /i
-      > mount -s -b j:/ /j
-      > mount -s -b v:/ /v
-      > mount -s C:/Program\ Files/Microsoft\ Visual\ Studio/VC98 /msvc98
-      > mount -s C:/Program\ Files/Microsoft\ Visual\ Studio/Common /mscommon
-      > mount -s C:/Program\ Files/Microsoft\ Platform\ Sdk /mspsdk
-    - These are optional, but handy
-      > mkdir /fat
-      > mkdir /bit
-      > mkdir /fit
-      > mkdir /ful
-      > mkdir /alpha
-      > mkdir /beta
-      > mkdir /gamma
-      > mkdir /for
-      > mount -s -b F:/ /fat
-      > mount -s -b G: /bit
-      > mount -s -b H:/fit/ /fit
-      > mount -s -b H:/ful/ /ful
-      > mount -s -b I:/alpha/ /alpha
-      > mount -s -b I:/beta /beta
-      > mount -s -b I:/gamma /gamma
-      > mount -s -b J:/ /for
-
-Step 4: Create your home directory
-  - Create a HOME directory:
-    > mkdir /usr/<yourname>
-  - Set the $HOME environment variable:
-    - On WinNT use the Registry:
-      - Select "My Computer" icon from the desktop.
-      - Select "Control Panel" icon.
-      - Select "System" icon.
-      - Select "Environment" tab.
-      - Create the variable "HOME" with the value "/usr/<yourname>".
-      - click ok - ok - ok to exit (you must exit for the change to take 
-        effect)
-      - Now open a new shell to get the changes.
-    - On Win98 use AUTOEXEC.BAT:
-      - Add/Change the "HOME=/usr/<yourname>" line in C:\AUTOEXEC.BAT:
-      - Note: if you want to edit your existing AUTOEXEC.BAT, you need
-        to use "edit.exe" in order to generate the correct "newline"
-        character (^M).
-    - Note: We've seen a problem where we can't source ~/.cshrc if the home
-      directory /usr/<yourname> does not match the user name exactly. 
-      To be safe, be sure and name your home directory to be /usr/<yourname>.
-  - Copy important startup files into your home directory:
-    > cd /v/win/install/wintools/panda
-    > cp .cshrc .emacs Configrc Config.pp /usr/<yourname>
-  - Make sure the contents of .cshrc are correct for your setup.  In
-    particular, make sure the definition for PANDA_ROOT matches the
-    directory you have installed Cygwin to (normally C:\Cygwin), and
-    that CVSROOT is correct for your CVS login (if $USERNAME is not
-    the same as your CVS/Unix account name, edit the variable as
-    necessary).
-
-Step 5: Update /usr/local/etc:
-  - Copy vspec files from $WINTOOLS to /usr/local/etc
-    > cd /v/win/install/wintools
-    > cp_vspec 
-  - (Optional) Add new username to vspec files
-    - If you are setting up a new user, edit the *.vspec files
-      in /usr/local/etc to reflect the new username and path to the player
-      tree.  
-    - Also edit (on the SGI, for instance on mother) the file 
-      /fit/cvs/CVSROOT/passwd to add the new username as a valid user of
-      CVS.
-  - (Optional) Update default values in vspec files
-    - Edit appropriate *.vspec files to specify which trees you wish to use
-      as a default (e.g. install vs. minstall vs. personal)
-
-Step 6: Grab the cvs trees
-  - Open a new shell
-  - Create personal trees:
-    > cd ~
-    > mkdir player
-    > cd player
-    # Just hit return when prompted for a password
-    > cvs login
-    > cvs co dtool (only if local dtool will be built)
-    > cvs co panda (only if local panda will be built)
-    > cvs co direct (only if local direct will be built)
-    > cvs co toontown (only if local toontown will be built)
-  - Choose which optimize level you want. This is set in Config.pp in
-    your $HOME directory.  Look for #define OPTIMIZE and follow
-    instructions above that.  You can only choose an arbitrary
-    optimize level if you are building your own DTOOL and PANDA;
-    otherwise, you must set it to the optimize level corresponding to
-    the version of DTOOL/PANDA you intend to attach to (install is
-    built OPTIMIZE 2, release is built OPTIMIZE 3).
-
-Step 7: (Optional) Build $DTOOL
-  - When you opened a new shell in step 6, it should have attached
-    to $DTOOL:install automatically, but you will need to attach to your
-    own DTOOL if you want to build your own.
-    > cta dtool personal
-    > cd $DTOOL
-    > ppremake
-    > make install
-
-Step 8: (Optional) Build $PANDA 
-  - Build panda
-    > cta panda personal
-    > cd $PANDA
-    > ppremake
-    > make install
-  - You can now run "demo" to test the install and build - you should
-    see a window pop up with a triangle in it.  To see the triangle with
-    a texture on it, you'll need to be in $PANDA/src/all/testbed/ when
-    you run "demo".
-
-Step 9: Install Emacs
-  - get the tarball from /for/program/tarballs/emacs-20.7-fullbin-i386.tar.gz 
-  - untar/install (This will install emacs into C:/emacs-20.7, 
-    do not attempt to install it under a directory containing a space,
-    like "Program Files".)
-    > cd /c
-    > tar xvzf ~/emacs-20.7-fullbin-i386.tar.gz
-  - Copy lisp/script files
-    > cp $DIRECT/src/directscripts/python-mode.el /c/emacs-20.7/lisp/progmodes
-    > cp $DIRECT/src/directscripts/runPythonEmacs /usr/local/bin
-  - Update environment variables (win2000).  Note: You should only need to
-    do this if you intend to invoke Panda from a non-Cygwin prompt.  If you
-    will always be using Cygwin, simply edit your .cshrc file to extend the
-    path appropriately. 
-    - right click on your computer icon at the top left of the screen
-    - select "properties"
-    - click on the "Advanced" tab
-    - click on "Environment Variables..."
-    - double click on the "Path" variable in the bottom pane (system variables)
-    - add  C:\emacs-20.7\bin  to the end of the path (semicolon separated)
-    - click ok - ok - ok to exit (you must exit for the change to take effect)
-
-Step 10: Build $DIRECT
-  > cta direct personal
-  > cd $DIRECT
-  > ppremake
-  > make install
-
-Step 11: Build $TOONTOWN
-  > cta toontown personal
-  > cd $TOONTOWN
-  > ppremake
-  > make install
-
-Step 12: Generate Python Code
-  > cd $DIRECT/bin
-  > genPyCode win-debug (if you have built using OPTIMIZE = 1 or 2)
-  > genPyCode win-release (if you have built using OPTIMIZE = 3 or 4)
-