Note: this gtk version of Fade is rather buggy. It is with my coding, not withthe gtk-server stuff - I think it is still a useful gtk-server example. Windows users should use the version here which is much more reliable!

The Buttons

The basic use is to amend your code, click Run, or Run-Capture. Fix any errors. The program runs in a console window. Use Run-Capture when you are looking for syntax errors. It displays error messages underneath the code. Click on a message to go to the errored line. Use Run to execute, when the syntax errors have gone. Falcon options can also be set - see below. The Run-capture command also warns you about possible colon/semicolon and = / ==errors. In more detail, we have:

The Run Button - saves your code, then runs Falcon. Results go to a console window, as do compile and execution errors. The Dos window remains open (e.g for user interaction).

The Run-Capture - as Run, except that error output goes into Fade's bottom pane. Click on an error message to take you to the errored line. The Dos window closes. Prior to running, some popup messages can appear, warning you about : / ; and = / == problems, as in:

   if a==3:print("sometimes"); print("always")
and possible == / = mis-use, such as:
    if(a=b)     // should have put  ==  - though not always a mistake!
These warnings can be switched off.

The PP Button - indents the code. The assumption is that the code already has sensible line-breaks. PP does not move code from one line to another. I do not recommend using PP on files with syntax errors, but you might want to experiment with this. Personally, I have never screwed up any code! There is a PP-undo command in the Edit menu. A backup copy is also placed in a .BAK file pefore re-formatting.

The Backup button - saves the code in a BAK file. Use before doing major edits, just in case.

The Goto button. Enter a line number, click Goto - the line is highlighted.

The Find - Next buttons, and their entry box. Enter a string, click find - the text is highlighted. Next moves forward to the next instance.

Hint - if you are working on a long file (perhaps in 2 places: a function definition, and a call of it) you can keep the line number of the call in the Goto box, and the string 'function myFunc' in the Find box. It is easy to flick back between the 2 regions with Goto and Find

The At button. Click on a line, then click At:. The clicked line number is displayed.

(Fade does not show line numbers - Goto: and At: are provided instead, for working on larger files.)

The Backup button. Stores the current text in a file with a .BAK extension. There is only everone BAK file for each edited file.

The File menu

New, Open, Save, Save As, Exit have their normal meanings. NB the Run buttons also do a save. Exit does a Save, unless the text window is blank (it will not overwrite a file with no text. Exit - No Save is also available.

The Edit menu

... have their normal meanings. Currently, no 'replace' - sorry.

The Tools menu

Lines Containing - really a simplified grep. Use it to show every line containing (or not containing) an item. If you show every line not containing e.g. 6 spaces, you see the outer-level logic - a bit like code-folding. Currently, the runs in the console window.

Cross-reference displays a list of names (key words, and variable names) and "strings" used, together with the line numbers they occur in. Helps with mis-spellings, etc. Runs in console window.

The Config Menu

Set Command-Line Args - Used to pass data to programs when they are launched. If one of your args contains spaces, then "quote" them. Here is a line with 3 args:

cat "a dog" fish
You can use I/O redirection with arguments such as:
> outfile.txt

Set Falcon Options initially null, allows passing options, flags to the Falcon interpreter. (NB Help menu)

Current Falcon options shows any options you have set.

Switch off warnings for ;/: and == / = Defasult is 'on'. Messages appear as pop-up dialogs, before compilation. The checking is superficial.

Switch on warnings for ;/: and == / =

Bigger/smaller text - obvious.

The Help menu

Most of these link to websites. Falcon options can be listed as well.