From 5f75be2467139ffb8bad2f5099d1c4fdda3652f1 Mon Sep 17 00:00:00 2001 From: Daniel Stelzer Date: Tue, 13 Oct 2026 21:43:34 -0500 Subject: [PATCH 1/2] little manual improvements --- manual/modules/ROOT/pages/software.adoc | 4 +++- manual/modules/lang/pages/io.adoc | 3 +++ 2 files changed, 6 insertions(+), 1 deletion(-) 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: From 415931ad38cffbe539134400c94a243990b8063a Mon Sep 17 00:00:00 2001 From: Daniel Stelzer Date: Tue, 13 Oct 2026 22:02:08 -0500 Subject: [PATCH 2/2] readme --- readme.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/readme.md b/readme.md index f27e1329..152bbe46 100644 --- a/readme.md +++ b/readme.md @@ -69,13 +69,15 @@ wasmtime run --dir=. src/dialogc.wasm story.dg stdlib.dg 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: