§4.6: Amend Arrays Syntax Definition

[tajmone]

• Get @tessman approval for these changes.
• Fix document source.

Since it's a minor amend, there's no need to:

• Annotate it in the source file.
• Document the changes in CHANGES.md.
• Document in ChangeLog.

---

In his annotated PDF, @roodyyogurt suggests that in §4.6. Arrays and Strings the space between <arrayname> and [<array size>] should be removed from the syntax definition:

array <arrayname> [<array size>]

This makes sense, for arrays are written in the form array test_array[10], as can be seen in the example immediately following the syntax definition.

[tessman]

That probably makes sense, yeah. It avoids making it look like some sort of additional/optional parameter, especially when you can compare it to an example.

[tajmone]

It avoids making it look like some sort of additional/optional parameter

In the upcoming release I'm planning to improve the Hugo syntax mock-ups styles by manually assigning different styles/colors to the various token indicating optionality ([]), alternatives (|) and omissions (...).

I had already planned these style improvements, which is the reason why the upcoming release bumps up the MINOR version (1.0.0 → 1.1.0), and not just the PATCH segment — because the added styles would require end user to update their custom templates to fully exploit the book, although is doesn't break backward compatibility.

See Issue #70 regarding this.