ProgramEdit

Options Help

PgmEdit - Option Settings

PgmEdit home

The Tools/Option Settings menu provides customization of Font style and size, Date-Time Formats, Wordwrap margins, Editing, Hexadecimal file preview, Line Change Indicators, File and Settings Backups, Help file source, and Version check.

Note - Both Color Settings and Option Settings can be unique for each Session.

1.  Font

Size (in points) - Once the Font is selected, Font size can be adjusted and viewed by clicking the Up/Down arrows of the Size box.  The size (in points) can range from 1 to 32.

Tip - Large font-size changes may require resetting Bookmarks.

Fixed-width - If this box is checked (recommended for code editing), Font selection will be limited to monospaced fonts, also called fixed-pitch, fixed-width or non-proportional fonts.  Otherwise all fonts on your PC are available for selection.

CAUTION - A fixed-width font must be selected to enable PgmEdit's Column Edit functions.

Font button - The font family can be selected by clicking the Font button.  This opens the Font dialog.  Select the desired "Font:" and click OK.  Note that the dialog "Font style:" and "Size:" sections are not used.

Courier New/9pt is the default font/size.  Consolas and Lucida Console fixed-width fonts are also recommended.

Tip - If Consolas font is selected, it may look better by turning on ClearType (via the Control Panel).

2.  Date format

The default Date format is, for example, "1/01/2001". This default format will be used for the Edit/Date function if the Options/Date Format d-m-y code is blank or if it is set to "m/dd/yyyy".

A variety of user-defined date formats are possible using the d (day), m (month), and y (year) codes as shown in the following table.  The Day Date/Month Date/Year Date results are shown for a date of 1/1/2001.

day Day Date month Month Date year Year Date
d 1 m 1 y 01
dd 01 mm 01 yy 01
ddd Mon mmm Jan yyy 2001
dddd Monday mmmm January yyyy 2001

Tip - The d, m, y codes can be in any order, and can be separated by one or more punctuation characters such as a space, "/", ":" or "-".   For example:

  "m/dd/yyyy" generates "1/01/2001"
  "yyyy:dd:mm" generates "2001:01:01"
  "mmm dd, yyyy" generates "Jan 01, 2001"

3.  Date and Time format

Five Date-Time formats are available: 1) short date & short time  2) short date & long time  3) long date & short time  4) long date & long time  5) sortable date & time.

The formats in the Date and Time drop-down list are illustrated with a date of "1/1/2001" and a time of "4:45:20 PM"

4.  Word Wrap margins

PgmEdit "Word wrap" provides an easy way to make long lines of text more readable.

If you apply the Word wrap shortcut (Ctrl+W) to each long line, multiple long lines can be quickly shortened to fit within the Word wrap Left/Right margins.

Option Settings/Word wrap margins can set the Left-hand margin (to add leading spaces), and set the Right-hand margin (to limit the length of long lines).   For each long line, a line-feed (LF) is added after the last word or word-separator that ends at or before the Right-hand margin value.

The default LH and RH margin values are 1(text starts at Column 1) and 80(text ends at Column 80).

Also see View/Word Wrap Auto .

5.  Editing

Auto Indent - When the Enter key is pressed, the next line will start with the same leading whitespace (tabs and/or spaces) as the previous line.

Insert spaces instead of Tab - The tab key can either (1) operate normally (insert a Horizontal Tab character) or
(2) it can Insert spaces instead of the Tab character.

Option (2) is recommended since it is more transportable (spaces are independent of Tab stop settings in other applications).  Check the "Insert Spaces instead of Tab" box for Option 2.

Tab Size - This is the number of spaces between tab stops.  The default value is 4.

6.  Hexadecimal file view - Preview

Files can be viewed as a read-only list of hexadecimal codes(00-FF).  Hexadecimal displays of large files(1MB or larger) may take a long time to load and may be slow to navigate.

By checking the Preview mode box, only the first 10,000 hex lines are displayed.

7.  Overwrite text - Show MsgBox

Occasionally the Insert key may be accidentally pressed changing the Insert mode to Overwrite.  If Show MsgBox is checked, a MessageBox will display "Overwrite text mode selected".

8.  Line Change Indicators

Line Change Indicators (bars on the left-hand side of the Window) show the most-recent lines that have been edited.  The maximum number of indicators that may be shown (0-99) can be set in the Options/Change Indicators (maximum) box.

For example: A Change-Indicators value of 0 will show no Change indicators, while a Change-Indicators value of 10 will show the 10 most-recent line changes.

