Add some pillar documentation

Added some extended info about what the logbasedir option does and added a note
about being careful mixing target and listen together.