docs: some clarifications
docs: added help for ``--entries``