use Julia-like syntax for documenting optional arguments, instead of square brackets (for #4902)