mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-04-23 06:32:10 +02:00
From Dave Williams: Doc updates to the reference section for:
new Discovery Problem Reporting option (3 changes) new Binary Parser section for New Managed Make Project Properties (1 addition and new screen captures for that section) updates to two concepts docs, the cdt_c_search.htm and cdt_c_makefile.htm which were showing some errors on certain characters
This commit is contained in:
David Daoust
parent
eea167e5c3
commit
2afbe7e5f4
16 changed files with 95 additions and 16 deletions
|
|
@ -3,7 +3,7 @@
|
|||
|
||||
<head>
|
||||
<meta http-equiv="Content-Language" content="en-us">
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||||
<title>Makefile</title>
|
||||
<link rel="stylesheet" type="text/css" href="../help.css">
|
||||
</head>
|
||||
|
|
@ -102,35 +102,43 @@ Test2.o : Test2.h
|
|||
<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 )
|
||||
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'.
|
||||
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>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>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>
|
||||
<p><font size="+1"><b>Q4</b>. My Console view says <tt>"Target 'all' not remade because of errors"</tt>.</p></font>
|
||||
<pre>
|
||||
make -k clean all
|
||||
make: *** [clean] Error 255
|
||||
|
|
@ -141,7 +149,7 @@ make: *** [Test2.o] Error 255
|
|||
make: *** [Main.o] Error 255
|
||||
g++ -g -o Test2.o -c Test2.cpp
|
||||
g++ -g -o Main.o -c Main.cpp
|
||||
make: Target `all' not remade because of errors.
|
||||
make: Target 'all' not remade because of errors.
|
||||
</pre>
|
||||
<p>The likely culprit here is that g++ is not on your Path.<br>
|
||||
<p>The Error 255 is produced by make as a result of its command shell not being able to find a command for a particular rule.<br>
|
||||
|
|
|
|||
|
|
@ -215,7 +215,7 @@ your last search.</p>
|
|||
<h2>Search Concepts</h2>
|
||||
|
||||
<h3>Declarations</h3>
|
||||
<p>According to the ANSI C++ Spec, a declaration is a statement that “introduces a name into a translation unit or re-declares a name that has been previously introduced by a previous declaration.�</p>
|
||||
<p>According to the ANSI C++ Spec, a declaration is a statement that “introduces a name into a translation unit or re-declares a name that has been previously introduced by a previous declaration.</p>
|
||||
<p>All C/C++ search elements can be searched for declarations.</p>
|
||||
|
||||
<h3>Definitions</h3>
|
||||
|
|
|
|||
Binary file not shown.
|
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 16 KiB |
BIN
doc/org.eclipse.cdt.doc.user/images/mprop_binaryp.png
Normal file
BIN
doc/org.eclipse.cdt.doc.user/images/mprop_binaryp.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 9.7 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 14 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 9.1 KiB After Width: | Height: | Size: 9.2 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 10 KiB After Width: | Height: | Size: 10 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 13 KiB After Width: | Height: | Size: 12 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 10 KiB After Width: | Height: | Size: 9.2 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 9.8 KiB After Width: | Height: | Size: 9.7 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 8.9 KiB After Width: | Height: | Size: 8.4 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 16 KiB After Width: | Height: | Size: 17 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 15 KiB |
|
|
@ -72,6 +72,7 @@
|
|||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_mprop_file_types.htm">File Types</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_mprop_indexer.htm">Indexer</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_mprop_merror.htm">Error Parser</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_mprop_mbinary.htm">Binary Parser</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_mprop_ref.htm">Project References</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="100" height="1" alt=""><a style="text-decoration:none" href="cdt_o_smake_proj.htm">Standard Make Projects</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="150" height="1" alt=""><a style="text-decoration:none" href="cdt_u_sprop_info.htm">Info</a><br>
|
||||
|
|
|
|||
|
|
@ -0,0 +1,69 @@
|
|||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
|
||||
<html lang="en">
|
||||
|
||||
<head>
|
||||
<meta http-equiv="Content-Language" content="en-us">
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||||
<title>C/C++ Project Properties, Managed, Binary Parser</title>
|
||||
<link rel="stylesheet" type="text/css" href="../help.css">
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<h1>C/C++ Project Properties, Managed, Binary Parser</h1>
|
||||
<p>You can select the Binary Parsers you require for the project. </p>
|
||||
|
||||
<p>To ensure the accuracy of the C/C++ Projects view and the ability to successfully run and debug your programs.
|
||||
After you select the correct parser for your development environment and build your project, you can view the symbols of the .o file in the C/C++ Projects view.</p>
|
||||
|
||||
|
||||
|
||||
<p><img img src="../images/mprop_binaryp.png" alt="C/C++ Project Properties, Managed, Binary Parser"></p>
|
||||
|
||||
|
||||
|
||||
<dl>
|
||||
<dt>Binary Parser</dt>
|
||||
<dd>Select a binary parser from the list.</dd>
|
||||
<dt>Binary Parser Options</dt>
|
||||
<dd>If a binary parser has parser options you can define them in this section.</dd>
|
||||
<dt>Restore Defaults</dt><dd>Returns any changes back to their default setting.</dd>
|
||||
<dt>Apply</dt><dd>Applies any changes.</dd>
|
||||
</dl>
|
||||
|
||||
<p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21">
|
||||
<br>
|
||||
<a href="../concepts/cdt_c_build_over.htm">Build overview</a></p>
|
||||
<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21">
|
||||
<br>
|
||||
<a href="../tasks/cdt_t_proj_parser.htm">Selecting a binary parser</a></p>
|
||||
<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"><br>
|
||||
<a href="cdt_u_sprop_info.htm">C++ Project Properties, Standard, Info</a><br>
|
||||
<a href="cdt_u_sprop_builders.htm">C++ Project Properties, Standard, Builders</a><br>
|
||||
<a href="cdt_u_sprop_file_types.htm">C++ Project Properties, Standard, File Types</a><br>
|
||||
<a href="cdt_u_sprop_includes.htm">C++ Project Properties, Standard, Include Paths and Symbols</a><br>
|
||||
<a href="cdt_u_sprop_indexer.htm">C++ Project Properties, Standard, Indexer</a><br>
|
||||
<a href="cdt_u_sprop_mbuild.htm">C++ Project Properties, Standard, Make Builder</a><br>
|
||||
<a href="cdt_u_sprop_merror.htm">C++ Project Properties, Standard, Error Parser</a><br>
|
||||
<a href="cdt_u_sprop_mdiscovery.htm">C++ Project Properties, Standard, Discovery Options</a><br>
|
||||
<a href="cdt_u_sprop_psource.htm">C++ Project Properties, Standard, Source</a><br>
|
||||
<a href="cdt_u_sprop_poutput.htm">C++ Project Properties, Standard, Output</a><br>
|
||||
<a href="cdt_u_sprop_pproj.htm">C++ Project Properties, Standard, Projects</a><br>
|
||||
<a href="cdt_u_sprop_plib.htm">C++ Project Properties, Standard, Libraries</a><br>
|
||||
<a href="cdt_u_sprop_pcontainers.htm">C++ Project Properties, Standard, Path Containers</a><br>
|
||||
<a href="cdt_u_sprop_ref.htm">C++ Project Properties, Standard, Project References</a><br>
|
||||
<a href="cdt_u_mprop_info.htm">C++ Project Properties, Managed, Info</a><br>
|
||||
<a href="cdt_u_mprop_builders.htm">C++ Project Properties, Managed, Builders</a><br>
|
||||
<a href="cdt_u_mprop_build.htm">C++ Project Properties, Managed, Build</a><br>
|
||||
<a href="cdt_u_mprop_file_types.htm">C++ Project Properties, Managed, File Types</a><br>
|
||||
<a href="cdt_u_mprop_indexer.htm">C++ Project Properties, Managed, Indexer</a><br>
|
||||
<a href="cdt_u_mprop_merror.htm">C++ Project Properties, Managed, Error Parser</a><br>
|
||||
<a href="cdt_u_mprop_ref.htm">C++ Project Properties, Managed, Project References</a></p>
|
||||
|
||||
|
||||
<p>
|
||||
<img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" >
|
||||
</p>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
|
|
@ -70,6 +70,7 @@
|
|||
<topic label="File Types" href="reference/cdt_u_mprop_file_types.htm"/>
|
||||
<topic label="Indexer" href="reference/cdt_u_mprop_indexer.htm"/>
|
||||
<topic label="Error Parser" href="reference/cdt_u_mprop_merror.htm"/>
|
||||
<topic label="Binary Parser" href="reference/cdt_u_mprop_mbinary.htm"/>
|
||||
<topic label="Project References" href="reference/cdt_u_mprop_ref.htm"/>
|
||||
</topic>
|
||||
<topic label="Standard Make Projects" href="reference/cdt_o_smake_proj.htm">
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue