File Options Dialog box

Sharing

Enable this to allow other programs to modify the files that are open in Source Insight. In other words, a file that is open in Source Insight can be written over by another program. Turning this on will cause Open and Save operations to be a little slower, and it will use more disk space for each open file.

Disable this to give Source Insight exclusive write access to the files. Files will still be opened in read-only mode, except during Save operations. However, other programs will not be able to open the same files for writing. This is also a little faster.

Reload externally modified files in background

Turn this on to enable Source Insight to detect that files have been modified externally. Files are reloaded automatically. Files are checked every few seconds and whenever the Source Insight application window comes to the front. Each modified file is reloaded silently, without any prompting, unless the Ask before reloading modified files option is on, or you have edited the file in Source Insight.

If disabled, you can still run the Reload Modified Files command to manually force Insight to reload any modified files that are found.

Ask before reloading modified files

If enabled, then Source Insight will prompt you when it detects that a file has been modified externally to see if you want to reload it.

If disabled, then Source Insight will automatically reload externally modified files silently without any prompting, unless you have also edited the file in Source Insight. If you have already edited a file, the reload operation is not performed.

Assume ^Z (ASCII 26) is End-Of-File

If enabled, then Source Insight will stop loading a file when it sees the EOF (ASCII 26) character. When it saves the file, an EOF character will be appended to the end. If disabled, then Source Insight will continue to read past the EOF character.

Customize the Open Command

This lets you pick the action performed by the Open command. The Open command is normally assigned to Ctrl+O, and it has a toolbar button.

Make backup files when saving

If checked, then Source Insight will move the previous version of a file on disk to the backup directory whenever it saves the file. The backup directory is stored in a subdirectory named “Backup” in the Source Insight program directory.

If not checked, then Source Insight will save files without preserving the previous version on disk.

Save All command will query on each file

If checked, Source Insight will ask you if you want to save each modified file when running the Save As command. You will have an opportunity to save it, not save it, or cancel the Save As operation on each file.

If not checked, Source Insight will go ahead and automatically save all files that have been modified since the last time they were saved.

Save all files when Source Insight program is deactivated

If checked, Source Insight will automatically perform a "Save All" command when the Source Insight application window loses focus (i.e. every time you activate a different application). This enables you to work with another editor or IDE that has the same files open. For example, if you switch to your IDE application then Source Insight will automatically save all edited files to disk. If not checked, Source Insight will not save files when deactivated.

Save over read-only files without prompting

If checked, then Source Insight will save over a read-only file without warning you it is read-only. Actually, you will be warned the first time you attempt to save over a read-only file in a session.

If not checked, then Source Insight will prompt you for each read-only file that is saved. You will still have the option of overwriting a read-only file on a file-by-file basis.

When Source Insight saves over a read-only file, the file is changed to read/write.

Note: This option is not recommended, as you may accidentally write over valuable files that are read-only for a good reason. This option may be of use if your source control system will respect a read/write file as “checked out”. Thus, you can edit and save files before you check them out.

Preserve Undo and revision marks after saving

If enabled, then you will be able to perform Undo, and see revision marks, even after you save a file.

Allow editing Read-Only file buffers

This option lets you to edit a file buffer, even if it is marked read-only. You will not be able to save back to the file, unless you change its permissions to read/write outside of Source Insight, or you explicitly overwrite the read-only file by clicking the “Overwrite” button during saves. Depending on your source control system, you may be able to check out your version of the file, and then return to Source Insight and save the file.

Note that when you edit a file buffer inside Source Insight, you are not changing the file on disk until you use the Save command, or you cause Source Insight to save the file some other way, such as task switching out of Source Insight to another program when you have the Save all files when Source Insight is deactivated option enabled.

Remove extra white space when saving

This option will cause any trailing space or tab characters to be stripped off each line when a file gets saved.

Confirm all file deletions

Source Insight will confirm before deleting any source files. Source Insight does not delete source files when you remove them from a project, or when you delete a project. It only deletes the project data files created by Source Insight. However, you can select a source file in the Project Window and delete it.

Default file format

This specifies the default text file format used when Source Insight saves new source files. The formats differ by their end-of-line characters, which are indicated by CR for Carriage Return and LF for Line Feed. The formats are:

Window (CR/LF)

Unix (LF)

Mac (CR)

Note that when Source Insight opens an existing file and saves it, it will preserve the original file's format. You can save to a different format with the File > Save As command.