Add regression tests for newsyslog.conf's p flag.

While here do a bit of cleanup:

• declare local variables as such,
• make tmpdir_create() clean up logfile directories, to handle a previously interrupt test run more gracefully.

MFC after: 2 weeks
Sponsored by: The FreeBSD Foundation