This is the "Starting.txt" file,
created TUE 2011 NOV 15 06:56 PM, (Eastern Standard time)
revised SUN 2011 NOV 27 06:18 PM,
revised TUE 2012 JAN 03 07:52 PM. (mostly correcting typos and minor errorsa)
<Ray -- look for "verify", "incomplete", and "?????".>
Mr. Ted Felix wrote a tutorial entitled, "QBasic for Kids".
He also has a companion website, "Computer Science for Kids".
I also found the original manual for BASIC, from Dartmouth college,
if you can bear the concepts of "time sharing" and "teletype machines".
I think we can all enjoy the material that already exists in the forums --
plus benefits to be gained by the opportunity to join an active user community!.
If you Google "Ted Felix", you should be able to find Ted's home page.
I will be studying his tutorials myself, but I think I must warn you first that there are MANY variations in operating systems, computer hardware, and many variations of BASIC dialects.
I hope to give you a "heads up", so that you will not be unduly discouraged when you find some differences between what Ted describes, and your own experiences.
P. S. You can, if you want to, look for and find the ORIGINAL User's Manual for BASIC from Dartmouth College. Your laptop should allow you to do things so much more easily than the "teletype machines" and "time sharing" facilities the original authors had to use. Perhaps you will think that "ancient history" is quaint!
~~~~
HELLO!
Hello! I hope you have had some help getting acquainted with your
computer. I have to assume that you can find articles on the Web,
and that you can "click" a mouse. I trust also, that you are
actively learning to use the vocabulary of Computer Science.
Two brief notes for beginners -- (1) executable computer programs
are often called "apps", or "applications". (2) in computer langauge,
"execute" does NOT mean to put your program before a firing squad.
It only means to run your program, that is, cause it to perform
your instructions.
Computer hardware and software changes so rapidly, and there are
so many (slightly) different products, that it is difficult to
keep up! So, I am trying to report as accurately as I can my own
current (see date above) experiences on my NEW machine. It is a
Toshiba laptop, with the Windows 7 operating system. Again, this
is merely fact, not an endorsement.
I hate it when I must change from familiar hardware and software
(so did the late mister Noyce, one of the inventors of the integrated
circuit chips which make personal computers possible).
I must learn all over again how to do many things in new ways.
<Begin whine> The keyboard doesn't feel the same! Some of the
puntuation keys are in different places. The mouse doesn't work
the same way! Windows 7 doesn't track "recent files", or search
for them, the same way Windows XP did! And on and on, as I am
in the process of discovering. Much of my old software is no
longer compatible with the new operating system. My favorite
programs don't work any more! :-( <end whine>
It was a MAJOR switch from Disk Operating System (DOS) to Windows.
It was a MAJOR switch from a 16-bit operating system to a 32-bit
operatiog system (more than a gigabyte of documentation to read!).
But even this was not sufficient to solve all of the world's
problems. You can't even count to five billion with only 32 bits.
And there are more than seven billion people on this planet now.
And I'm sure that many people have more than one problem. Now it is
a MAJOR switch from a 32-bit operating system to a 64-bit operatiog
system, but I am confident that I will adapt. You will, too.
I intend to use this newness as an opportunity to help beginners,
because I am having to make a fresh new start myself. CAUTION!
Sooner or later, you must learn to be very flexible to adapt to
the continuing changes!
WARNING! Not everyone is a "white hat" computer user. Some Web
sites may be used to perpetrate scams, and some sites are
fraudulent. Ask your computer teacher at school for her advice
on how to avoid "malware", viruses, identity theft, and other
frauds. Also, if your computer system (hardware and software)
is not exactly like mine, (and, it probably isn't EXACTLY), you
will experience some differences from what I am about to describe.
Adapt! :-|
I hope that I can help you by recording my experiences, as I
start working with my new laptop computer. Just as there were
many changes when I had to switch from a 16-bit operating
system to a 32-bit system, so do I expect that there will be
many changes when in switching from a 32-bit operating
system to a 64-bit system. I have already discovered that many
of my favorite (old) programs have incompatibility issues. But
I have used QB64 sucessfully to run several of my old BASIC
programs. They ran 10 times FASTER, and I can use windows MUCH
LARGER than 640 pixels by 480 pixels.
THERE ARE MANY OTHER RESOURCES
There are many resources available for you -- you won't need
to rely exclusively on me. In fact, I expect you to explore a
lot. The more sources, tutorials, and sample programs you
encounter, the more robust your working knowledge base will
become. I do not expect you to rely entirely on me. You must
learn for yourself, and learn to be flexible!
For example: at the very bottom of the Official QB64 Website page,
there is a blue rectangle, with words next to it on either side,
"Video (2)" and, "QB64 Tutorial -- QBasic for Windows 7 Vista
Linux -- Free".
(*) Place your mouse in the blue rectangle. (This works best when
the QB64 page occupies your full screen. You may not see all of
the pop-up window otherwise.)
You should see a large black rectangle (the play-back area where
your choice of videos will appear.) To the right of this are two
Smaller blue rectangles, labelled "QB64 Tutorial -- QBasic for
Windows 7 Vista" and "QBasic Tutorial 1 -- Getting Started -- Free".
(*) Place your mouse in your choice of the two small blue rectangles.
Be careful that your mouse doesn't pass over the OTHER rectangle
when you are trying to select the other video.
The selected video (with spoken sounds) should start to play
automatically.
(*) I recommend that you listen to BOTH tutorials (they last only
about five minutes) -- it won't hurt you to know a little bit about
several slightly different versions of BASIC, running in several
different environments. The people at School Freeware may even
explain some things to you even better than I can!
You may notice that QB64 does not have a "Help" option. Fear not!
There is a documentation wiki available, which will give you full
details on all QB64 BASIC keywords. I will explain how to find this
documentation later, after I have explained how to write a simple
program.
One of the BASIC programs talked about in the videos is an
INTERPRETER -- it has its own separate, special option to make an
executable file.
QB64 is a COMPILER -- it only creates executable files. This usually
takes about a minute before you can run your program, but the
resulting program will run so much faster! You can run your new
executable app over and over, and will not need to use QB64 again,
until you want to change your app or write a new one.
HOW TO OBTAIN SOME USEFUL RESOURCES
Use your search engine of choice. (I have used Google in a car
dealership while waiting for car repairs, and Firefox at the
Caroline County (Maryland) public library; I use Norton Safe
Search at home. This is a statement of fact, not an endorsement
for any one of these products.)
I'm writing these instructions in "baby steps", because I
understand that Computer Science can be very confusing to
beginners. Above most other priorities, I want lots of students
to learn how to write their own apps. This is NOT "The App Store"
-- this is a free, Do-it-yourself "App FACTORY"!
(1) Search for
"Go To _Wikipedia_" seems to be the most useful link. (I put
my underscores in front of and behind the words of titles.
This helps ME avoid confusion with Internet links. It's also
I hope, more legible and easier than underlining the
entire title, especially since I use "good old Notepad" as
my editor of choice.)
(2) Click on the word "_Wikipedia_" in the phrase, "Go To
_Wikipedia_". It's blue or purple, and underlined, to indicate
that this is a link to another Web page.
A new page should appear, with the title "Wikipedia", and a
picture of a sphere with symbols from various alphabets,
surrounded by the names of several different languages.
I will be exploring only the "English" Wikipedia.
(3) Click on the blue word, "English", just above the phrase,
"The Free Encyclopedia".
Another new page should appear. At the top, it says,
"Log in / create account". (You may want to use this later,
but perhaps not today -- and not without permission.) Just
below this is a rectangle containing the word, "Search",
and a picture of a detective's magnifying glass. This
rectangle is what we want now.
(4) Click inside the "Search" rectangle. Type in the characters,
"QB64". then click on the picture of the magnifying glass
inside the rectangle.
This should bring up the page with the title, "QB64", and a
picture -- the QB64 logo. This is NOT the QB64 home page,
but it's within hailing distance.
The bottom line in the medium-sized rectangle containing
the picture of the bee, says,
"Website http://WWW.QB64.net", (in purple text, followed
by a small box with a blue arrow). This is another link.
(5) Click on the purple text, "http://WWW.QB64.net". (This IS
the URL for the QB64 home page.)
You should see the "bee" logo again, with the caption,
"The Official QB64 Website". To the right of the bee is
a column of three icons: (A) THe red, green, blue, and
yellow Windows icon, (B) a penguin icon, and (C) a silver
Apple logo. These emblems correspond to (A) the Windows
operating system, (B) the Unix operating system, and (C)
Apple's operating system.
To the left of the "bee" logo, you should see
"Documentation (WIKI)". You will want to use this as a
source of reference information, later. It discusses,
in detail, most of the things you will need to know to
create your own apps, AFTER you have your own free copy
of the QB64 BASIC compiler.
FOR YOUR INFORMATION
For your information: downloading the file takes about 15
minutes. I succeeded in installing the QB64 compiler a
few days ago, and am unwilling to risk messing up a
situation that appears to be working for me, on my
computer. Therefore, I cannot guarantee thgat EVERY DETAIL
for the next few steps is absolutely correct (I just do
my best.) Besides, if you have different hardware or a
different operating system, some details (for you) are
certain to be slightly different.
YOU MAY NEED MORE HELP HERE
THAN I (alone, and far away) CAN GIVE YOU
(6) If you have permission (and you may need the help and
support of your computer teacher, too) find and click
on the purple "Download Details" text which is most
suitable for YOUR computer system.
You may see a dialog box titled "File Download". "Do you
want to save this file, or find a program online to open
it?" Your options are, "Find", "Save", and "Cancel".
Notice the warning -- this is serious! You need permission,
and you may need help. ASK for help if you need it, or
click on "Cancel", if you're not sure what to do.
"While files from the Internet can be useful, some files
can potentially harm your computer. If you do not trust
the source, do not find a program to open this file or
save this file."
"What's the risk?" links to a list of "Frequently Asked
Questions" (FAQ's) titled, "Downloading files from the
Internet: frequently asked questions".
(7) If you have successfully downloaded the compiler program,
you will need to find it.
Perhaps this advice will help:
"Where are downloaded files saved?"
"When you download files, Windows usually saves them in
the Downloads folder, which is located under your user
name in the Users folder on the drive where Windows is
installed (for example C:\users\your name\downloads).
When you are saving the file, you can choose to save it
to a different folder. Some different types of files are
saved to different folders by default. For example, if
you right-click a picture on a webpage and then choose
Save Picture As from the menu, the picture will be saved
to the Pictures folder by default. If you're not sure
where the file was saved, you can search for it from the
Start menu."
The above text is the advice I got from my windows 7
system. Since your system is almost certainly NOT exactly
like mine, you will need to learn to be flexible!
I found a file named "qb64v0942-win", of type "Compressed
(zipped) folder", and put in in a new folder I named,
"QB64Folder".
(8) Double click on the downloaded file. It should open up
into everything (every file) you need to compile your
own apps.
I found three folders: "internal", "samples", and
"source", plus a number of ".dll" files, (which are
support files for running QB64 and the apps it creates,)
and the "qb64" application itself.
A NOTE
I was very pleased to find an elementary tutorial by
Ted Felix. It looks like a great introduction! Unfortunately,
he seems to be using a slightly older operating system, and
possibly an earlier version of BASIC, too.
Consequently, you will find that some things may not work
EXACTLY the ways he describes, especially in the first few
chapters. You will need to be adaptible!
STOPPING AN OUT-OF-CONTROL PROGRAM
This stuff is IMPORTANT TO KNOW before you start writing
programs which can loop forever and never end (without your
help).
My laptop does not have a "Break" key! I need to do the following
steps to stop a program caught in an endless loop, or otherwise
"out of control":
(A) Hold down these three keys, all at the same
time -- "CTRL", "ALT", and "DEL".
These messages (from the Windows 7 operating system) should fill
the display screen:
--> Lock this computer
--> Switch User
--> Log off
--> Change a password...
--> Start Task Manager
WHAT TO DO
(B) Select "Task Manager" from this list.
You should see a window containing a list of all of the
programs which are running. The name of your program should
be on this list.
(C) Find and select the name of the program which is running
"out of control".
You should see a window intended to verify the action of
closing down a program. It has these options:
(programname) is not responding
Close the program
Wait for the program to respond
(D) Click on "Close the program".
Sometimes, a program leaves a window on the screen after it is
closed. Most windows have three buttons at the top, some-what
ike these: "_", "[]", and "X". If this happens, ...
(E) click on the "X" button to close the window.
You should now be able to resume normal operation of your
computer. But, you have found evidence that there is a serious
problem (a "bug") in your program. So, before you run your
(defective) program again, ...
(F) Restart your QB64 compiler.
(G) Reload your program's source code.
(H) Try to find the problem, then try to fix it by editing
your source code.
(I) Save your edited source code.
(J) Recompile your program.
(K) Test your program again, until it works properly. If it
still doen't work properly, you will need to continue "debugging"
the program -- reoeat the above steps until it does work.
A SIMPLE COURTESY
Sometimes, your computer's operating system will encounter
a problem while executing one of your programs. It may present
you with an error message screen with two buttons: "Send report",
and "Don't Send". I think, in most situations, it is only
polite to click the "Don't Send" button, because it's most
likely that it is a coding error in your program, which is
causing the problem.
It is more appropriate to search the User Forum associated with
your free software -- perhaps someone else has already posted
a report on a problem similar to yours. And, even if nothing
similar has been posted there, the User Community will probably
be more sympathetic, and more knowledgable.
vvvvv < VERIFY THIS! > vvvvv
HOW TO CREATE AN APP
(9) Double click on the icon for the "qb64" application.
Caution! these is also a "qb64.bas" file, which you probably
will never need, but may find interesting someday, after
you learn the fundamentals of BASIC programming.
You should find yourself in the QB64 Integrated Development
Environment (the IDE).
(10) Click on "New". This should put you into the integrated
source code editor.
(11) Type in: PRINT "Hello, World!"
(12) Click on "Save As" then give your new app a new, unique name.
(13) Click on "Run" and "Start". You should see several messages:
"Creating exe"
"Starting program"
Finally, you should see a window with the text, "Hello, World!"
displayed in it. This is your program, running! (Or, at least, it ran in a fraction of a second.)
Congratulations! You have just created a new app!
Look for it in the list of files in your QB64 folder.
You can click on the icon for your new app to run it again --
you don't need to compile it again, unless you make changes
to the source code.
HOW TO FIND THE QB64 DOCUMENTATION
< incomplete >
Navigate to "The Official ... "Documentation Wiki" ...
In the Contents box: "1 Keywords" ... "Keyword Reference -
Alphabetical" ... "Keyword Reference - By usage" ...
"Keyword Reference - By usage" will probably be more helpful
as you begin learning. Once you understand what most of the
keywords are for, the alphabetical listing is a handy reference.
HOW TO FIND TED FELIX's TUTORIAL
Just remember that Ted was using slightly older software.
I hope the material I have written will help you work around
the differences. Once you get through the first few chapters,
Ted will be writing mostly about BASIC programming, and the
differences between different operating systems will not matter
nearly so much.
NOW, START LOOKING AT SAMPLE PROGRAMS
The QB64 User Community has provided plenty of these! I will
review a few simple programs to get you started. After that,
you are on your own. May you have good success! :-)
The end.
