Initial Commit

Author: jonathanwindsormoore

docs/building/windows2003.html

@@ -265,6 +265,48 @@ <h2>Lab07: Internet Information Services/COM+</h2>:
 	</pre>
 	<pre>build -cz</pre>
 	<pre>delobj.cmd to clean the source tree</pre>
+
+<h2>This topic provides examples of using BinPlace from the command-line.</h2>
+
+<p>First, you can set the root destination directory as follows:</p>
+
+<pre>set _NTTREE=d:\ProjectRoot</pre>
+
+<p>Then you can set the place file's path and file name in the following way:</p>
+
+<pre>set BINPLACE_PLACEFILE=d:\mystuff\myplacefile.txt</pre>
+
+<p>Let the contents of the file d:\mystuff\myplacefile.txt be as follows:</p>
+
+<pre>; This is a simple place file.
+commonmodule.dll   retail
+application.exe    files\bin
+mydriver.sys       *\drivertree
+extra.cab          appendix
+</pre>
+
+<p>Now you can run BinPlace with the following command:</p>
+
+<pre>binplace g:\somelocation\extra.cab</pre>
+
+<p>Because extra.cab is not an executable file, BinPlace will only move it. The root destination directory is d:\projectroot. The class directory for this file is specified in the place file as appendix. The file-type subdirectory is cab (the file name extension of the file being moved). Thus, this file is copied to the location d:\projectroot\appendix\cab\extra.cab.</p>
+
+<p>Now use BinPlace on the executable file and its symbol file. To do this, you specify the executable file name -- BinPlace will find the associated symbol file.</p>
+
+<p>When you pass an executable file name to BinPlace, it looks for its symbol files in the same directory as the executable file. If it does not find them there, it reads the CodeView record stored in the executable file; if it finds a symbol file path in that record, it looks for symbol files in that path.</p>
+
+<p>Note If you specify a symbol file name explicitly, BinPlace will merely move it, not process it.</p>
+
+<pre>binplace -a -x -s d:\stripped -n g:\full g:\builddir\application.exe</pre>
+
+<p>The executable file uses the same root destination directory as before. Its class directory is files\bin. Thus, it is placed in d:\projectroot\files\bin\application.exe.</p>
+
+<p>The symbol file is placed in two locations. The full symbol file (including both private and public symbols) goes to g:\full\files\bin\exe\application.pdb. The stripped symbol file (containing only public symbols) goes to d:\stripped\files\bin\exe\application.pdb.</p>
+
+<p>Now, use a similar command on commonmodule.dll:</p>
+
+<pre>binplace -a -x -s d:\stripped -n g:\full g:\builddir\commonmodule.dll</pre>
+
 <p>build individual projects</p>
 <pre>in the directory of a makefile with build -cz</pre>
 <p> or </p>