- Welcome to Simply Fortran
- Purchasing and Activating Simply Fortran
- Using Simply Fortran
- The Simply Fortran Interface
- Editing in Simply Fortran
- Projects in Simply Fortran
- Building Projects
- Launching Projects
- Debugging Programs
- External Tools
- Version Control
- Options and Configuration
- Licensing
Appearance and Behavior Options
The Appearance and Behavior Options window allows the user to configure the look and feel of Simply Fortran and the features of its editor. Because many users have Simply Fortran installed on multiple machines, the Import Settings and Export Settings buttons can be used to save these settings to a file and load them into Simply Fortran from these files respectively to maintain consistent appearance and behavior settings on multiple machines. If Simply Fortran is using header bars, these options will appear when the “diskette” button is clicked next to this window’s title.
The options are divided into tabs, each described below:
Appearance
The colors utilized by the editor can be modified by the user. A drop-down box specifies which color component to change, and the Select… button opens a selection dialog. Because Simply Fortran features syntax highlighting, the user can configure keywords, comments, and variables to stand out from each other.
The default light and dark theme buttons will set the editor colors to sensible light and dark colors respectively.
Under the colors drop-down, an Import Theme… button allows the user to select and import Visual Studio Code or Visual Studio 2010-2013 color themes.
The font selection dropdown and the associated size text box allows the user to adjust the fonts used in Simply Fortran. The font size may also be increased in real-time within the editor by holding the Control key while moving the mouse’s scroll wheel.
Under the GTK+ category, the user can enable a dark theme if available. On some systems, this feature may have no effect if an appropriate theme cannot be located or assigned. Enabling the Use a Header Bar and Client-side Decorations will switch Simply Fortran to a more modern window paradigm the next time the development environment is started. The toolbar button size option can change the size of toolbar buttons throughout Simply Fortran.
Language Features
These options enable and disable certain Simply Fortran features within the editor related to enhancing productivity while working with known source languages .
Call Tips
When a source file in a supported language is being edited, the editor can optionally display real-time help for both intrinsic and user-defined procedures and functions. Enabling this option will allow help boxes to appear when a Fortran intrinsic procedure is entered followed by an opening parentheses.
Syntactical Indentation
Enabling this option allows Simply Fortran to intelligently indent or dedent code whenever a subunit of code in the file’s particular language is entered or exited. For example, if Simply Fortran detects the beginning of a loop in the code after ENTER is pressed, the next line will be automatically indented one tab width deeper than the loop’s beginning line. Conversely, if the end of a loop is detected after ENTER is pressed, Simply Fortran will dedent both the current line and the loop’s closing statement (if applicable) to match the indentation of the loop’s opening statement.
Syntax Checking and Inline Error Display
These two related options control real-time syntax checking within an editor tab. For a supported language , syntax checking allows Simply Fortran to periodically process code within the editor to check for warnings or errors. Errors or warnings will then be underlined appropriately within the editor. Enabling Inline Error Display will also display the error and warning messages directly in the code.
Autocomplete
The Autocomplete options control which types of autocompletion popups Simply Fortran will provide while typing. The four types of supported completion are listed below:
- Modules Names and Members – When use is entered, a popup will display all known module names. If followed by the only specifier, a popup will display any known members of the module.
- Scoped Variables and Procedures – When typing any code, popups will appear suggesting variables and procedures currently known to be visible within the current program or subprogram.
- Derived Types – If a % symbol is entered after variable known to be a derived type, a popup will suggest any members of the derived type.
- Control Structures – A popup will provide common suggestions to follow an end statement.
All autocompletion modes are supported when editing Fortran. Python and C support some autocompletion via the Scoped Variables and Procedures option.
By default, Simply Fortran will always attempt to show autocompletion suggestions. The Hotkey option allows the user to change this behavior such that the autocompletion suggestions will only appear if the selected hotkey is pressed while typing.
Default Language
This option reflects the default language and syntax highlighting to be used when a new file is opened in the editor. Normally, Simply Fortran will determine the syntax highlighting method to use based on the file name. However, when a new editor is opened without a pre-existing file, this option will allow the editor to default to free-format Fortran, fixed-format Fortran, or plain text (None).
Editor Styles
This panel controls stylistic editing options, as described below:
Automatically Indent New Lines
When enabled, a new line will be automatically indented to match the indent level of the previous line.
Use Spaces for Tabs
When the tab key is pressed, Simply Fortran normally introduces a true tab character into the text. If this option is enabled, however, an equivalent number of spaces is added rather than the tab character.
If the editor is currently in “Makefile” mode, i.e. the user is editing a Makefile, this option will be ignored, and true tab characters will be used.
Tab Width
The tab width specifies the size of either the tab character in the editor or the equivalent number of spaces if the Use Spaces for Tabs option is enabled.
Remove Excess Whitespace on Save
When enabled, any trailing whitespace on lines is stripped prior to writing the file to disk.
Fixed-Format Fortran Specific Behavior
Because fixed-format Fortran represents a somewhat special case in programming due to its significant leading whitespace, additional options are provided to streamline fixed-format programming.
Automatically Correct Tabs
When this option is enabled, fixed-format Fortran and Fortran source code conforming to Fortran 77 and earlier standards will be scanned for leading tabs and corrected automatically when loaded into an editor. Tabs were common in shifting code past the sixth column in fixed-format Fortran, but this methodology does not conform to Fortran standards.
First Column for New Line
When auto indentation is disabled above or a prior line contained a comment or line number label, the programmer often wants the next line to begin on the seventh column in fixed-format programming. This option allows the user to specify this column explicitly to avoid always starting in the first column, which is not as common in fixed-format programming.
Initial Tab to Column
Any tab keypresses prior to the column specified should move the cursor immediately to this specified column.
Editor Appearance
Options on this panel control the appearance of the editor (excluding colors and fonts).
Show Line Numbers
Enabling this options activates a line number listing for files in the editor.
Show Vertical Line
Displaying a vertical line is useful for determining when a single line of text is approaching a limit. For example, the Fortran 90 standard dictates that the maximum length of a single line is 132 characters. Enabling this guide can make development easier.
Indentation Guides
Indentation guides are useful in lining up indented text within a Fortran source file. In the case of large loops, for example, where the loop contents are indented, the guide can be used to determine where the dedented loop closing should be place.
Word Wrap
Enabling this option causes lines wider than the editor tab to wrap to the next line. However, this wrapping is performed for display purposes only; it is not reflected in the saved file. When a line does wrap, a small arrow will appear on subsequent display lines to indicate that they are actually continuations of the previous line.
Enable Code Folding
Code folding in the editor is depicted as small bars in the editor’s margin. When bars are clicked and this option is enabled, code structures (conditionals, loops, procedures, etc.) can be collapsed to a single line while editing. This behavior can be helpful when editing code surrounding long, embedded control structures.
Caret Width
This number specifies the width of the text cursor within the editor tab. This number can be either 1, 2, or 3, with 3 being the thickest.
Tab Behavior
Options in this panel control the behavior of editor, build status, and console tabs.
Console Appears Below Editor Tabs
Enabling this option directs Simply Fortran to open the internal Console tab at the bottom of the window below other editor tabs.
Build Status Appears Below Editor Tabs
Enabling this option directs Simply Fortran to open the Build Status tab at the bottom of the window below other editor tabs.
Terminals Appear Below Editor Tabs
Enabling this option directs Simply Fortran to open any terminals requested at the bottom of the window below other editor tabs.
Close Embedded Terminals when Children Complete
If enabled, terminal panels will close when the child process completes. For example, if a simple shell is running, typing “exit” will cause the terminal tab to close.
Save Open Tabs with Project
When enabled, the files from a project that are currently opened and their positions within the Simply Fortran window are stored in the project file. When the project file is later opened, Simply Fortran will automatically open and position these tabs again.
Close Open Tabs with Project
If enabled, unmodified editor tabs that contain files belonging to the project being close will also be closed. Any files with changes will remain open regardless of this feature’s status.
Disable Saving of Build Status / Console Tabs
This options, when checked, causes Simply Fortran to ignore Save and Save As commands in the main menu, toolbar, or the corresponding hotkeys when the Console or Build Status tab is the current tab. This feature is present to reduce the posibility of mistakenly overwriting Fortran source code when the current tab isn’t obvious. The Console and Build Status tabs can still be saved when this is enabled by right-clicking on the tab itself and selecting the appropriate item.
Left Panel
Options in this section control the appearance and behavior of Simply Fortran’s left panel where auxiliary information about projects, files and debugging are normally displayed.
Display Only One Panel
This option limits the left region of Simply Fortran to show a single panel at a given time. Enabling it may be useful if the behavior of pre-3.0 Simply Fortran is desired or if vertical screen height is limited.
List open files first in All Files mode
When enabled, the Project Outline will, in All Files mode, list open files at the top of the known files list. These filenames will appear bold as well.
Project Behavior
This panel controls how Simply Fortran loads and deals with projects. If the user needs to change the options of a particular project, the Project Options window should be opened.
Automatically Open Referenced Projects
When enabled, any projects referenced by a project being opened will also be opened in the same window. The referenced projects are always opened in the same window regardless of other settings on this panel via this option.
One Project Per Window
Enabling this option limits Simply Fortran to a single project per window. If a second project is opened, a new window will be opened or the current project will be replaced depending on the final option.
Replace Current Project
If Simply Fortran is limited to one project per window, enabling this feature will cause the current project to be closed when a new project is opened rather than opening a new Simply Fortran window.
Open Single Files in Current Window
When enabled, single Fortran files that are requested to be opened by the operating system by Simply Fortran should open in the existing, open window rather than starting another instance of Simply Fortran.
Ask to Copy External Files into Project Directory
This option will ask the user, whenever a file is added to a project that is not in the project directory or a subdirectory of the project directory, if the user wishes to copy the file from its current location into the current project directory.
Perform Clean When Project Options Change
When this option is enabled, changing project options at any time via the Project Options window will cause Simply Fortran to perform Clean operation on the current project. This feature ensures any changed project options will be applied to all source files, avoiding the situation where pre-existing object files do not currently reflect the new project options.
Default Project Folder
This option allows the user to specify the directory where Simply Fortran will place new projects by default when creating a new project.
Updates
This category controls Simply Fortran’s checking for version updates. Simply Fortran, by default, will contact a server to determine if there is a newer version available. If enabled, the software will notify the user in the main window’s status bar.
Check for Updates at Start
When Simply Fortran starts, it can optionally contact a server to see if a newer version is available. This can be disabled if, for example, you wish to lock Simply Fortran to the current version.
Check for Updates Now
Clicking this button will check if a new version is available immediately.
Launching
This category contains options related to how Simply Fortran spawns child processes, including programs compiled by the user.
Force launch using system() call with output flushing
Normally, Simply Fortran attempts to use the exec() series of calls to launch child processes for efficiency. However, under some circumstances, the standard output may be buffered and fail to completely display in an internal console if the program completes before output buffers flush. When this item is enabled, Simply Fortran will instead use the system() call to launch a child process. Once the child process completes, Simply Fortran will attempt to explicitly flush buffers and wait a short period before completely shutting down the child’s terminal.