Bug 90030

Summary: colord lacks detailed documentation
Product: colord Reporter: Sebastián Puebla <seba.puebla.c>
Component: clientAssignee: Richard Hughes <richard>
Status: NEW --- QA Contact:
Severity: normal    
Priority: medium    
Version: unspecified   
Hardware: All   
OS: All   
Whiteboard:
i915 platform: i915 features:
Attachments: DocBook source for cd-iccdump(1) manual page

Description Sebastián Puebla 2015-04-14 18:46:40 UTC
The manual pages of colord does not document the client programs and daemon configuration file with detail enough to allow an administrator to use this software.

For example, the manual page for colormgr(1) describes its create-device command as follows:

create-device device-id scope
  Create a device

Another example is the man page for cd-create-profile(1): it does not even mention whether that program processes input files.

The manual pages for client programs should document with enough detail all *supported* command line arguments and options, the allowed values of certain options and command parameters, the format of input and output files (if a program actually reads or write files), possible exit status, and so on.  The daemon configuration file and any non-standard file formats created or consumed by client programs should be described in man section 5.
Comment 1 Sebastián Puebla 2015-05-12 22:44:30 UTC
Created attachment 115727 [details]
DocBook source for cd-iccdump(1) manual page

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.