[meego-packaging] RFC: package docs for libraries

[Arjan van de Ven]

On 8/19/2010 6:58 AM, Michael Leibowitz wrote:
> On Thu, 2010-08-19 at 03:27 -0700, ext-bernd.wachter at nokia.com wrote:
>    
>> "ext Patrick Ohly"<patrick.ohly at intel.com>  writes:
>>
>>      
>>> A lot of the libraries currently entering MeeGo have little to no API
>>> documentation available online. MeeGo Touch Framework was the most
>>> prominent one until recently. Others (mkcal, kcalcore, accounts&sso)
>>> still have no documentation available as far as I know. Even if
>>> documentation is online, it does not necessarily match the library
>>> version currently in MeeGo.
>>>        
>> for most of the libraries I'm packaging I make sure that documentation
>> gets build and put into a separate -doc package.
>>      
> It would be extra slick if they also include generated .qch and worked
> magically with assistant if they are qt based libraries.
>    


autospectacle automatically detects documentation that gets installed, 
and if there's more than 5 files,
it splits off a separate -doc package.....
maybe this heuristic needs refining....