proto method for short raw.file maintenance; replace filenames with fxxx if shortening fails; lots of ordering issues fixed; minor fixes
cleaned up doc; roxygen2 does not understand protogese :(