DocGen tests

Tags with three characters

A paragraph produced by a three-character tag '*PA'. and this is the continuation.

A simple heading.

Division produces a quotient q and a remainder r by dividing operand a by operand b. Division operations return q, r, or both. The identity

  b*q + r = a

shall hold for all a and b.

Conditionals

This line should show 1111111

This line should show all 0000000s

Words

: foo1  ( -- )
Says hello

: foo2  ( -- )
Says goodbye

lists

Old style list

Old style list

  • Item 1 continue item 1 text
  • Item 2
  • Item 3
  • New style lists

    New style lists

    1. Item 1
    2. Item 2
    3. Item 3
    1. Item 1
    2. Item 2
    3. Item 3
    1. Item 1
    2. Item 2
    3. Item 3

    Old style list

    Old style list

  • Item 1
  • Item 2
  • Item 3



  • Macro usage

    Simple Macros

    Displays text in a fixed typewriterfont.

    More fixed text : 1+ 1 + ; .

    Do some inline forth \#no-name: QUIT,.

    Do some inline forth : 1+ 1 + ;,.

    Make text italic Italic.

    Make text italic Other italic text..

    Make text bold Bold.

    Make text bold #Bold text..

    This sentence needs a line break
    , text between {} gets ignored.

    There comes a time in every sentence's life when a *\ is required.

    Tables

    Cortex register Forth register Notes
    R15 or PC IP The program counter. Altering this register will cause the processor to jump to a new address.
    R14 or LINK _

    Dictionary Organisation/Manipulation

    The heart of any Forth system is the dictionary. There are two types of word which act on the dictionary. The first are those words which act on definition headers, whilst the second set act on dictionary "data-space."

    Definition Header Structure

    Definitions created with any standard defining word except :NONAME have a header within the dictionary. The header format is:

    
    Link | Ctrl | Count | <name> | Term | Line# | Info | XRef | Len/xt | Cgen
    -------------------------------------------------------------------------
    Cell | Byte |  Byte | n Bytes| Byte |  Word | Word | Cell |  Cell  | Cell
    -------------------------------------------------------------------------
    

    Link

    Also called LFA. This field contains the address of the "Ctrl Byte" of the previous word in the same wordlist.

    Ctrl

    The Control Byte: The top three bits are all set. The lower five bits are:

    
               Bit4    SYNONYM bit
               Bit3    Smudge bit
               Bit2    Immediate bit
               Bit1    ** bit
               Bit0    *** bit
    

    Count

    Also called the Count Byte. This field contains a byte which is the length of the name.

    <name>

    A string of ASCII characters which make up the definition name.

    Term

    All definition names are terminated with a 0 ASCII byte.

    Line#

    This field holds the line number of the first line of source which built the definition. The actual source file reponsible can be found from the SOURCES structure described in the FILE section of this manual.

    Info

    MPE/CCS Reserved field. low byte for MPE, high byte for CCS bit 0: 1 = optimised bits 7:4 = RS undershoot.

    XRef

    Pointer to XREF Information

    Len/xt

    Binary length of the word, or the xt of the code generator for this word.

    Cgen

    Holds the address of additional code generator information.

    Image example


    logo text 1