[PATCH 0/2] secilc/docs: add syntax highlighting for cil examples

[bauen1 <j2468h@googlemail.com>]

Hi,

To make editing the secilc docs easier, I've modified it to use fenced code blocks around all cil examples.
This way editor syntax highlighting can do a better job and as a result I've found 3 minor bracket issues that are also fixed in patch 1.

To allow pandoc to also do syntax highlighting I've written a rudimentary syntax definition in the format consumed by pandoc (https://docs.kde.org/trunk5/en/applications/katepart/highlight.html#katehighlight-xml-format) and enabled it.
However pandocs default themes aren't the best, some of them don't highlight every keyword I've added, color scheme doesn't fit, etc ...
On the other side It's very hard to just find 6 colors that work well together.

I've uploaded an example using the default pandoc theme:
https://glados.bauen1.xyz/misc_stuff_might_disappear/CIL_Reference_Guide.html
https://glados.bauen1.xyz/misc_stuff_might_disappear/CIL_Reference_Guide.pdf

bauen1 (2):
  secilc/docs: use fenced code blocks for cil examples
  secilc/docs: add syntax highlighting for secil

 secilc/docs/Makefile                          |  12 +-
 secilc/docs/cil_access_vector_rules.md        |  33 ++-
 secilc/docs/cil_call_macro_statements.md      |  10 +
 .../cil_class_and_permission_statements.md    |  42 ++++
 secilc/docs/cil_conditional_statements.md     |  16 +-
 secilc/docs/cil_constraint_statements.md      |  16 ++
 secilc/docs/cil_container_statements.md       |  16 ++
 secilc/docs/cil_context_statement.md          |  10 +
 secilc/docs/cil_file_labeling_statements.md   |  14 ++
 secilc/docs/cil_infiniband_statements.md      |   9 +-
 secilc/docs/cil_mls_labeling_statements.md    |  50 +++-
 .../docs/cil_network_labeling_statements.md   |  16 ++
 secilc/docs/cil_policy_config_statements.md   |  12 +
 secilc/docs/cil_reference_guide.md            |  27 +++
 secilc/docs/cil_role_statements.md            |  26 ++
 secilc/docs/cil_sid_statements.md             |  12 +
 secilc/docs/cil_type_statements.md            |  50 ++++
 secilc/docs/cil_user_statements.md            |  42 +++-
 secilc/docs/cil_xen_statements.md             |  20 ++
 secilc/docs/secil.xml                         | 224 ++++++++++++++++++
 20 files changed, 644 insertions(+), 13 deletions(-)
 create mode 100644 secilc/docs/secil.xml

--
2.30.0