[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
A few minor changes to the tutorials
and the new cdt_c_makefile.htm
Dave Williams
Technical Writer
Rational Software
IBM Software Group
(613) 591-2962Index: concepts/cdt_c_makefile.htm
===================================================================
RCS file: /home/tools/org.eclipse.cdt.doc.user/concepts/cdt_c_makefile.htm,v
retrieving revision 1.1
diff -u -r1.1 cdt_c_makefile.htm
--- concepts/cdt_c_makefile.htm 24 Jun 2004 10:49:13 -0000 1.1
+++ concepts/cdt_c_makefile.htm 24 Jun 2004 15:16:18 -0000
@@ -77,9 +77,9 @@
# It says how to create a file with a .o suffix, given a file with a .cpp suffix.
# The rule's command uses some built-in Make Macros:
# $@ for the pattern-matched target
-# $< for the pattern-matched dependency
+# $lt; for the pattern-matched dependency
%.o : %.cpp
- g++ -g -o $@ -c $<
+ g++ -g -o $@ -c $<
# These are Dependency Rules, which are rules without any command.
# Dependency Rules indicate that if any file to the right of the colon changes,
@@ -94,7 +94,7 @@
# Alternatively to manually capturing dependencies, several automated
# dependency generators exist. Here is one possibility (commented out)...
# %.dep : %.cpp
-# g++ -M $(FLAGS) $< > $@
+# g++ -M $(FLAGS) $< > $@
# include $(OBJS:.o=.dep)
</pre>
@@ -102,33 +102,33 @@
<h2>Frequently Asked Questions:</h2>
Your Console view can be very useful for debugging a build.
-<p><font size="+1"><b>Q1</b>. My Console view says <tt>âError launching builderâ?</tt>. What does that mean?<p></font>
+<p><font size="+1"><b>Q1</b>. My Console view says <tt>âError launching builderâ?</tt>. What does that mean?<p></font>
<pre>
Error launching builder (make âk clean all )
(Exec error:Launching failed)
</pre>
-<p>Most probably, the build command (by default âmakeâ?) is not on your path. You can put it on your path and restart Eclipse.<br>
-You can also change the build command to something that is on your path. If you are using MinGW tools to compile, you should replace the build command with âmingw32-makeâ?.</p>
+<p>Most probably, the build command (by default âmakeâ?) is not on your path. You can put it on your path and restart Eclipse.<br>
+You can also change the build command to something that is on your path. If you are using MinGW tools to compile, you should replace the build command with âmingw32-makeâ?.</p>
-<p><font size="+1"><b>Q2</b>. My Console view says <tt>âNo rule to make target âXââ?</tt>.</p></font>
+<p><font size="+1"><b>Q2</b>. My Console view says <tt>âNo rule to make target âXââ?</tt>.</p></font>
<pre>
make -k clean all
make: *** No rule to make target `clean'.
make: *** No rule to make target `all'.
</pre>
-<p>By default, the make program looks for a file most commonly called âMakefileâ? or âmakefileâ?. If it cannot find such a file in the working directory, or if that file is empty or the file does not contain rules for the command line goals (âcleanâ? and âallâ? in this case), it will normally fail with an error message similar to those shown. </p>
+<p>By default, the make program looks for a file most commonly called âMakefileâ? or âmakefileâ?. If it cannot find such a file in the working directory, or if that file is empty or the file does not contain rules for the command line goals (âcleanâ? and âallâ? in this case), it will normally fail with an error message similar to those shown. </p>
<p>If you already have a valid Makefile, you may need to change the working directory of your build. The default working directory for the build command is the projectâs root directory. You can change this by specifying an alternate Build Directory in the Make Project properties.
Or, if your Makefile is named something else (eg. <tt>buildFile.mk</tt>), you can specify the name by setting the default Build command to <tt>make âf buildFile.mk</tt>.</p>
<p>If you do not have a valid Makefile, create a new file named Makefile in the root directory. You can then add the contents of the sample Makefile (above), and modify it as appropriate.</p>
-<p><font size="+1"><b>Q3</b>. My Console view says <tt>âmissing separatorâ?</tt>.</p></font>
+<p><font size="+1"><b>Q3</b>. My Console view says <tt>âmissing separatorâ?</tt>.</p></font>
<pre>
make -k clean all
makefile:12: *** missing separator. Stop.
</pre>
-<p>The standard syntax of Makefiles dictates that every line in a build rule must be preceded by a Tab character. This Tab character is often accidentally replaced with spaces, and because both result in white-space indentation, this problem is easily overlooked. In the sample provided, the error message can be pinpointed to line 12 of the file âmakefileâ?; to fix the problem, insert a tab at the beginning of that line.</p>
+<p>The standard syntax of Makefiles dictates that every line in a build rule must be preceded by a Tab character. This Tab character is often accidentally replaced with spaces, and because both result in white-space indentation, this problem is easily overlooked. In the sample provided, the error message can be pinpointed to line 12 of the file âmakefileâ?; to fix the problem, insert a tab at the beginning of that line.</p>
<p><font size="+1"><b>Q4</b>. My Console view says <tt>"Target `all' not remade because of errors"</tt>.</p></font>
<pre>
@@ -153,7 +153,7 @@
This is helpful for build large projects.</p>
<p>You can remove the -k flag by turning on Project Properties > C/C++ Make Project > Make Builder > Stop on first build error</p>
-<p><font size="+1"><b>Q6</b>. My Console view looks like:</b></font>
+<p><font size="+1"><b>Q6</b>. My Console view looks like:</p></font>
<pre>
mingw32-make clean all
process_begin: CreateProcess((null), rm -f Test1.o Test2.o Main.o test_me.exe, ...) failed.
@@ -168,11 +168,11 @@
clean :
-del $(REBUILDABLES)
echo Clean done
-<pre></p>
+</pre></p>
<p>The leading minus sign tells make to consider the clean rule to be successful even if the del command returns failure. This may be acceptable since the del command will fail if the specified files to be deleted do not exist yet (or anymore).</p>
<p><img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" ></p>
</body>
-</html>
+</html>
\ No newline at end of file
Index: getting_started/cdt_w_basic.htm
===================================================================
RCS file: /home/tools/org.eclipse.cdt.doc.user/getting_started/cdt_w_basic.htm,v
retrieving revision 1.7
diff -u -r1.7 cdt_w_basic.htm
--- getting_started/cdt_w_basic.htm 24 Jun 2004 10:49:13 -0000 1.7
+++ getting_started/cdt_w_basic.htm 24 Jun 2004 15:16:18 -0000
@@ -152,7 +152,7 @@
<body>
<h2>CDT Managed Make Tutorial</h2>
<center>
-<IFRAME name=textFrame SRC="cdt_w_basic01.htm" TITLE="cdt_w_basic Text" MARGINWIDTH=0 MARGINHEIGHT=0 width=800 height=180 frameborder=0 SCROLLING=auto></IFRAME>
+<IFRAME name=textFrame SRC="cdt_w_basic01.htm" TITLE="cdt_w_basic Text" MARGINWIDTH=0 MARGINHEIGHT=0 width=800 height=200 frameborder=0 SCROLLING=auto></IFRAME>
<table width="600px" border="0" cellspacing="0" summary="">
<tr>
<td><img src="../images/trans.gif" align="left" width="22" height="22" onClick="goBack();" title="" name="back"></td>
Index: getting_started/cdt_w_standard.htm
===================================================================
RCS file: /home/tools/org.eclipse.cdt.doc.user/getting_started/cdt_w_standard.htm,v
retrieving revision 1.4
diff -u -r1.4 cdt_w_standard.htm
--- getting_started/cdt_w_standard.htm 24 Jun 2004 10:49:13 -0000 1.4
+++ getting_started/cdt_w_standard.htm 24 Jun 2004 15:16:18 -0000
@@ -3,7 +3,7 @@
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
- <title>C/C++ Development Toolkit (CDT) Standard Make Tutorial</title>
+ <title>CDT Standard Make Tutorial</title>
<link rel="stylesheet" type="text/css" href="../help.css">
<script language="JavaScript">
@@ -167,7 +167,7 @@
<body>
<h2>CDT Standard Make Tutorial</h2>
<center>
-<IFRAME name=textFrame SRC="cdt_w_standard01.htm" TITLE="cdt_w_standard Text" MARGINWIDTH=0 MARGINHEIGHT=0 width=800 height=150 frameborder=0 SCROLLING=auto></IFRAME>
+<IFRAME name=textFrame SRC="cdt_w_standard01.htm" TITLE="cdt_w_standard Text" MARGINWIDTH=0 MARGINHEIGHT=0 width=800 height=200 frameborder=0 SCROLLING=auto></IFRAME>
<table width="600px" border="0" cellspacing="0" summary="">
<tr>
<td><img src="../images/trans.gif" align="left" width="22" height="22" onClick="goBack();" title="" name="back"></td>
Index: getting_started/cdt_w_standard11.htm
===================================================================
RCS file: /home/tools/org.eclipse.cdt.doc.user/getting_started/cdt_w_standard11.htm,v
retrieving revision 1.3
diff -u -r1.3 cdt_w_standard11.htm
--- getting_started/cdt_w_standard11.htm 21 Jun 2004 10:33:03 -0000 1.3
+++ getting_started/cdt_w_standard11.htm 24 Jun 2004 15:16:18 -0000
@@ -9,8 +9,7 @@
<body>
<h3>Discovery Options</h3>
<p>Click the <b>Discovery Options</b> tab. This page defines the configuration for autodiscovery of include paths and preprocessor symbols for the parser which
-enables the parser to understand the contents of the C/C++ source code so that you may more effectively use the search and code completion features.
-Include paths are also used by the builder to locate files that are not in the workspace.</p>
+enables the parser to understand the contents of the C/C++ source code so that you may more effectively use the search and code completion features. </p>
<p>Select the <b>Automate scanner configuration discovery</b> checkbox to configure the scanner discovery to run automatically.</p>
</body>
Index: getting_started/cdt_w_standard17.htm
===================================================================
RCS file: /home/tools/org.eclipse.cdt.doc.user/getting_started/cdt_w_standard17.htm,v
retrieving revision 1.3
diff -u -r1.3 cdt_w_standard17.htm
--- getting_started/cdt_w_standard17.htm 21 Jun 2004 10:33:03 -0000 1.3
+++ getting_started/cdt_w_standard17.htm 24 Jun 2004 15:16:18 -0000
@@ -14,7 +14,8 @@
<body>
<h3>Enter the make script</h3>
-<p>Enter the build instruction for your <a href="javascript:void(0)" onClick="newWin('make_example.htm')" title="Click here to get the code">makefile</a> that was just created.
+<p>Enter the build instruction for your <a href="javascript:void(0)" onClick="newWin('make_example.htm')" title="Click here to get the code">makefile</a> that was just created.
+The Outline view will display the structure of the makefile as you add components.
When you enter the code you will notice an asterisk in front of the file name on the tab in the <b>Editor</b> view, this tells you the file changed but has not been saved.</p>
<p><i>Note: Ensure you have tabs, not spaces before your indented code, as </i><tt>make</tt><i> will not accept spaces before commands.</i></p>
Index: getting_started/cdt_w_standard24.htm
===================================================================
RCS file: /home/tools/org.eclipse.cdt.doc.user/getting_started/cdt_w_standard24.htm,v
retrieving revision 1.3
diff -u -r1.3 cdt_w_standard24.htm
--- getting_started/cdt_w_standard24.htm 24 Jun 2004 10:49:13 -0000 1.3
+++ getting_started/cdt_w_standard24.htm 24 Jun 2004 15:16:18 -0000
@@ -9,9 +9,9 @@
<body>
<h3>Run Configuration</h3>
-<p>You should now see the <b>Run Configurations</b> dialog box, navigate to the project in the <b>Configurations:</b> view, and then click <b>New</b>.
-This will create your Run Configuration.</p>
-
+<p>You should now see the <b>Run Configurations</b> dialog box, navigate to the <b>Configurations:</b> view, and then double click <b>C/C++ Local</b>.
+This will create your Run Configuration. Select the new Run Configuration in the <b>Configurations:</b> view.</p>
+<p>Now click the <b>Main</b> tab and then the <b>Search</b> button.</p>
</body>
Index: getting_started/cdt_w_standard25.htm
===================================================================
RCS file: /home/tools/org.eclipse.cdt.doc.user/getting_started/cdt_w_standard25.htm,v
retrieving revision 1.3
diff -u -r1.3 cdt_w_standard25.htm
--- getting_started/cdt_w_standard25.htm 21 Jun 2004 10:33:03 -0000 1.3
+++ getting_started/cdt_w_standard25.htm 24 Jun 2004 15:16:18 -0000
@@ -8,7 +8,7 @@
</head>
<body>
<h3>Run Configuration</h3>
-<p>Select the new Run Configuration in the <b>Configurations:</b> view and click the <b>Main</b> tab. This is where you select your C/C++ Application.</p>
+<p>Select the new Run Configuration in the <b>Configurations:</b> view and click the <b>Main</b> tab. This is where you select your C/C++ application and other settings that will impact how your application is run.</p>
</body>
</html>
Index: getting_started/make_example.htm
===================================================================
RCS file: /home/tools/org.eclipse.cdt.doc.user/getting_started/make_example.htm,v
retrieving revision 1.1
diff -u -r1.1 make_example.htm
--- getting_started/make_example.htm 15 May 2004 20:50:33 -0000 1.1
+++ getting_started/make_example.htm 24 Jun 2004 15:16:18 -0000
@@ -9,8 +9,7 @@
<font color="#0066ff">Copy the script below and paste it into the <b>makefile</b> file in the Editor View:</font>
<pre>
-makefile:
- all: hello
+all: hello
clean:
-rm main.o hello.exe hello
