github.com/joeshaw/doc-extract (go): Source files are processed in lexicographic order, except that a file named doc.go is always processed first.  Comments within a file are extracted in the order they appear.  This predictable order allows you to add, for instance, a header to the output file by adding it to doc.go.
Keywords: api-blueprint|comments|extract|go|golang|sphinx