Shop OBEX P1 Docs P2 Docs Learn Events
Word Glossary for Tachyon NEON V5 — Parallax Forums

Word Glossary for Tachyon NEON V5

bob_g4bbybob_g4bby Posts: 401
edited 2022-09-29 09:31 in Forth
This is where to come for the current Word Glossary for Tachyon 5v7, an EEPROM resident forth system on the Parallax Propeller 1. When coding, it's suggested to keep the .pdf glossary open on your screen next to the terminal and use the bookmarks to jump to the various sections. e.g. Maths, Stack, Memory etc. The CTRL F shortcut is good for finding individual words.
The glossary is now at version 1.6 and was written in LibreOffice Writer (the .odt file is the original doc). All the public words are at the front, all the private words (internal words useful only within a code module) are at the back. For most programmers, the public words are all you need. If you spot any issues, would like changes or have some additions, this discussion is the place to tell us. The glossary will get up-issued to fill in any gaps as more is learnt about Tachyon. I've enjoyed overhauling the glossary - and it's good to contribute something back to the Tachyon community.
Useful Tachyon and TAQOZ links
Tachyon Encyclopedia
Tachyon Forth News
Tachyon Neon forum discussion
Tachyon Juno forum discussion
Tachyon Dawn forum discussion
ASCII table
Bob Edwards, ham radio operator and constructor G4BBY, SW U.K.

