The BFOIT Introduction to Programming Class
Appendix A (Jargon)
?confused unintelligible language?

S

source code

The text form of a computer program, the one that you type into a computer with an editor, is the program's source code. The source code is the human-readable representation of a computer program. There are many purposes for source code:

1. It is often embedded in explanations, notes, educational materials, etc...; as a way for people to explain algorithms, ways in which to do things, to communicate unambiguously about how something is done.
2. It is used to distribute computer programs. Since most executable versions of programs depend upon certain operating system/processor combos (e.g., Wintel which is Windows running on Intel), it is sometimes necessary to distribute programs via source code.
3. It is the format of a program that's input to an interpreter or a compiler to execute or produce an executable form of a program (respectively).

As an example, in the BFOIT jLogo lessons, you enter source code into the TG applet and/or application.

String

Strings in Java are objects. But, Java has features in it that make them appear to be primitive types, like ints. Specifically, Java has support for:

1. String literals,
2. the concatenation operator ("+"), and
3. conversion of all other types into Strings in support of concatenation.

An example of the last feature is:

    int variable = 123;
    ...
    System.out.println( "variable contains: " + variable );
            

In this case, the contents of variable is converted from an integer into a String and then combined with "variable contains: " into a single String object which is passed as an argument to println( ).

subclass

In OOP (Object Oriented Programming) there is the idea of a family-like structure amoung classes.  When a class extends some other class it can be thought of as a child - parent relationship, with the new extended class, the subclass, being the child.  The class that was extended is referred to as the parent class, or the superclass.

syntax

All languages have rules that you need to follow in order to construct meaningful phrases, sentences, paragraphs, and so on. This set of rules, the ways the words and symbolic separators and terminators (commas, periods, question marks, etc...) are combined, is the syntax of the language.

The syntax of a programming language is very specific so that its interpreter or compiler can do exactly what the programmer wants.  Some languages have a simple syntax, others can be more complex.  Since TurtleTalk is simple (a limited subset of the computer language Logo) it has a fairly simple syntax.  On the other hand, Java has a much more complex syntax. 

Common syntax errors that you will probably make, regardless of which language you are using are:

• Misspell keywords and names
• Forget closing things, like a right square bracket in TurtleTalk and the right squiggly bracket in Java

Syntax errors unique to Java that are common include:

• Mix the case of an identifier, e.g. define a field with a name "some_Data" and then type it in later in the class as "some_data"; "some_Data" and "some_data" are not the same! I used "D" and "d" on purpose in this example. But, what about "lst" versus "1st"? It is very easy to confuse the lower case L with the digit one.
• Forget a statement separator - a semicolon (";")

Syntax errors are caught by the TurtleTalk interpreter and the Java compiler; so, a program that has syntax errors will never run.  TurtleTalk complains when it discovers a syntax error and ignores the command that's bad, and the rest of the commands on the line.  The Java compiler also complains when it discovers errors.  It will not generate the .class file as long as there are syntax errors. 

There are lots of little things you can do to help you keep from making syntax errors, mostly conventions that you adopt and then stick to, every time you write some source code.  An example is indenting parts of the source code so that things line up and/or stick out to show the structure of the program.