landscape-sysinfo - lacks a man page or other documentation

Let's try to decouple client bugs from server bugs.

More than two years, and nine status changes, have gone by... but still no manpage?

Is writing a man page really much more work than pushing the status of the bug out every single release? :)

Is there documentation for landscape-sysinfo in some other format, and if so, where can it be found?

The only other documentation about the sysinfo tool is its help page:

$ landscape-sysinfo -h
Usage: landscape-sysinfo [options]

Options:
  --version show program's version number and exit
  -h, --help show this help message and exit
  -c FILE, --config=FILE
                        Use config from this file (any command line options
                        override settings from the file) (default:
                        '/etc/landscape/client.conf').
  -d PATH, --data-path=PATH
                        The directory to store data files in (default:
                        '/var/lib/landscape/client/').
  -q, --quiet Do not log to the standard output.
  -l FILE, --log-dir=FILE
                        The directory to write log files to (default:
                        '/var/log/landscape').
  --log-level=LOG_LEVEL
                        One of debug, info, warning, error or critical.
  --ignore-sigint Ignore interrupt signals.
  --ignore-sigusr1 Ignore SIGUSR1 signal to rotate logs.
  --sysinfo-plugins=PLUGIN_LIST
                        Comma-delimited list of sysinfo plugins to use.
                        Default is to use all plugins.
  --exclude-sysinfo-plugins=PLUGIN_LIST
                        Comma-delimited list of sysinfo plugins to NOT use.
                        This always take precedence over plugins to include.

Default plugins: Load, Disk, Memory, Temperature, Processes, LoggedInUsers,
LandscapeLink, Network

Many of those options are not really useful for an end user. The most important ones are about the plugins I suppose, specially because some people prefer to disable the LandscapeLink one.

OK, let's see if we can get things rolling a little here.

Please find attached a very basic landscale-sysinfo.1 man page.

It would be a lot more useful if it included a section on configuration which described the config file format and includes an example, but right now I lack the time and inclination to learn enough about the config file to confidently write that section. Perhaps someone else can add that?

Even as is, it's probably better than nothing.

Jonathan

Thanks, I'll take a look.

Since I'm already doing a pass on the client I'll take the opportunity to fix this.
I'll take the man page from Andreas's branch and make it a txt file (so that we can regenerate it with the same mechanism than other man pages).