[mythtv-commits] Ticket #3798: Install user documentation during normal installation

[MythTV]

#3798: Install user documentation during normal installation
--------------------------------------+-------------------------------------
 Reporter:  Roo <roo.watt at gmail.com>  |        Owner:  ijr 
     Type:  enhancement               |       Status:  new 
 Priority:  minor                     |    Milestone:  0.21
Component:  mythtv                    |      Version:  head
 Severity:  medium                    |   Resolution:      
  Mlocked:  0                         |  
--------------------------------------+-------------------------------------

Comment(by Roo <roo.watt at gmail.com>):

 I have reworked the patch, because as mentioned in a previous comment the
 Makefile version did not play well with qmake.

 Most of the commentry in the description is still accurate, except there
 aren't the number of additional targets.

 The configure options --dis/enable-dev-docbuild and --des/enable-user-
 docbuild are used. If --user-docbuild option is not specified the user
 docs will just be installed and not rebuilt from the .sgml.

 If --dis/enable-dev-docbuild option is used then the dev-docs will be
 built and install when myth is built and installed. If it is not specified
 the user can still "make dev-docs" to build the doxygen documentation
 without the need to reconfigure mythtv.

 Due to the limitations of svn diff the following steps are also needed:
  * svn add docs/docs.pro
  * svn propedit svn:ignore docs - add "Makefile", "dummy", "dummy.o",
 "validate"
  * svn cp themes/dummy.c docs
  * svn rm docs/Makefile
  * svn rm docs/mythtv-HOWTO.html

 This patch also uses "tee" for logging the validate output to file as well
 a displaying it. I believe tee should be part of most distros.

 The docs install dir does not contain any version info, this is consistent
 with the other install dirs and there shouldn't be multiple installed
 versions of myth anyway (I believe).

 Roo.

-- 
Ticket URL: <http://svn.mythtv.org/trac/ticket/3798#comment:2>
MythTV <http://svn.mythtv.org/trac>
MythTV