On Thu, Feb 02, 2017 at 12:30:16PM +0100, Michal Židek wrote:
> > > *
https://fedorahosted.org/sssd/ticket/3208 - Need
detailed information
> > > about config-check option
> > > - what is this ticket about? Do we need it? I suggest we just close
it
> > >
> > I think that issue is with mninimal manual page.
> > There is just following paragraph
> >
> > AVAILABLE COMMANDS
> > To list all available commands run sssctl without any parameters. To
> > print help for selected command run sssctl COMMAND --help.
> >
> > We might do the same as in dnf
> >
> > SYNOPSIS
> > sssctl [options] <command> [<args>...]
> >
> > Available commands:
> >
> > * domain-list
> > * domain-status
> >
> > and then describe Commands in details.
>
> Michal, do you have an opinon here? If this is something that can be
> fixed quickly (several hours max), then let's just get the ticket out of
> our radar.
The original idea was to keep the manual page minimal and move most
of the help in the --help output for each command. The reason was to
not have the same info on two places (man page and help). Now, we
do have the part with minimal man page finished :D , but the --help
does not contain enough help for most commands. I do not know how
much time will it take to write the missing documentation, from
what I see, each command is missing something like general description
in the --help output, so it does not seem to be that much work.
I can do it after I finish the SELinux bugs, it should not take much
time.
OK, if it requires more than a couple of hours, please use the ticket to
a later milestone.