[KDE/Mac] generating extra documentation (port:kdelibs4)

Brandon Allbery allbery.b at gmail.com
Thu May 7 17:29:57 UTC 2015


On Thu, May 7, 2015 at 1:18 PM, René J.V. <rjvbertin at gmail.com> wrote:

> I thought it'd be nice to have the kdelibs4 documentation in Qt help
> (.qch) format. It is available online, but seriously outdated and will of
> course not reflect any OS X specific changes that we made.
>
> There is a script in the doc/api directory that generates this
> documentation file, but it hogs the computer for over an hour. My initial
> thought had been to generate it unconditionally if the user selects the
> +docs variant, but not when there is so much overhead. What alternatives
> are there? I could create a subport, but that would still cause this
> documentation to be rebuilt each time an update is pushed and the user does
> an `upgrade outdated`, which seems overkill to me. If it were just me I'd
> let the generation depend on the presence of a specific env. variable, in
> the +docs variant; would that be acceptable?
>

+docsfull variant? Perhaps with some way in the Portfile to specify that an
update should rebuild it only if there is an installed version older than
some threshold (and maybe a +docsfullalways variant for those who want it
to always build for some reason)?

-- 
brandon s allbery kf8nh                               sine nomine associates
allbery.b at gmail.com                                  ballbery at sinenomine.net
unix, openafs, kerberos, infrastructure, xmonad        http://sinenomine.net
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kde-mac/attachments/20150507/8c3efcac/attachment.html>


More information about the kde-mac mailing list