documentation style tweaks (#10790)

* exports are the least important field in the docs:
  they are put in the last place (at the bottom)
* indent text after proc/type declaration for an easier navigation
  (noticeable difference between declarations and examples)
* quickfix invalid style in `asynchttpserver`
This commit is contained in:
Miran 2019-03-08 13:55:27 +01:00 • committed by Andreas Rumpf
commit bba3a20e7c
6 changed files with 20 additions and 20 deletions

View file

@ -20,7 +20,7 @@ import
pathutils
const
exportSection = skTemp
exportSection = skField
type
TSections = array[TSymKind, Rope]
@ -893,9 +893,9 @@ proc generateTags*(d: PDoc, n: PNode, r: var Rope) =
else: discard
proc genSection(d: PDoc, kind: TSymKind) =
const sectionNames: array[skTemp..skTemplate, string] = [
"Exports", "Imports", "Types", "Vars", "Lets", "Consts", "Vars", "Procs", "Funcs",
"Methods", "Iterators", "Converters", "Macros", "Templates"
const sectionNames: array[skModule..skField, string] = [
"Imports", "Types", "Vars", "Lets", "Consts", "Vars", "Procs", "Funcs",
"Methods", "Iterators", "Converters", "Macros", "Templates", "Exports"
]
if d.section[kind] == nil: return
var title = sectionNames[kind].rope