Re: Gforth manual PDF?

On 16/02/2025 10:42 pm, albert@spenarnc.xs4all.nl wrote:

In article <f0aebc074a8aba9e1fff166afbed849369ccecbc@i2pn2.org>,
dxf  <dxforth@gmail.com> wrote:

On 15/02/2025 10:33 pm, albert@spenarnc.xs4all.nl wrote:

...
In ciforth I generate a separate html, as a quick reference, with
elaborate see also sections that you can click through. It starts with
an alphabetic glossary index.

>
Checking my glossary file I should be able to do something similar.
Key is identifying each entry (word).  As these uniquely begin with a single
space there should be no false hits.  From there it will be easy to bookmark
and generate an index.  It seems I've found myself a new forth project :)

 
The great effort is in the ALSO's. You don't want to leave important references
out. On the other hand you don't want to reference too many words,
that are only relevant if you need an in depth knowledge. It is a compromise
and time and again I discover that I have left an essential reference that a
user couldn't easily find, or that a reference isn't important enough to keep.
 
In 2000 I invested in a bunch of m4 macro's that aid in grouping and
alphabetizing word's. For all new Forth's I run the macro's after
adding, removing and redacting doc's for new or changed words.
There is some 10 Forth's now using that.
 
https://github.com/albertvanderhorst/ciforth
 
For example I generated a FreeBSD Forth in days, with doc's instantly
usable.

I didn't need anything fancy - hyperlinks for existing references and a word
index.  It came together easier than I expected.  There were some false hits
requiring minor tweaks to the source file.  Anyway, here's the result:

https://pastebin.com/8xpT6gj1