Usability of 'samba-tool domain provision'

[Alexander Bokovoy]

On Wed, 04 May 2016, Peter C. Kelly wrote:
> Andreas said:
> 
> >This documents issues I
> >found during provisioning. samba-tool is far away from being user friendly.
> 
> > a) It isn't clear what domain is from 'samba-tool domain provison --help'
> 
> I have raised bug 11894, and attached a patch which addresses this
> point as per Rowland's suggested wording.
> 
> > b) The --realm option is essential but at the end of the help ...
> 
> The reason that the realm is way down the bottom is that it is under a
> heading "Samba Common Options", along with configFile debuglevel and
> option.
> 
> What is currently holding me up from developing the second trivial
> patch is a need for a bit more clarity on how this --help output
> should look.  It seems to me that if the --domain parameter is
> compulsory, then the heading text should say so,
> and that if a realm has to be specified (or read in from an existing
> conf file) then perhaps that should be mentioned in the introductory
> text as well.
It would, perhaps, be good to have it in both categories to avoid
changing common options' help.

-- 
/ Alexander Bokovoy