google / vimdoc

Helpfile generation for vim
Apache License 2.0
291 stars 29 forks source link

Unstable ordering for automatic flags etc. across files #75

Closed dbarnett closed 10 years ago

dbarnett commented 10 years ago

Vimdoc iterates over files in arbitrary os.walk / os.listdir order to process them for doc blocks. For most things, we've already forced a stable order, but now we're seeing the automatic flags from maktaba#plugin#Enter calls have an unstable order since they're listed in the order we processed the corresponding file.

The same issue probably affects function references (#26) since a function may or may not have been seen yet depending on the order the files were processed in.

We should iterate in a stable order, either alphabetical or some custom ordering designed around vim plugin directory structure.