update generic ls output and docs