Bobby,
I'd remind you that they (the CodeBlocks guys) have their own discussion forum,
and that's probably where you should take these issues. The folks who read
this forum generally want to focus on SDCC, and, while CodeBlocks may,
ultimately, serve their interests, it's not the primary purpose of THIS list.
I personally think it's OK to gripe about such things, since, if nobody
complains, everybody thinks it's "kewl", which seldom is the case. However,
THIS is not the place to gripe about THAT product.
regards,
Richard Erlacher
----- Original Message -----
From: Bobby Garner
To: sdcc-user@lists.sourceforge.net
Sent: Sunday, August 31, 2008 12:45 PM
Subject: Re: [Sdcc-user] documentation & open source generally
I just installed the current release of C::B v8.02. It does include a manual
which appears to be well designed. As I want to start a new project, I find
under "CodeBlocks Project Management", this encouraging statement: "CodeBlocks
offers a very flexible and comprehensive project management. The following text
will address only some of the features of the project management." "Only some"?
If the author knows of other features, why does he not at least list them, and
fill in the detail later?
Already there is a shadow of doubt creeping in. But proceeding to the next
page, it says: "The easiest way to create a new project is executing the
command 'File' /'Project' and selecting a wizard". Unfortunately, there is no
'Project' option on the file menu. There are only 'Recent Project' and 'Import
Project' both of which require an existing project. This is supposed to help me
start a new project, one which has no preexistence?
Going back to the Startup Page, there is a 'Create a new project' option
which brings up a dialog displaying a group of wizards including an 'Empty
project'. No SDCC project, and only one embedded microcontroller project wizard
for an AVR. Should I begin with the blank sheet, or start an AVR and modify it
for my 8051 derivative?
Going back to the manual, an index tab search for 'template' offers two
topics, Codesnippets and Source Code Exporter. Neither of these look right.
Back on the contents tab under C::B Project Management, there is a page titled
'Project Template'. It contains this paragraph:
"CodeBlocks is supplied with a variety of project templates which are
displayed when creating a new project. However, it is also possible to store
custom templates for collecting your own specifications for compiler switches,
the optimisation to be used, machine-specific switches etc. in templates. These
templates will be stored in the Documents and Settings\<user>\Application
Data\codeblocks\UserTemplates directory. If the templates are to be open to all
users, they have to be copied to a corresponding directory of the CodeBlocks
installation. These templates will then be displayed at the next startup of
CodeBlocks under 'New' /' Project' /'User templates'."
So thats where they moved the 'Project' menu item! Except there is no menu
called 'New', and I wouldn't expect there to be. There is a File/New/Project...
however, which produces the dialog with the Wizards.
I need a rest break before attempting to work through one of these wizards. I
just wanted to offer this actual experience for whatever it may be worth to
anyone considering a new manual for SDCC, because this is pretty typical of my
own experience with open source help systems. As Richard Erlacher has pointed
out, there is the appearance that the documentation author was unable to read
the code, misread the code, Or the coder changed the code without communicating
that fact to the documentation author.
The experience of others may vary, and so far there is no reason to suspect
that Code::Blocks doesn't work as advertised, and if it doesn't, the fault
would surely not lie with the program. And the documentation is probably right
too, somewhere and/or sometime. Maybe I just misread the advertisement.
Bobby
JBarbosa wrote:
Below is a link to the Code::Blocks site and some chunks of text from the
opening page.
I 'm working exclusively with Windows.
SDCC is called by means of a .bat file containing the command lines,
C::B allows us to set a tool to invoke that .bat and 'voila'!
If your PC has more than one core, they are used,
The site gives access to several foruns, one of them is dedicated to the
'nightly builds' that allows us to update C::B every day, simply by downloading
it and extract the files straight to the C::B directory and thats all.
http://www.codeblocks.org/
http://wiki.codeblocks.org/index.php?title=Main_Page
"The open source, cross platform, free C++ IDE."
a.. Windows 2000 / XP / Vista
b.. Linux (Ubuntu & Debian, 32 & 64 bits)
c.. Mac OS X 10.4+
Supported compilers
a.. GNU GCC (incl. G77) (Linux)
b.. MinGW GCC (incl. G77) (Win32)
c.. MSP430 GCC (Win32, Linux, BSD)
d.. TriCore GCC (Win32, Linux)
e.. PowerPC GCC (Win32, Linux)
f.. Apple GCC (Xcode) (Mac OS X)
g.. Microsoft Visual C++ Toolkit 2003 (Win32)
h.. Microsoft Visual C++ 2005 (Win32)
i.. Borland's C++ Compiler 5.5 (Win32)
j.. DigitalMars C/C++ (Win32)
k.. OpenWatcom (Win32)
l.. Intel C++ compiler (Win32)
m.. Small Device C Compiler (SDCC)
n.. Digital Mars D (Win32, Linux)
o.. GDC D Compiler
Regards
Jose Barbosa
----------------------------------------------------------------------------
-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/----------------------------------------------------------------------------
_______________________________________________
Sdcc-user mailing list
Sdcc-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/sdcc-user
------------------------------------------------------------------------------
-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
------------------------------------------------------------------------------
_______________________________________________
Sdcc-user mailing list
Sdcc-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/sdcc-user
-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________
Sdcc-user mailing list
Sdcc-user@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/sdcc-user