Hello, after an hour of digging:
The refcard was not regenerated by me when updating the web page. So that explains why the link entry is missing on the page. The refcard page itself, namely >> http://amforth.sourceforge.net/TG/refcard.html is still there, because I did not dare to start with an empty directory. Strictly speaking his page is a "leftover". There is a script trunk/tools/make-refcard-rst which looks suspiciously like it had been used to generate this particular page. However, this script is not referenced anywhere :-( There is a piece of dokumentation > http://amforth.sourceforge.net/TG/Tools.html which mentions "makerefcard" and "make-htmlwords" scripts. The first I cannot find in the available repository. The second is still there. Found in trunk/tools, the scripts make-refcard-rst, make-refcard, and make-htmlwords are perl scripts. All three define this: > my $asmdir="../core/words"; The trunk/core directory was moved elsewhere in release 5.6. make-refcard defines: > my $version="5.4"; and make-refcard-rst defines: > my $version="5.1"; So I suspect that these tools have been broken for a long time. Release 5.6 added the msp430 target and thus the tree layout was rearranged. So this does not look like "easily fixable" at all, I'm afraid. - the refcard needs to accomodate the "common" case and words specific to 4 target controllers. - the refcard must be generated from the source files, anything else is asking for trouble and errors. The existing script did cover the asm sources only, not any available forth commands. - the refcard needs to be generated as .rst, and then converted to html for the web page. There are also latex and epub files in the tree, which are probably generated from the .rst files. Possible paths forward? Can we understand in detail, how the scripts did work before release 5.6? Probably. Can we understand, how the tree layout and the code has changed? And what we need to do in order to generate the refcard from sources? Probably, it just sounds like quite a bit of work. After that we can see, how to accomodate the generation of the refcard across targets. If anyone feels like spending some time on this, please go ahead and please report your findings here on this list. Cheers, Erich Erich Wälde writes: > Hello Martin, > > > Martin Nicholas via Amforth-devel writes: > >> Somehow this has gone from the RH menu: >> http://amforth.sourceforge.net/TG/refcard.html > > Good point, thanks for the report. > > Some time back I had a conversation with Matthias about the > reference card. > - it has grown unbelievably > - it should be generated automatically from the source files > /somehow/ > - it might be out of date at any place. > > So, please folks, feel free to report anything that looks wrong. > > Cheers, > Erich -- May the Forth be with you ... _______________________________________________ Amforth-devel mailing list for http://amforth.sf.net/ Amforth-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/amforth-devel
