X-Git-Url: https://git.rrq.au/?a=blobdiff_plain;f=reference.adoc;h=caeedbc8df6330764a6f76a87c9642cf659a8afb;hb=69f36d333521b482b3b92349c1dccb654f43b65b;hp=0d71f8fd0194146821ceec8aeff4bddb06ea33b6;hpb=b7da3f7bbd1cb10241163abdb950472e539e796d;p=rrq%2Frrqforth.git diff --git a/reference.adoc b/reference.adoc index 0d71f8f..caeedbc 100644 --- a/reference.adoc +++ b/reference.adoc @@ -1,113 +1,251 @@ -RRQFORTH Reference Documentation -================================ -// :toc: += RRQFORTH Reference Documentation +:author: Ralph Ronnquist +:mult: * -// include::compile.adoc[] +== Words Descriptions + +include::adoc/inline_code.adoc[] +include::adoc/p_0branch.adoc[] +include::adoc/p_0equal.adoc[] +include::adoc/p_0less.adoc[] +include::adoc/p_1branch.adoc[] +include::adoc/p_2drop.adoc[] +include::adoc/p_2dup.adoc[] +include::adoc/p_2get.adoc[] +include::adoc/p_2over.adoc[] +include::adoc/p_2put.adoc[] +include::adoc/p_2swap.adoc[] +include::adoc/p_Ccomma.adoc[] +include::adoc/p_Cget.adoc[] +include::adoc/p_Cput.adoc[] +include::adoc/p_Rget.adoc[] +include::adoc/p_Rgt.adoc[] +include::adoc/p_abs.adoc[] include::adoc/p_allot.adoc[] +include::adoc/p_and.adoc[] +include::adoc/p_args.adoc[] include::adoc/p_base.adoc[] -include::adoc/p_Ccomma.adoc[] +include::adoc/p_begin.adoc[] +include::adoc/p_branch.adoc[] +include::adoc/p_cfa2flags_get.adoc[] +include::adoc/p_clear_stream.adoc[] include::adoc/p_colon.adoc[] include::adoc/p_comma.adoc[] include::adoc/p_create.adoc[] +include::adoc/p_current_wordlist.adoc[] +include::adoc/data_stack.adoc[] include::adoc/p_decimal.adoc[] -include::adoc/p_does.adoc[] -include::adoc/p_evaluate_stream.adoc[] -include::adoc/p_here.adoc[] -include::adoc/p_hex.adoc[] -include::adoc/p_left_bracket.adoc[] -include::adoc/p_literal.adoc[] -include::adoc/p_literal_string.adoc[] -include::adoc/p_number.adoc[] -include::adoc/p_right_bracket.adoc[] -include::adoc/p_state.adoc[] -include::adoc/p_this_word.adoc[] - -//include::logic.adoc[] -include::adoc/p_0equal.adoc[] -include::adoc/p_0less.adoc[] -include::adoc/p_and.adoc[] -include::adoc/p_equal.adoc[] -include::adoc/p_false.adoc[] -include::adoc/p_greaterequal.adoc[] -include::adoc/p_greaterthan.adoc[] -include::adoc/p_lessequal.adoc[] -include::adoc/p_lessthan.adoc[] -include::adoc/p_not.adoc[] -include::adoc/p_or.adoc[] -include::adoc/p_true.adoc[] -include::adoc/p_unequal.adoc[] -include::adoc/p_within.adoc[] -include::adoc/p_xor.adoc[] - -// include::math.adoc[] -include::adoc/p_abs.adoc[] +include::adoc/p_depth.adoc[] +include::adoc/p_dfa2tfa.adoc[] +include::adoc/p_digits.adoc[] +include::adoc/p_div.adoc[] include::adoc/p_divmod.adoc[] -include::adoc/p_minus.adoc[] -include::adoc/p_mult.adoc[] -include::adoc/p_negate.adoc[] -include::adoc/p_plus.adoc[] - -//include::rrqforth.adoc[] -include::adoc/data_stack.adoc[] -include::adoc/inline_code.adoc[] -include::adoc/p_0branch.adoc[] -include::adoc/p_args.adoc[] -include::adoc/p_branch.adoc[] include::adoc/p_dodoes.adoc[] +include::adoc/p_does.adoc[] include::adoc/p_dofasm.adoc[] include::adoc/p_doforth.adoc[] include::adoc/p_dostring.adoc[] +include::adoc/p_dot.adoc[] +include::adoc/p_double_quote.adoc[] include::adoc/p_dovalue.adoc[] include::adoc/p_dovariable.adoc[] -include::adoc/p_execute.adoc[] -include::adoc/p_exit.adoc[] -include::adoc/p_program_version.adoc[] -include::adoc/p_quit.adoc[] -include::adoc/p_stdin.adoc[] -include::adoc/p_system.adoc[] -include::adoc/p_terminate0.adoc[] -include::adoc/return_stack.adoc[] - -//include::stack.adoc[] -include::adoc/p_2drop.adoc[] -include::adoc/p_2dup.adoc[] -include::adoc/p_2over.adoc[] -include::adoc/p_2swap.adoc[] -include::adoc/p_depth.adoc[] include::adoc/p_drop.adoc[] include::adoc/p_dup.adoc[] -include::adoc/p_ltR.adoc[] -include::adoc/p_nip.adoc[] -include::adoc/p_over.adoc[] -include::adoc/p_pick.adoc[] -include::adoc/p_Rget.adoc[] -include::adoc/p_Rgt.adoc[] -include::adoc/p_roll.adoc[] -include::adoc/p_rot.adoc[] -include::adoc/p_swap.adoc[] -include::adoc/p_tuck.adoc[] - -//include::stdio.adoc[] -include::adoc/p_clear_stream.adoc[] -include::adoc/p_digits.adoc[] -include::adoc/p_dot.adoc[] -include::adoc/p_double_quote.adoc[] +include::adoc/p_else.adoc[] include::adoc/p_emit.adoc[] +include::adoc/p_end.adoc[] +include::adoc/p_equal.adoc[] +include::adoc/p_erase.adoc[] +include::adoc/p_evaluate_stream.adoc[] +include::adoc/p_execute.adoc[] +include::adoc/p_exit.adoc[] +include::adoc/p_false.adoc[] +include::adoc/p_find.adoc[] +include::adoc/p_forth.adoc[] +include::adoc/p_get.adoc[] +include::adoc/p_get_n_decrement.adoc[] +include::adoc/p_get_n_increment.adoc[] +include::adoc/p_greaterequal.adoc[] +include::adoc/p_greaterthan.adoc[] +include::adoc/p_gtR.adoc[] +include::adoc/p_here.adoc[] +include::adoc/p_hex.adoc[] +include::adoc/p_if.adoc[] +include::adoc/p_ifagain.adoc[] +include::adoc/p_ifbreak.adoc[] +include::adoc/p_immediate.adoc[] +include::adoc/p_left_bracket.adoc[] +include::adoc/p_lessequal.adoc[] +include::adoc/p_lessthan.adoc[] +include::adoc/p_literal.adoc[] +include::adoc/p_literal_string.adoc[] +include::adoc/p_lparen.adoc[] include::adoc/p_malloc.adoc[] +include::adoc/p_minus.adoc[] +include::adoc/p_mult.adoc[] +include::adoc/p_negate.adoc[] +include::adoc/p_nip.adoc[] include::adoc/p_nl.adoc[] +include::adoc/p_not.adoc[] +include::adoc/p_number.adoc[] +include::adoc/p_or.adoc[] +include::adoc/p_over.adoc[] include::adoc/p_pad.adoc[] +include::adoc/p_pick.adoc[] +include::adoc/p_plus.adoc[] +include::adoc/p_program_version.adoc[] +include::adoc/p_put.adoc[] +include::adoc/p_put_plus.adoc[] +include::adoc/p_quit.adoc[] +include::adoc/p_quote.adoc[] include::adoc/p_read_stream_char.adoc[] include::adoc/p_read_word.adoc[] +include::adoc/p_realloc.adoc[] +include::adoc/p_right_bracket.adoc[] +include::adoc/p_roll.adoc[] +include::adoc/p_rot.adoc[] +include::adoc/p_rsp.adoc[] +include::adoc/p_semicolon.adoc[] +include::adoc/p_shift_left.adoc[] +include::adoc/p_shift_right.adoc[] +include::adoc/p_shift_signed_right.adoc[] include::adoc/p_sp.adoc[] +include::adoc/p_state.adoc[] +include::adoc/p_stdin.adoc[] include::adoc/p_stream.adoc[] include::adoc/p_stream_nchars.adoc[] -include::adoc/p_tell.adoc[] - -//include::wordlists.adoc[] -include::adoc/p_current_wordlist.adoc[] -include::adoc/p_find.adoc[] -include::adoc/p_forth.adoc[] +include::adoc/p_strlen.adoc[] include::adoc/p_strncmp.adoc[] +include::adoc/p_strncpy.adoc[] +include::adoc/p_swap.adoc[] +include::adoc/p_system.adoc[] +include::adoc/p_tell.adoc[] +include::adoc/p_terminate0.adoc[] +include::adoc/p_tfa2cfa.adoc[] +include::adoc/p_tfa2dfa.adoc[] +include::adoc/p_tfa2flags_get.adoc[] +include::adoc/p_then.adoc[] +include::adoc/p_this_word.adoc[] +include::adoc/p_true.adoc[] +include::adoc/p_tuck.adoc[] +include::adoc/p_unequal.adoc[] +include::adoc/p_within.adoc[] include::adoc/p_words.adoc[] +include::adoc/p_xor.adoc[] +include::adoc/return_stack.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +include::separator.adoc[] +== System calls //include::syscalls.adoc[] + +RRQFORTH includes function wrapping for all "Linux syscalls", which +generally are described in their "man pages. This wrapping takes the +arguments fro the data stack in reverse order, i.e. the first argument +is deepest. + +Use +SYSTEM WORDS+ to get a list of all (321) available syscalls. + + +include::wordindex.adoc[]