database: Add comment on os.MkdirAll behavior.
database: Add comment on os.MkdirAll behavior.

This adds a comment describing behavior seen in practice for os.MkdirAll
on certain less supported OSes.

decred/dcrd,decred/dcrd