Document sys.statedir special variable

Please hold until cfengine/core#1425 is deemed acceptable and merged.