document command intended for one-liner to be implemented on