more and better documentation and some reorganisation

[rrq/rrqforth.git] / adoc / p_hex.adoc

diff --git a/adoc/p_hex.adoc b/adoc/p_hex.adoc
index 4ea5b7b3de9bd0f0b0fb55e50128683883034cc1..35ef0ff4130a6fccf13ecbfe1096d526933f2e63 100644 (file)
--- a/adoc/p_hex.adoc
+++ b/adoc/p_hex.adoc
@@ -1,7 +1,21 @@
-Word: HEX
-----------
+// compile.asm:        WORD p_hex,'HEX',fasm
+
 anchor:p_hex[]
+
+=== Word: HEX
+
+....
+Data stack: ( -- )
+....
+
+"HEX" is a function word that sets <<p_base,BASE>> to 16, which uses
+letters a-f as additional digits. (Uppercase letter are also accepted
+on input).
+
+====
+.Word: HEX
+[caption='Definition concept {counter:exec}: ']
 ----
-compile.asm:   WORD p_hex,'HEX',fasm
+: HEX 16 BASE ! ;
 ----
-
+====