Generic FunctionPackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 9.0
This page is new in 9.0.

write-bom-to-utf8-files

Arguments: cg-configuration

This option has an effect only on the Windows platform.

This CG configuration option determines whether the function save-file will write UTF8 byte order marker (BOM) bytes at the beginning of the file, if the file is being saved in UTF8 format (see external-format-for-saved-files and external-format-for-save). This affects the IDE's source code editor as well as calling save-file on a text-edit-pane in a CG application.

This option is true by default so that any software that reads the file can unambiguously determine that the file's format is UTF8. Some file-reading software may stumble over the BOM bytes, though, in which case you could turn this option off if you need to transfer saved files to such software. But note that if you turn this option off and do not also turn on load-utf8-if-no-bom, then load-file would not correctly reload a file that was saved with save-file in UTF8 format if it contains any non-ASCII characters; this affects the IDE's source code editor as well.

This option can be found on the Editor tab of the IDE's Options dialog.


Copyright (c) 1998-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page is new in the 9.0 release.
Created 2019.8.20.

ToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 9.0
This page is new in 9.0.