Change the layout of the doxygen-generated documentation

[akosthekiss]

• Move from index-based layout to treeview-based one.
• Automatically take the first sentence of the documentation as the
  brief doc.
• Always generate both brief and detailed description sections, and
  always sort them alpabetically.
• Disable the generation of huge and overly complex call and caller
  graphs.
• Make the project title title-cased.

JerryScript-DCO-1.0-Signed-off-by: Akos Kiss [email protected]

[akosthekiss]

I admit that it is a very subjective matter what looks good. So, please take these as my personal preferences. Happy to drop this PR if others don't like this look.

[LaszloLango]

I think the improvement of the content is more important than the improvement of the style. :)

[akosthekiss]

I agree, at least partially. My problem was that I couldn't grasp the content because of the style.

But then, what now with this PR? Update & merge, close/drop, or just let it linger here for a while more?

[LaszloLango]

@akiss77, how can I check the difference between this PR and the current style? How can I generate the doxygen documentation?

[akosthekiss]

Type doxygen in the root directory of the project and check the results indocs/doxygen/html.

[LaszloLango]

I'm Ok with the changes. You can land if you'd like to do. Just a "feature request". Is it possible to align the right parenthesis to the end of the last argumet?
Current style in doxygen

uint64_t __attr_const___ jrt_extract_bit_field  (uint64_t   container,
                                                 size_t     lsb,
                                                 size_t     width)
                                                 )

What I'd like to see:

uint64_t __attr_const___ jrt_extract_bit_field  (uint64_t   container,
                                                 size_t     lsb,
                                                 size_t     width)

[akosthekiss]

@LaszloLango I've digged in the sources of doxygen and found it hard-coded in the htmlgen where that closing ) is written. It only goes to the same line if the function has 0 or 1 arg.

[LaszloLango]

@akiss77, thanks for checking it.

[galpeter]

LGTM :)

[zherczeg]

LGTM