[MacPorts] #47901: cmake @3.2.2_0+docs+gui: build documentation in Qt help/Assistant format

MacPorts noreply at macports.org
Sun May 31 01:13:33 PDT 2015


#47901: cmake @3.2.2_0+docs+gui: build documentation in Qt help/Assistant format
--------------------------+-------------------------
  Reporter:  rjvbertin@…  |      Owner:  michaelld@…
      Type:  enhancement  |     Status:  new
  Priority:  Normal       |  Milestone:
 Component:  ports        |    Version:
Resolution:               |   Keywords:  haspatch
      Port:  cmake        |
--------------------------+-------------------------

Comment (by rjvbertin@…):

 Replying to [comment:1 larryv@…]:

 > … should produce more documentation than this…

 No, I didn't add anything to the +docs description, but there is not
 "more" documentation that is built. The same documentation is simply
 compiled in an additional format, which isn't the same thing. It could use
 that description, but lacking that I don't see why anyone would be
 confused. Except by the fact that getting the Qt help requires a specific
 python variant, but that could also go in the variant description.

 > A more obvious approach would be to add a variant for the Qt help that
 required `+gui +docs +python34`. Another possibility would be to ditch the
 Python variants and have `+docs` use Python 3.4 Sphinx and build the Qt
 help unconditionally.

 I personally find that the port already has enough variants and variants
 of variants, and I think Michael's intention with that is to allow choice
 instead of enforcing choice on users (Qt4 or Qt5, python2.7 or python3.4).
 The only possible interest of a specific Qt help variant that I can see is
 to install that help format *instead* of the HTML version.

 Compiling the help in Qt format requires Qt, which is why I made it a
 side-effect of +gui+docs.

 Anyway, my expectation here was mostly to remind Michael of the
 possibility to provide the help in Qt format, he's capable enough to see
 how to implement it exactly.

-- 
Ticket URL: <https://trac.macports.org/ticket/47901#comment:2>
MacPorts <https://www.macports.org/>
Ports system for OS X


More information about the macports-tickets mailing list