Syntax descriptions
Use code font for literals (parts of the language, values, and so on), italics for placeholder names, and regular text for the brackets that enclose something that’s optional. Pay close attention to punctuation.
Read (
[file, ] var)
Use embedded caps to connect words that act as a single placeholder name (sourceFile).
Be consistent when naming placeholders; for example, don’t alternate between commands and commandList.