On 10/15/2011 10:56 AM, W. eWatson wrote:
...
> Maybe you find fbooks.hlp useful, but at this stage, as a beginner to
> Watcom, I do not. I'm no stranger to compilers and languages.
No offense intended, but surely doesn't seem that way...
>> Looking at the IDE tutorial, the "Kitchen" file referred to is a _NEW_
>> filename for the project you're going to create as you work through the
>> tutorial; look at the title of Figure 2, "Creating a new project". So,
>> there should _not_ be an existing file of that name.
> OK, let's look. From page 15 above figure 2.
> ======================
> When asked for a project name, you can do one of two things:
> 1. enter the following pathname:
> d:[path]\SAMPLES\IDE\FORTRAN\target\KITCHEN
> where d:[path] is the drive and path where you installed the Open Watcom
> software, or
> 2. use the file browser to select the following directory:
> d:[path]\SAMPLES\IDE\FORTRAN\target
> and specify the filename kitchen.
> Figure 2. Creating a new project
> Press the ...
> ==================
> I'm using the IDE. 32-bit XP.
> The path after ...\FORTRAN\ does not exist. ...\FORTRAN\target does not
> exist. Why? What am I missing?
Actually _READING_ what the tutorial says, apparently.
It says identically (by cut and paste), that "the target that we refer
to below should be one of WIN, WIN386, WIN32, or OS2 depending on your
selection."
It does _NOT_ say there should be a "TARGET" subdirectory but that you
should select one of the list of WIN|WIN386|WIN32|OS2 as the target
depending on the _target_ OS you're intending to build an executable for.
>
> "Specify filename kitchen." How does one do that?
One does what one normally does when presented a file GUI for a new
file; one types what one wants into it. In this case, the tutorial
suggests you type "KITCHEN"
Here's what I do.
> Figure 2 is of no help. When I use New Project, I get an Open dialog
> with noname.exe the entry area. Instead I type something like
> myproj.exe, and click the Open button. That gets me to a window that
> shows myproj.exe in the title. The manual is off already.
No, you didn't follow instructions that are about as clear as I think
they could be made to be. You're not actually taking the time to read
or at least comprehend what you've read, sorry, not the
instructions/tutorial/documentation is wrong nor out of date.
...
> Figure 2. What is it referring to? I see it's drilled down to Win32.
> What does it have to do with Kitchen or project names?
It's the direct screen copy of the ui in the target directory in which
the tutorial just above got through saying they were going to
use--namely WIN32. And again, copied and pasted from the doc's on the
same page, following sentence: "The tutorial uses the WIN32 example for
illustrative purposes." Hence it's not terribly surprising that's the
directory for which the screenshot is shown.
What it has to do w/ KITCHEN is that when you type in "KITCHEN" as
requested, that's where the .wpj project will be created. If you want
to put it somewhere else, that's fine; that's just what the tutorial
uses as the convention is to put stuff in the target OS subdirectory of
the the language (FORTRAN) samples.
>
> I'll stop here on the manual discussion.
I'd suggest you go back and reread it and actually look at what it says
before you criticize further.
Once you follow the above step, the remainder works just fine, again as
described.
> To create and understand what's going on, several days ago I wrote the
> classic Hello, World program. This should be in any introductory
> material when someone is learning a language or understanding how a
> compiler works.
Well, the Watcom people chose a somewhat more complex illustration to be
able to demonstrate more stuff in one shot.
> At first, I got nowhere until I realized that I needed to use the Open
> button as above.
Well, I don't know why that should have been that hard to discern since
the tutorial just led you through the step(s). Again, I'm having a hard
time to find a reason to fault the tutorial here, sorry.
Next I discovered the Source menu item actually allows
> me to select my helloworld.for program I created with an editor.
>
> Now what? Let's make a target. Have fun finding what that means from the
> manual. I finally figured it out.
Again, if you had followed the tutorial, it would have led you through
the process.
> From my view point the manual is badly out of date. It needs something
> a lot better for beginners than kitchen. Try HelloWorld.
I categorically disagree on the "out of date" description. Whether
there should be a different target as well is a matter of taste.
There is, in addition to the tutorial, the "IDE.HLP" help file that
discusses all the menus and options plus how to customize the IDE and
interact w/ the other utilities, etc., etc., etc. It's the
documentation on the IDE, not the tutorial, anyway. I presume it is the
same content as the .pdf manuals but am not going to take the time
presently to verify. The short tutorial there is based on C but notes
that if one simply uses Fortran names and writes a sample program in
Fortran instead, one can follow along w/ minimal changes. It builds an
executable from actually typing in a new source file as opposed to the
more complex KITCHEN example. Perhaps that would be more to your taste.
As noted earlier I've not done a full installation since having to
rebuild this system (and it's unlikely I will any time _real_soon_now_
(tm) as I don't use Watcom actively any more; I just try to help where I
can here) but I also presume that when the environment variables are
properly set after an installation that will come up under the Help menu
when in the IDE (I know it did under Watcom 11.6; no reason to suspect
anything different in OW).
>
> At this point, I may need only one more bit of info. How does one create
> a library and use it? It would be good if the steps were fully described
> in the manual.
In the Help files--all that's need in the IDE is to select "LIB" for the
proper image and OS and the switches will be set automagically to build
the library. When you create a new project as above, the next screen
will present you w/ the choices of OS and image type from which to
select--all you do is pick what you want from the screen.
To use a library is simply to refer to it in the target as a dependency
as is demonstrated in the tutorial for the resources used there :)
(which, obviously, that such additional items are used in the project is
as noted earlier, a reason for making the "KITCHEN" project the tutorial
because it does have more than just a single-file .exe to show how the
other pieces are handled.
>
> I'm sure there's more to learn.
>
> Your turn.
...
See above and go back to the documentation and be a little more thorough
in using it--it does explain all these things.
--