Improve function help by grouping by function type

[mlell]

As someone new to beancount, I found the function documentation really hard to navigate. The old help functions dumped everything on screen at once, which was overwhelming. While developing a BQL query, I found myself looking for functions to transform certain argument types, however I just had an alphabetical function list. (Re-open of #262)

What I changed:

Progressive disclosure:

• help functions now shows just a category overview (takes ~10 lines instead of 100+) and explains custom object types
• help functions amount shows only amount-related functions, same for date, position, atomic,...

Better function docs:

• Added argument explanations to some functions (the old docs assumed you knew what arguments meant)
• Example: grep(pattern, string) now explains "pattern" is a regex and "string" is input text
• Examples on some types, e.g. Position is something like 10 HOOL {100.30 USD}

Technical implementation:

• Query functions are grouped according to their first argument's type by _describe_function().
• In addition, the decorators @function, @register and @aggregator take a group= argument to refine (e.g. for account names, which are strings)

The main benefit is you can find functions now much easier without scrolling through pages of text. When I started with beancount, I had no idea what functions were available or how to use them - I hope this makes it easier.

[dnicolodi]

Thanks for looking into improving the help system. I only went very quickly through the changes, but I feel that most of what you add some come in the form of documentation rather than in form of verbose help commands. Quite a few functions are deprecated and should be hidden from the help completely (or by default, or at least clearly marked as deprecated).

[mlell]

I am not sure I understand your point, did you mean: "I feel that most of what you add should come in the form of documentation..."? I would be happy to help with the documentation, however, at least in the beancount docs the help commands were mentioned as the location for function documentation, so I have amended those commands. Can you point me to where to add such information?

[mlell]

@dnicolodi Hi, I was just wondering if there is anything I could do to move this forward. I find this tool very useful and would lovehto help improve it!