Preserve (or invert) order of vars within the file

[facundoolano]

I usually find that auto generated documentation loses information and reduces readability by displaying the functions and vars in alphabetical order rather than preserving the order in which they were arranged in the file. The file ordering usually follows relevance and grouping criteria that in most cases should apply to the documentation as well. I imagine that having options to preserve or invert that order (in case the files are better read bottom up) could add a lot of value to the generated documentation.