All Change indicators are cleared when the edited file is saved, or when all changes are removed by editing or by using UnDo(Ctrl+Z).

9.  File Backups

The File Backup options can be set to automatically create backup files.  The backup files can then be used as needed to restore files that have been lost or corrupted by user errors, software bugs, or hardware anomalies.  Backup files can also be used to fall back to a previous version of code that worked better than a new trial-code revision.

Note - As for all (non-Global) PgmEdit Settings, Backup Settings can be identical or unique for each Session.

RECOMMENDATION - Important files should be periodically backed-up for long-term safety and saved in a dated Zip file, such as "files_bak 2020-10-29.zip".

Backup when save - Off / First save only / Every save

1. Off - File Backup is turned off for all files

2. Backup on first save only - A backup file is created only on the first save after the file-being-edited is opened.

3. Backup on every save - A backup file is created on every save of the file-being-edited.

Location of backup files - BackupFiles folder / Folder of file being edited / 'n' files (maximum)

1. BackupFiles folder - Located in the ProgramEditor\bin folder which is in the PgmEdit installation directory.

   This folder can be opened by clicking the "File/Open BackupFiles folder" menu item.

2. Folder of file being edited - This is generally the current Session folder, but the file-being-edited may be in any folder on any drive.

3. 'n' files (maximum) - 'n' is the maximum number (1-9) of backups for each file.

File-backup file names

Each backup file will have the same name and extension as the file-being-edited plus a ".bak'n' " extension.
For example: The most-recent backup file for Abc.txt will be named Abc.txt.bak1, the next-most-recent backup file for Abc.txt will be named Abc.txt.bak2, etc.

10.  Spell Check Dictionary

This option selects the default Spell Check dictionary.

An American English (en-US) spelling dictionary is installed with ProgramEdit.  Spelling dictionaries for other languages (French, German, Italian, Spanish) can be installed using the Spell Dictionary Installer tool.

See Spell Check Help for more information about dictionary installation.

11.  Settings Backups - Global option

PgmEdit Settings (Colors, Options:font/margins/tabs, shortcuts, file names) are automatically saved each time that PgmEdit is closed.

Note - This Option is "Global" - a Built-In/Web selection made in any Session will be copied to all Sessions.

These Settings are saved in the bin\BackupSettings folder or in a Sessions\(session name)\BackupSettings folder (if a session is open).  The Settings are saved in files named PgmEdit_Config01.txt, PgmEdit_Config02.txt, etc.  Up to 'n' of the most-recent backup files are saved, where 'n' is the number (1-9) in the Options/Settings backups "files (maximum)" box.
Note that PgmEdit_Config01.txt is the most-recent Settings file, while PgmEdit_Config0'n'.txt is the oldest.

The File/Restore Settings menu item can be used to restore PgmEdit Settings to a previous configuration by selecting a PgmEdit_Config0n.txt file, clicking "Open" and then "OK".

Note - this restores PgmEdit Settings only - File changes are not restored by "Restore Settings".

12.  Help File source - Built-In / Web - Global option

PgmEdit Help files can be opened from either the ProgramEditor\bin\SupportFiles folder or the PgmEdit web site - http://www.simplesolverlogic.com.

Note - This Option is "Global" - a Built-In/Web selection made in any Session will be copied to all Sessions.

Notes - If the "Web" option is selected and the Internet or web site is not available, Help files will be loaded from the SupportFiles folder.

The SupportFiles folder is updated each time a new PgmEdit version is installed, while the Web site is updated when a new version is released or a Help file is improved/corrected.

13.  PgmEdit Version check - Global option

PgmEdit can be configured to periodically read the most-current PgmEdit version number from the SimpleSolverLogic web site.  If the version number is newer, "New Version Available" will be displayed at the top-right corner of the PgmEdit window.   Note - Version checks are only done when PgmEdit is starting up.

Note - This Option is "Global" - Version check settings selected in any Session will be copied to all Sessions.

The Enable checkbox enables/disables the periodic reading/checking.

The number in the "Days" box selects the number of days between version checks.  For example "5" Days will provide a check once every 5 days.  The Days number can be from 1 to 99.

Note - If enabled, Version-check will delay (by typically 10 seconds) PgmEdit's startup once every "n" days.

Version-check Security - The SimpleSolverLogic web site requires the client PC to have Transport Level Security (TLS) 1.2 or higher to read the PgmEdit Version number.  TLS 1.2 may not be available on older PCs (such as XP or Vista) which will cause an error message of "Version_check Error: The requested security protocol is not supported."

To eliminate these error messages, uncheck the Options/PgmEdit Version-check "Enable" check-box.