aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authormitchell <70453897+667e-11@users.noreply.github.com>2013-08-26 23:30:32 -0400
committermitchell <70453897+667e-11@users.noreply.github.com>2013-08-26 23:30:32 -0400
commitc0b5f7526d990f675c5a2a8ae2cd5ddfd2f9a6fe (patch)
treea3bbc46b7a4986d134669be5cd253fb2e2054ad6
parent1e9a3d23740844003d6ef06f7a92ccbba11c71f8 (diff)
downloadtextadept-c0b5f7526d990f675c5a2a8ae2cd5ddfd2f9a6fe.tar.gz
textadept-c0b5f7526d990f675c5a2a8ae2cd5ddfd2f9a6fe.zip
Commented on the new role of `_M` in the migration guide; doc/14_Appendix.html
-rw-r--r--doc/14_Appendix.md16
1 files changed, 15 insertions, 1 deletions
diff --git a/doc/14_Appendix.md b/doc/14_Appendix.md
index c1c18669..a586dd27 100644
--- a/doc/14_Appendix.md
+++ b/doc/14_Appendix.md
@@ -145,7 +145,8 @@ non-existant graphics capabilities:
### Textadept 6 to 7
-Textadept 7 introduces API changes and a completely new theme implementation.
+Textadept 7 introduces API changes, a change in module mentality, and a
+completely new theme implementation.
#### API Changes
@@ -206,6 +207,19 @@ try\_encodings |Renamed |[encodings][]
[goto\_file\_found()]: api/ui.find.html#goto_file_found
[encodings]: api/io.html#encodings
+#### Module Mentality
+
+Prior to Textadept 7, the `_M` table held all loaded modules (regardless of
+whether they were generic modules or language modules) and Textadept encouraged
+users to load custom modules into `_M` even though Lua has no such restriction.
+The `_M` prefix no longer makes much sense for generic modules like
+[`textadept`][], so only language modules are automatically loaded into
+[`_M`][]. Textadept 7 does not encourage any prefix for custom, generic modules;
+the user is free to choose.
+
+[`textadept`]: api/textadept.html
+[`_M`]: api/_M.html
+
#### Theme Changes
You can use the following as a reference for converting your Textadept 6 themes