aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc
diff options
context:
space:
mode:
authorGravatar mitchell <70453897+667e-11@users.noreply.github.com>2013-09-15 14:41:34 -0400
committerGravatar mitchell <70453897+667e-11@users.noreply.github.com>2013-09-15 14:41:34 -0400
commit9ccea9e562699b45ba830b8b1355571061580386 (patch)
tree0d908fa3c956254a2e3629a7398fa1c54c7863b3 /doc
parentc683ff20ef76c60cdf79df3c61f267dc3b7073ed (diff)
Do not convert filenames to UTF-8; keep them in `_CHARSET`.
Diffstat (limited to 'doc')
-rw-r--r--doc/14_Appendix.md14
1 files changed, 12 insertions, 2 deletions
diff --git a/doc/14_Appendix.md b/doc/14_Appendix.md
index 5687411e..144a8602 100644
--- a/doc/14_Appendix.md
+++ b/doc/14_Appendix.md
@@ -145,8 +145,8 @@ non-existant graphics capabilities:
### Textadept 6 to 7
-Textadept 7 introduces API changes, a change in module mentality, and a
-completely new theme implementation.
+Textadept 7 introduces API changes, a change in module mentality and filename
+encodings, and a completely new theme implementation.
#### API Changes
@@ -251,6 +251,16 @@ the user is free to choose.
[`textadept`]: api/textadept.html
[`_M`]: api/_M.html
+#### Filename Encodings
+
+Prior to Textadept 7, `buffer.filename` was encoded in UTF-8 and any functions
+that accepted filenames (such as `io.open_file()`) required the filenames to
+also be encoded in UTF-8. This is no longer the case in Textadept 7.
+`buffer.filename` is encoded in `_CHARSET` and any filenames passed to functions
+should also remain encoded in `_CHARSET`. No more superfluous encoding
+conversions. You should only convert to and from UTF-8 when displaying or
+retrieving displayed filenames from buffers and/or dialogs.
+
#### Theme Changes
You can use the following as a reference for converting your Textadept 6 themes