We're currently maintaining hand-crafted ltsp-* man pages. This is an additional overhead and sometimes the LTSP man pages don't even match the ltsp-tool --help listed options.
help2man (http://www.gnu.org/software/help2man/) can be used to generate them automatically by internally running ltsp-tool --help. It even supports multiple locales, so when we internationalize the tools, we'll automatically get manpages for them as well.
And it can help with ltsp-build-client --extra-help, if we merge that with --help. So at package build time all distro-supported ltsp-build-client options will be listed in its man page (LP: #479423).
We'll need to provide a --version to all of our scripts (using ltsp-common-functions), and maybe an include file for help2man.
Support for autogenerating man pages for all server ltsp tools except ltsp-build-client is ready.
Because the --help of ltsp-build-client sources various scripts, calling that from a build environment won't be possible without some other changes.
We could make ltsp-build-client look for local dirs for instance, or something else...