Changeset 26339

Timestamp:

2007-02-04 15:56:47 (4 years ago)

Author:

res2002

Message:

Made a few tweaks to the VC compile faq.

Files:

• CS/trunk/docs/texinfo/build/platform/win32/msvc/msvc7.txi (modified) (3 diffs)

CS/trunk/docs/texinfo/build/platform/win32/msvc/msvc7.txi

@@ -218 +218 @@
 the project.
 
-@subsubheading Compilation
-
-@itemize @bullet
+@subsubheading Building
+
+@itemize @bullet
+@item
+Q1. @emph{I'm using the Visual C++ 2005 Express Edition and I get a lot of 
+``file not found'' errors for @file{windef.h} and others. What is wrong?}
+Q2. @emph{I'm using the Visual C++ 2005 Express Edition and I get a lot of 
+``unresolved symbol'' errors for names like 
+@code{SHGetSpecialFolderLocation@@12}. What is wrong?}
+
+A. These errors indicate a lacking or an incomplete installation of the 
+Platform SDK. Exactly follow the instructions given on Microsoft's 
+``Using Visual C++ 2005 Express Edition with the Microsoft Platform SDK'' 
+page:
+@ifnottex
+@uref{http://msdn.microsoft.com/vstudio/express/visualc/usingpsdk/}
+@end ifnottex
+@iftex
+@code{http://msdn.microsoft.com/vstudio/express/visualc/usingpsdk/}
+@end iftex
+Also, the instructions don't say that, but if you have Visual C++ open while 
+applying those changes you need to restart it. 
+
 @item 
 Q. @emph{I get "Errors in post link" and later "file not found" errors.}
@@ -237 +257 @@
 compile it yourself if you prefer.  @xref{External Libraries}.
 
-The resources from these packages should be placed in the following locations.
+@item
+Q. @emph{Where are the files @file{libpng.lib} and @file{zlib.lib}?}
+
+A. Just look above at the question about @file{zlib.h} and @file{png.h}.
+It's the same problem, and if you have already done what is explained there,
+I can't do much for you!
+
+@item
+Q. @emph{I've got unresolved symbols.}
+
+A. What kind of symbols?
+
+@itemize @minus
+@item
+@samp{_png_@dots{}}: That means that you don't link the project with
+@file{libpng.lib}.  Just take a look below where it is explained how to do so.
+
+@item
+@samp{_inflate@dots{}} and @samp{_deflate@dots{}}: Well, it seems to your
+project lacks @file{zlib.lib}.  The trick is explained just below, so hang on.
+
+@item
+@samp{_DirectDraw@dots{}}: Same as above, but for @file{ddraw.lib} (DirectX
+component), look below.
 
 @item
@@ -253 +296 @@
 A. Turning off precompiled headers tends to save a large amount of file space
 while increasing build times somewhat.
-@end itemize
-
-@subsubheading Linking
-
-@itemize @bullet
-@item
-Q. @emph{Where are the files @file{libpng.lib} and @file{zlib.lib}?}
-
-A. Just look above at the question about @file{zlib.h} and @file{png.h}.
-It's the same problem, and if you have already done what is explained there,
-I can't do much for you!
-
-@item
-Q. @emph{I've got unresolved symbols.}
-
-A. What kind of symbols?
-
-@itemize @minus
-@item
-@samp{_png_@dots{}}: That means that you don't link the project with
-@file{libpng.lib}.  Just take a look below where it is explained how to do so.
-
-@item
-@samp{_inflate@dots{}} and @samp{_deflate@dots{}}: Well, it seems to your
-project lacks @file{zlib.lib}.  The trick is explained just below, so hang on.
-
-@item
-@samp{_DirectDraw@dots{}}: Same as above, but for @file{ddraw.lib} (DirectX
-component), look below.
-
-@item
-Any others: Well, I always have a solution, but this one is more difficult.  It
-seems that there is a missing source file in your project.  But the question
-is, which source file?  If it isn't obvious by the name of the functions, just
-to the following: In the menu @emph{Edit}, select the option @emph{Find in
-Files@dots{}}.  Put the name of the function in the field ``Find What'', check
-that the ``In Folder'' field content is the Crystal Space source directory and
-press @emph{Find}.  You should get a bunch of files, many of them just making a
-call to the function.  But there is surely one which contains the definition of
-the function.  Look at the position of the file where it is defined, and add it
-to the project (menu @emph{Project/Add To Project/Files}).
-
-In order to add (or remove) a library for the link process, invoke the
-@emph{Project/Settings/Link} menu item, then select the ``General'' category
-tab..  There is a field called ``Object/Library Modules'' that lists all the
-libraries added to the project at link time.
-@end itemize
-@end itemize
-
-OK, now it should link.  So you should have an executable file called
-@file{walktest.exe} in your src directory.  Let's run it!
+
+@item
+Any others: It seems that there is a missing source file in the project.  
+
+For Crystal Space the MSVC project files are generated once every 24 hours, so 
+normally all missing sources should have been added after that time.  If you
+can't wait that long, or the file is still missing, contact one of the Crystal
+Space developers.
+
+For third party projects it's usually the best idea to contact one of it's
+developers, they should be able to tell you which file is missing.
 
 @subsubheading Executing