skeletons: start some technical documentation

* data/README: Convert to Markdown.
Start documenting some of the macros used in all our skeletons.
Simplify and fix the documentation of the macros in the skeletons.
This commit is contained in:
Akim Demaille
2018-12-04 06:53:36 +01:00
parent f539a56620
commit 999277ddd8
9 changed files with 125 additions and 106 deletions

View File

@@ -375,18 +375,7 @@ m4_define([b4_token_enums_defines],
# b4_symbol_value(VAL, [SYMBOL-NUM], [TYPE-TAG])
# ----------------------------------------------
# Expansion of $$, $1, $<TYPE-TAG>3, etc.
#
# The semantic value from a given VAL.
#
# VAL: some semantic value storage (typically a union).
# e.g., yylval
# SYMBOL-NUM: the symbol number from which we extract the
# type tag.
# TYPE-TAG, the user forced the <TYPE-TAG>.
#
# The result can be used safely, it is put in parens to avoid nasty
# precedence issues.
# See README.
m4_define([b4_symbol_value],
[m4_ifval([$3],
[($1.$3)],