empire/empserver
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Fix grammar for human-readable header.

Browse source 
Clarify state of symbolic indexes.
This commit is contained in:
Markus Armbruster 2007-08-24 17:03:44 +00:00
parent 71485ac5a0
commit 1d330548ea
1 changed files with 7 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

17
doc/xdump
View file

@ -91,7 +91,7 @@ Requirements:
* Output is self-contained; symbol encoding is explicit. * Output is self-contained; symbol encoding is explicit.
* KISS: keep it simple, keep it stupid. * KISS: Keep it simple, stupid.
Non-requirements: Non-requirements:
@ -524,8 +524,8 @@ EBNF changes:
* Header and footer: * Header and footer:
header = "config" name newline { colhdr } newline ; header = "config" name newline colhdr newline ;
colhdr = identifier [ "(" ( intnum | identifier ) ")" ] [ "..." ] ; colhdr = { identifier [ "(" ( intnum | identifier ) ")" ] } [ "..." ] ;
footer = "/config" newline ; footer = "/config" newline ;
If colhdr ends with "...", the table is continued in another part, If colhdr ends with "...", the table is continued in another part,
@ -597,15 +597,8 @@ EBNF changes:
The resulting sub-language for records is a superset of The resulting sub-language for records is a superset of
machine-readable sub-language for records. machine-readable sub-language for records.
See src/lib/global/*.config for examples. See src/lib/global/*.config for examples.
Human-readable xdump still has its shortcomings:
* item selector pkg is an array indexed by values in symbol table
packing. The column header should support symbolic index values
rather than numbers.
Notes on Table Configuration Implementation Notes on Table Configuration Implementation
@ -624,6 +617,10 @@ human-readable and machine-readable input. The parser is not precise;
it accepts human-readable syntax even within tables whose header marks it accepts human-readable syntax even within tables whose header marks
them machine-readable. them machine-readable.
Symbolic index values in column headers are not implemented. They
occur in item selector pkg, which is an array indexed by values in
symbol table packing.
Configuration tables contain values that are not meant to be Configuration tables contain values that are not meant to be
customized. For instance, meta-data and symbol tables reflect the customized. For instance, meta-data and symbol tables reflect the
encoding of C language constructs in the server. Selector flag encoding of C language constructs in the server. Selector flag