diff --git a/manual/modules/ROOT/pages/software.adoc b/manual/modules/ROOT/pages/software.adoc index 05c129ab..d9ada22c 100644 --- a/manual/modules/ROOT/pages/software.adoc +++ b/manual/modules/ROOT/pages/software.adoc @@ -14,7 +14,7 @@ interactive debugger, as well as pre-built executable files for Linux The compiler is called `dialogc`, and the debugger is called `dgdebug`. Alternately, if you are on OS X, you can install the -[Homebrew package manager](https://brew.sh/), +https://brew.sh/[Homebrew package manager], and then use the command `brew install dialog-if/brew/dialog`, which will install `dgdebug` and `dialogc`. This command also installs Dialog's standard libraries (`stdlib.dg` and `stddebug.dg`) to either `/opt/homebrew/share/dialog-if` or `/usr/local/share/dialog-if` @@ -31,6 +31,8 @@ the directory that contains them. The graphical version of the debugger on Windows makes use of a third-party library, _Windows Glk_ by David Kinder. Make sure to put the two included `DLL` files in the same directory as the executable file (`dgdebug_gui.exe`). +Along with being harder to install, the graphical debugger struggles with +non-Latin letters, so the plain `dgdebug.exe` is recommended. To check that everything is in place, try the following two commands: diff --git a/manual/modules/lang/pages/io.adoc b/manual/modules/lang/pages/io.adoc index 53b7aee9..d614a7e8 100644 --- a/manual/modules/lang/pages/io.adoc +++ b/manual/modules/lang/pages/io.adoc @@ -619,6 +619,9 @@ then Dialog will attempt to remove certain word endings, and check whether the remaining part of the word exists in the dictionary. This procedure is necessary for games written in e.g. German, whereas English games generally do not require it. +(Note that this will _only_ happen if the word is not recognized; if the full +word, including its ending, is found in the game dictionary, then the ending +will not be removed.) To specify removable endings, add one or more rule definitions to the predicate `(removable word endings)`. Each rule body should consist of one or more word endings: diff --git a/readme.md b/readme.md index e857c075..0d2d6c8b 100644 --- a/readme.md +++ b/readme.md @@ -74,13 +74,15 @@ This version of Dialog now requires version 1.1 of the Å-machine. Compiler: improved dictionary word matching accuracy. - Compiler: Improved ordering of strings in WRIT chunk, which + Compiler: improved ordering of strings in WRIT chunk, which improves performance on slow platforms like 6502. Debugger: fails more gracefully when given non-ASCII word separators. - Distribution: Convert the repository readme to markdown. + Distribution: convert the repository readme to Markdown. + + Manual: minor clarifications and wording improvements. ### 1c/03, Lib 1.2.3: