Foo namespace
          #include <File.h>
        
        A namespace.
Functions
- 
              template<class T>auto foo(int a, std::string b, char(&things)[5], bool, char(&)[42], int stuff[], double[1337]) -> int
- Function with everything
- void bar(int in, int& out, void* shit) constexpr noexcept
- Input and output.
- auto justReturn() -> int
- Function.
- auto justReturnValues() -> int
- Function.
- auto justExceptions() -> int
- Function.
- 
              template<class A, class B>auto bar(int a, int b) -> int
- A function with scattered docs.
- void thisIsAShittyWayToPassAVectorButWhatever(float x, float y, float z)
- Function with one description for all params.
Function documentation
              
                template<class T>
              
              int Foo::
            Function with everything
| Template parameters | |
|---|---|
| T | A template, innit | 
| Parameters | |
| a | That's a for you | 
| b | Well, a string | 
| things | And an array! | 
| stuff | Another array | 
| Returns | It returns! | 
| 0 | Zero? | 
| 42 | The Answer. | 
Ooooh, more text!
              void Foo::
            Input and output.
| Parameters | |
|---|---|
| in in | Input | 
| out out | Output | 
| shit in/out | Well, that's messy | 
              int Foo::
            Function.
| Returns | With just return value docs should still have detailed section | 
|---|
              int Foo::
            Function.
| Returns | |
|---|---|
| 42 | With just return value docs should still have detailed section | 
              int Foo::
            Function.
| Exceptions | |
|---|---|
| std::bad_exception | With just exception docs should still have detailed section | 
              
                template<class A, class B>
              
              int Foo::
            A function with scattered docs.
| Template parameters | |
|---|---|
| A | First template parameter docs | 
| B | Second template parameter docs | 
| Parameters | |
| a | First parameter docs | 
| b | Second parameter docs | 
| Returns | |
| 0 | Zero | 
| 1337 | 1337 h4xx0r?! | 
| 42 | The answer. To everything | 
| Exceptions | |
| std::bad_function_call | if you call the function bad | 
| std::future_error | if you are from the future | 
This is a function that has the docs all scattered around. They should get merged and reordered.
That goes also for the return values.
Yes?
- We also need to
- extract them out of a list
              void Foo::
            Function with one description for all params.
| Parameters | |
|---|---|
| x | Coordinates in 3D space | 
| y | Coordinates in 3D space | 
| z | Coordinates in 3D space |