#10283 LOW 10.1.3: cups does not show documentation on web browser (was: cups does not start)

[Zarro Boogs per Child]

#10283: cups does not show documentation on web browser
----------------------------------+-----------------------------------------
           Reporter:  eowens2     |       Owner:                                   
               Type:  defect      |      Status:  reopened                         
           Priority:  low         |   Milestone:  10.1.3                           
          Component:  fedora      |     Version:  Development build as of this date
         Resolution:              |    Keywords:  os851                            
        Next_action:  qa signoff  |    Verified:  0                                
Deployment_affected:              |   Blockedby:                                   
           Blocking:              |  
----------------------------------+-----------------------------------------
Changes (by Quozl):

  * next_action:  diagnose => qa signoff


Comment:

 Cause further identified.

 Our operating system builder script olpc-os-builder.git/osbuilder.py emits
 a directive to kickstart/imgcreate:

 {{{
 %packages --excludedocs
 }}}

 As a result, the installed operating system build on an XO contains a file
 /etc/rpm/macros.imgcreate with a line:

 {{{
 %_excludedocs 1
 }}}

 As a result, the installation of the cups-1.4.2-26.fc11.i586.rpm avoids
 unpacking all files marked as documentation.  The missing file index.html
 is marked as documentation, and so it is excluded.  CUPS will run
 correctly without it, but without providing documentation to the user via
 web browser, hence the 404 error.

 In order to keep the operating system images small, we should continue to
 exclude documentation files, so we won't be fixing this.  I'll add it to
 the release notes as a known problem.

 An alternate workaround was tested.  Edit the file
 /etc/rpm/macros.imgcreate, comment out or remove the %_excludedocs macro,
 and then install cups.  As a result the index.html file is placed
 properly, and the web browser is able to see the documentation.

-- 
Ticket URL: <http://dev.laptop.org/ticket/10283#comment:6>
One Laptop Per Child <http://laptop.org/>
OLPC bug tracking system