This ended up with more changes than I thought, but the main objectives are to:

• Use lispy expressions in lambda-list doc (which should be more natural).
  For example, transform (arg1 [arg2]) into (arg1 &optional arg2)

• Lint newlines and bracket positions in functions descriptions to the following form

\funcdesc{name}{args}{
description.}

• Unify some points that were different between english and japanese documentation (such as variables names, order of appearance, etc)