home bbs files messages ]

Forums before death by AOL, social media and spammers... "We can't have nice things"

   comp.lang.forth      Forth programmers eat a lot of Bratwurst      117,951 messages   

[   << oldest   |   < older   |   list   |   newer >   |   newest >>   ]

   Message 117,089 of 117,951   
   dxf to albert@spenarnc.xs4all.nl   
   Re: Gforth manual PDF?   
   17 Feb 25 20:55:30   
   
   From: dxforth@gmail.com   
      
   On 16/02/2025 10:42 pm, albert@spenarnc.xs4all.nl wrote:   
   > In article ,   
   > dxf   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   
      
   --- SoupGate-DOS v1.05   
    * Origin: you cannot sedate... all the things you hate (1:229/2)   

[   << oldest   |   < older   |   list   |   newer >   |   newest >>   ]


(c) 1994,  bbs@darkrealms.ca