tree 2a4e073f823edf52ec381d637a9d25171816cd30
parent 90555c18942059e61125b32f572e41a8a8ebc02f
author Steve Francia <steve.francia@gmail.com> 1449498581 -0500
committer Steve Francia <steve.francia@gmail.com> 1449609999 -0500

reorder all utility functions to have fs as 1st param

This is a BREAKING CHANGE to the Walk and ReadDir functions that
existed prior to this branch addition. This change is not done without
considerable thought.

Having FS come first is done for two reasons.
1: It's more idiomatic go
2: It's more logical. It allows the function signature to read easier
and flow from the broadest value to the most narrow.

For example, WriteReader would read..
writeReader on this fs, to this path (on that fs),
with this data (at that path, on that fs).

I believe that when the first two were implemented it wasn't at all
obvious that the order wasn't correct, nevertheless, permitting a
lot of new functions defined in an incorrect or inconsistent order
seems like the worst option.

It was decided that a breaking change today would be best, even if it
was mildly painful at the present.