aboutsummaryrefslogtreecommitdiffstats
path: root/erts
diff options
context:
space:
mode:
authorPatrik Nyblom <[email protected]>2010-12-01 17:35:40 +0100
committerPatrik Nyblom <[email protected]>2010-12-01 17:35:40 +0100
commit3e6877b06ae395a9d4310ef664d0360867a47f62 (patch)
tree062f946058070f1c384be9c87f43d48a7d1c0e5d /erts
parent1ab2f46d91bce11bdc5b7ec65d3b3df46eadb105 (diff)
downloadotp-3e6877b06ae395a9d4310ef664d0360867a47f62.tar.gz
otp-3e6877b06ae395a9d4310ef664d0360867a47f62.tar.bz2
otp-3e6877b06ae395a9d4310ef664d0360867a47f62.zip
Add documentation about raw filenames and Unicode file name translation mode
Diffstat (limited to 'erts')
-rw-r--r--erts/doc/src/erl.xml13
1 files changed, 13 insertions, 0 deletions
diff --git a/erts/doc/src/erl.xml b/erts/doc/src/erl.xml
index 9224d73b6f..77bd952d41 100644
--- a/erts/doc/src/erl.xml
+++ b/erts/doc/src/erl.xml
@@ -550,6 +550,19 @@
<p>Force the <c>compressed</c> option on all ETS tables.
Only intended for test and evaluation.</p>
</item>
+ <tag><c><![CDATA[+fnl]]></c></tag>
+ <item>
+ <p>The VM works with file names as if they are encoded using the ISO-latin-1 encoding, disallowing Unicode characters with codepoints beyond 255. This is default on operating systems that have transparent file naming, i.e. all Unixes except MacOSX.</p>
+ </item>
+ <tag><c><![CDATA[+fnu]]></c></tag>
+ <item>
+ <p>The VM works with file names as if they are encoded using UTF-8 (or some other system specific Unicode encoding). This is the default on operating systems that enforce Unicode encoding, i.e. Windows and MacOSX.</p>
+ <p>By enabling Unicode file name translation on systems where this is not default, you open up to the possibility that some file names can not be interpreted by the VM and therefore will be returned to the program as raw binaries. The option is therefore considered experimental.</p>
+ </item>
+ <tag><c><![CDATA[+fna]]></c></tag>
+ <item>
+ <p>Selection between <c>+fnl</c> and <c>+fnu</c> is done based on the current locale settings in the OS, meaning that if you have set your terminal for UTF-8 encoding, the filesystem is expected to use the same encoding for filenames (use with care).</p>
+ </item>
<tag><c><![CDATA[+hms Size]]></c></tag>
<item>
<p>Sets the default heap size of processes to the size