Comments

  • Would be great to have a link to Tachyon NEON v5 also in the top post.

    Thanks for putting this together!
  • Peter JakackiPeter Jakacki Posts: 10,193
    edited 2020-10-05 02:17
    Hi Bob,

    I've created multiple Google documents to make this easier to update and keep up-to-date. While the office document is easier to work with on the PC, it doesn't lend itself to viewing on a mobile device. Large google docs tend to be slow so what I've done is factored out all the extra stuff into other documents that are linked to in the main glossary. But there's also a lot of stuff that is not right at all for V5 since this glossary was borrowed from older bytecode versions, so I am in the process of fixing that up.

    I'm finding that this smaller glossary is ideal for the beginner and the links to the sub-documents are all that we need. In which case we can link to documents dedicated to examples and demos etc. In which case the glossary becomes more of a user manual.

    Tachyon Forth V5 Glossary (EDIT VERSION)

    non-editable pubdoc version
  • What sections are obsolete? Do you mean the cog ram variables, which I haven't touched so far?
  • bob_g4bby wrote: »
    What sections are obsolete? Do you mean the cog ram variables, which I haven't touched so far?

    I was reading the dictionary description that I had originally written some time back and it was talking about the msb of the attribute being set etc which was the case in previous versions. In fact the document that this glossary was based on I created back in 2014 and there have been a lot of changes. So there was that section and I also started checking right from the start with V5 running on a board. So I'm slowly going through each word and fixing up any discrepancies such as duplicates and non-existing words. I'm putting this into a google doc so that it's easier to collaborate on, but that does not prevent it from being recombined into an office document and pdf either.

    So I'm trying to fix things up on my end and treating these online documents as a convenience if need be although they are convenient on my phone I notice.



  • bob_g4bbybob_g4bby Posts: 401
    edited 2020-10-05 17:34
    That sounds good. The new glossary is pretty close to the output of 'WORD', I looked for both new words and obsolete words in two passes, which is why it took a little while. Then I did a third pass to add pub/pri/pre column. I have removed some duplicates and you may find more. At least i've done all the donkey work on it, which makes it much less a chore to add the recent detail. I'll update my office doc late this year, I think. I'm back to my SI5351 driver, on which I had writer's block! I've also ordered a couple of esp8266 to try out.
  • Hi, Bob,
    thank you for your work here! And thank you, for bringing this into foreground!
    :)

    There is :=! in your document. In my opinion, the version in extend.fth does not work.

    Christof

  • Hi Christof,
    You are very welcome - I hope the glossaries have encouraged people to try out Tachyon and Taqoz.

    Concerning :=! just check this and see if it works for you (there's a similar example in the glossary in the :=! comment field):-

    1. Make a constant like this : MYCONST 5 ;
    2. Check it works MYCONST . --- 5 ok
    3. Change its value 3 ' MYCONST :=!
    4. Recheck it works MYCONST . --- 3 ok

    Constants made with the := word cannot be changed in this way! Not the best syntax as := and :=! seem to be a set but aren't.
    Cheers, Bob

  • rwl7532rwl7532 Posts: 23
    edited 2022-11-22 18:05

    I have downloaded the glossary linked in first post.
    byte, long etc. are missing. That seems odd.
    byte would hold 0 -255 (figured by the name)
    long - well I haven't a clue as glossary is silent.

    A list of all such words and range of values they can hold would be of value.

    Any Programming 101 course in C or C++ will discuss such data types.
    The K&R first mentions on page 9 int -32768 to +32768 yet Tachyon glossary is silent.

  • Christof Eb.Christof Eb. Posts: 1,087
    edited 2022-11-22 17:14

    @rwl7532 said:
    I have downloaded the glossary linked in first post.
    byte, long etc. are missing. That seems odd.
    byte would hold 0 -255 (figured by the name)
    long - well I haven't a clue as glossary is silent.

    A list of all such words and range of values they can hold would be of value.

    Any Programming 101 course in C or C++ will discuss such data types.
    The K&R first mentions on page 9 int -32768 to +32768 yet Tachyon glossary is silent.

    A fix is in order!

    @rwl7532
    Are you aware, that both Tachyon and this glossary are written by people, who have invested many many hours and did not get any money for this???? I am writing this because of your tone.
    word= 16 bit.
    long= 32 bit.

  • @"Christof Eb." said:

    @rwl7532 said:
    I have downloaded the glossary linked in first post.
    byte, long etc. are missing. That seems odd.
    byte would hold 0 -255 (figured by the name)
    long - well I haven't a clue as glossary is silent.

    A list of all such words and range of values they can hold would be of value.

    Any Programming 101 course in C or C++ will discuss such data types.
    The K&R first mentions on page 9 int -32768 to +32768 yet Tachyon glossary is silent.

    A fix is in order!

    @rwl7532
    Are you aware, that both Tachyon and this glossary are written by people, who have invested many many hours and did not get any money for this????

    Totally aware of that. But your comment doesn't address why such a fundamental building block would be missing.

  • @rwl7532 said:
    ...
    A fix is in order!

    Is that an offer from you to reach out and help with improving this glossary ?
    I really would like to think so.

  • rwl7532rwl7532 Posts: 23
    edited 2022-11-22 18:06

    @Maciek said:

    @rwl7532 said:
    ...
    A fix is in order!

    Is that an offer from you to reach out and help with improving this glossary ?
    I really would like to think so.

    I'm just starting with the P1. I've been at FORTH for just a little more than a year. Previous FORTHs had the simple variable declaration. Tachyon does not. Then I learned byte to declare a byte sized variable. The others seem shrouded in mystery which is frustrating.
    Please excuse "A fix is in order!" like I could ever demand anything from the FOUTH community.
    That has been removed.

  • bob_g4bbybob_g4bby Posts: 401
    edited 2022-11-23 09:18

    Hi @rwl7532 , Tachyon is a bit different, so I wrote the glossary for it. You may not be aware that the glossary has a 'Table of Contents' menu if you're reading it directly from github. After downloading the glossary and opening it in Acrobat Reader, you have to press the button highlighted with the red arrow to get the menu to appear (sometimes). 'Constants and Variables' is the section you want. Happy forthing - ask all the questions you need. If Tachyon gets you interested enough, I recommend trying Taqoz on the Propeller 2 - there's much more memory to play with, the processors are much faster, and Taqoz is better organised - but still non-standard. The P2 EVAL board is quite expensive for a hobbyist, but this lower cost board is nearly as good.
    Cheers, Bob
    P.S. This was one of my first glossaries and the headings are not in alphabetic order. Would folks like them rearranged or leave it as it is? The Taqoz glossary, written later, has all headings in alphabetic order.

  • @bob_g4bby Appreciate the response! My tablet pdf reader apparently lacks as there is no TOC when using it. It was there when I used my Ubuntu laptop! Nice! When I got to the CONSTANTS and VARIABLES section I couldn't help noticing (for instance) the range of values that byte holds is not included. Originally I thought byte held only positive values 0-255. I'm still learning!
    I also will be looking for a better pdf reader for my tablet. Due to my eyesight, this tablet (Galaxy Tab S6 Lite) is my preferred.

  • rwl7532rwl7532 Posts: 23
    edited 2022-11-26 00:47

    @bob_g4bby I also would like to add that some glossaries or Tachyon summaries have a column headed CONSOLE EXAMPLES. Those really talk to me !

Sign In or Register to comment.