[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
[cdt-doc-dev] Re: CDT User Guide
|
Here are the comments on the CDT Tutorial:
cdt_w_autobuild:
================
I'd be inclined to put "Automatically building your project" after
"Creating your project". You and I know that the former is actually
"Configuring projects to build automatically" and that you can set this
before you have created a project. However, to the new reader it looks
odd to "automatically build your project" before you create it.
I like that you have Next and Back buttons. Those have been pulled from
the 2.1 version of the docs as being too hard to maintain, but I believe
that they erred in doing this.
I believe that the IBM standard is to use a comma before "and" or "or"
in lists, so you would write "...a file in your project is created,
saved, or deleted."
The Red Hat standard is "checkbox"; I don't recall what the IBM standard is.
cdt_w_newproj:
==============
I generally close the introduction to a list with a colon. If that is
the IBM standard (and it might be), you would write: "To create your
project:"
The instructions are good, but when I follow them I also see a "Confirm
Perspective Switch" dialog that urges me to switch to the C/C++
perspective. I click [Yes].
cdt_w_newcpp:
=============
The instructions are good, although I do not see the option "Click File
> Save main.cpp". I can see "File > Save", but the file name does not
appear.
Naturally I just cut-and-pasted the code.
cdt_w_newmake:
==============
The instructions are good, but again I do not see the option "File
> Save makefile" (just "File > Save").
cdt_w_build:
============
I generally avoid a bulleted list that has a single entry. You might
consider:
<p>To build your project, click <b>Project > Build Project</b>.</p>
I get an error: Build Error (Exec error:Launching failed)
I gather that Eclipse doesn't come with a compiler or debugger. To
overcome this, I opted to download Cygwin, open a Cygwin bash shell, and
start Eclipse from there. The HelloWorld build succeeded after we made a
few changes.
In the makefile I was encouraged to add the line:
CXX = g++
and to add tabs before the two lines that are indented below:
CXXFLAGS = -g
CXX = g++
all : main.o
${CXX} ${CXXFLAGS} -o hello.exe main.o
clean :
rm -rf hello.exe main.o
I can't confirm that the "CXX = g++" is required, but I know that with
gcc each of those indented lines must start with a tab character.
cdt_w_debug:
============
Step 3:
-Instead of a "File name" box, I see a "Name" box (field?).
-I need to specify the Project.
-I need to specify the C/C++ Application.
Step 4:
-Debugging fails, claiming that the main.cpp file was not found.
The error window presents a button that enables me to attach a
source file. I browse for <eclipsehome>\workspace\HelloWorld
and click OK.
The debugging starts.
Step 5:
-The breakpoint is set.
Step 6:
-Run > Resume works.
Step 7:
-Run > Resume fails--the option is grayed out.
I'm not sure what the problem is or what to do now. If anyone has
suggestions, do let me know.
Best regards,
Mike Behm
Red Hat (Canada) Ltd.