Redmine#1180: add documentation for the findfiles() function

Documentation for the function implemented in https://github.com/cfengine/core/pull/827