From 08a553b24e13fef30adb4aac3f349416615469e9 Mon Sep 17 00:00:00 2001 From: Kevin Koch Date: Wed, 23 Jan 2008 21:26:49 +0000 Subject: [PATCH] Update build instructions to indicate PATH ordering; add troubleshooting tip about nmake versions Target_Version: 1.7 Ticket: 5859 Tags: pullup git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@20210 dc483132-0cff-0310-8789-dd5450dbe970 --- src/windows/build/bkw-automation.html | 29 ++++++++++++++++++--------- 1 file changed, 20 insertions(+), 9 deletions(-) diff --git a/src/windows/build/bkw-automation.html b/src/windows/build/bkw-automation.html index 5e21ba570..9592f49af 100644 --- a/src/windows/build/bkw-automation.html +++ b/src/windows/build/bkw-automation.html @@ -6,7 +6,8 @@ - + +
The @@ -80,8 +81,8 @@

perl must be installed so that .pl files are automatically executed with perl. The ActivePerl installation will do this for you.

In the INCLUDE path, the Microsoft Platform SDK must come before the Microsoft - Visual C++ include files. Using a Platform SDK Build Environment window will - set this up the right way. 

+ Visual C++ include files. In the PATH path, the Platform SDK bin area must come before the Visual Studio VC\bin area. Using a Platform SDK Build Environment window will + set this up the right way.  Make sure to use a Platform SDK Windows XP Build Environment shell.

If you make your path modifications permanent via Control Panel / System / Advanced / Environment Variables:  If you use a Platform SDK Build Environment window, it appears that you need to put your PATH components in the @@ -291,7 +292,7 @@ Default is bkw.pl.log.
  will substitute %bldtype% with either dbg or rel, depending on the build type. 

-
+

Example

Here is a copylist entry.  Each segment of the file's path that comes @@ -299,7 +300,7 @@ Default is bkw.pl.log.
 

Release build.  Config file:

- +
@@ -313,7 +314,7 @@ Default is bkw.pl.log.
  -
<BKW_Config>
<src value ="C:\bkw" />
+

Copylist comments:

<!-- File from paths are relative to @@ -349,8 +350,18 @@ Default is bkw.pl.log.
 

Can't clean directory; can't delete file or directory
Make sure a file in the named directory isn't open in another application.

-

Can't find kerberos.ver
- You skipped the repository step and are trying to build in an empty directory.

-
+

Can't find kerberos.ver
+ You skipped the repository step and are trying to build in an empty directory.

+

Directories don't exist or can't be created
+
This can be a symptom of the Platform SDK bin area not being before the Visual Studio bin areas, such that the version of nmake running is version 8.x.
+
[This explanation courtesy of Jeff Altman]:
+ nmake V8 appears to favor executables over shell commands. As a result, using 'mkdir' instead of 'md' in Makefiles, as a command for creating directory trees, fails when the Cygwin mkdir.exe is present in the PATH. Changing the

+

MKDIR=mkdir
+ RMDIR=rmdir

+

macros in the Makefiles to

+

MKDIR=md
+ RMDIR=rd

+

should make the shell versions execute in all cases.

+
-- 2.26.2