Path: ...!news.misty.com!weretis.net!feeder9.news.weretis.net!i2pn.org!i2pn2.org!.POSTED!not-for-mail
From: dxf <dxforth@gmail.com>
Newsgroups: comp.lang.forth
Subject: Re: Gforth manual PDF?
Date: Mon, 17 Feb 2025 20:55:30 +1100
Organization: i2pn2 (i2pn.org)
Message-ID: <a7422521d5be0492565ee9c3112e069d3d754134@i2pn2.org>
References: <vonp14$3hgeh$1@dont-email.me>
 <96a4c719cbed4db718e0f8ed0e6bff667a37aa3c@i2pn2.org>
 <nnd$671f3ecd$2e18fa62@99c1c3788638a723>
 <f0aebc074a8aba9e1fff166afbed849369ccecbc@i2pn2.org>
 <nnd$0cfb94c6$52dc5d5e@62460734deb60af5>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
Injection-Date: Mon, 17 Feb 2025 09:55:30 -0000 (UTC)
Injection-Info: i2pn2.org;
	logging-data="440134"; mail-complaints-to="usenet@i2pn2.org";
	posting-account="XPw7UV90Iy7EOhY4YuUXhpdoEf5Vz7K+BsxA/Cx8bVc";
User-Agent: Mozilla Thunderbird
Content-Language: en-GB
In-Reply-To: <nnd$0cfb94c6$52dc5d5e@62460734deb60af5>
X-Spam-Checker-Version: SpamAssassin 4.0.0
Bytes: 2868
Lines: 35

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