improved comments; and clarified freedom sample app; tweaked filenames