stockpiles: write some documentation
stockpiles: format with ANSI style and  4 spaces
stockpiles: add optional debug output