Opened 13 years ago

Closed 12 years ago

Last modified 12 years ago

#14421 closed enhancement (fixed)

doxygen-1.5.7: consider no_tex (or lite?) variant

Reported by: cssdev Owned by: cssdev
Priority: Normal Milestone:
Component: ports Version: 1.6.0
Keywords: Cc: tsunanet@…, raimue (Rainer Müller)
Port: doxygen

Description

Consider a lightweight doxygen build process with a no_tex variant. Removing the tex dependency would reduce the feature set, but it would allow for a much faster build process for users who do not need such an extensive dependency list.

Or should this be extended to a lite variant? What about graphviz and all it pulls in? Which features, if withheld, would allow the port to retain broad usability?

Prompted by discussions on #14328.

Attachments (1)

Portfile-nopdf.diff (1.2 KB) - added by cssdev 12 years ago.
Make sure to reset the build.target and destroot.target to not include the docs

Download all attachments as: .zip

Change History (12)

comment:1 Changed 13 years ago by cssdev

Status: newassigned

The ability to generate TeX documentation is a feature of doxygen ... it's used beyond just the manual.

MacPorts has a general policy to install everything by default, and the TeX dependencies are in place so that doxygen users can generate other forms of documentation. The idea is that the default install can do everything supported by the upstream package.

I don't like the idea of subtraction by variant, but that's something to accept given the policy as well as the problems handling default variants.

Although I have to admit I configured doxygen without TeX all the time before the ports system arrived. :)

comment:2 in reply to:  1 Changed 13 years ago by raimue (Rainer Müller)

Replying to css@macports.org:

The ability to generate TeX documentation is a feature of doxygen ... it's used beyond just the manual.

True. I forgot about this completely in my earlier comment. Although the doxygen project itself releases an .app package with dot, but without tex. And tex pulls in a lot of dependencies. I still vote for making tex optional.

comment:3 Changed 12 years ago by cssdev

There are existing variants for graphviz that can simplify its features, so once I figure out the best way to remove doxygen's documentation (and it currently looks like I'll need to manually patch its Makefile.in to remove the doc directory), it should be possible to conduct a streamlined build without the heavyweight dependencies.

comment:4 Changed 12 years ago by cssdev

Port: doxygen added

It seems like changing the build.target to all might be all that's needed to avoid building the documentation. If you pass on the PDF, then you can pass on installing texlive just to install doxygen.

comment:5 Changed 12 years ago by cssdev

Summary: doxygen-1.5.4: consider no_tex (or lite?) variantdoxygen-1.5.7: consider no_tex (or lite?) variant

The attached patch creates a docs variant that builds and installs the doxygen PDF. This variants adds dependencies on ghostscript and texlive... both of which are indeed somewhat heavyweight dependencies. Skipping the doc s allows a much faster doxygen build.

Changed 12 years ago by cssdev

Attachment: Portfile-nopdf.diff added

Make sure to reset the build.target and destroot.target to not include the docs

comment:6 Changed 12 years ago by cssdev

I went ahead and committed this to r40482, as it really does make doxygen a faster install.

comment:7 Changed 12 years ago by cssdev

r40525 fixes a typo in the docs variant.

comment:8 Changed 12 years ago by cssdev

r41077 fixes another typo...

comment:9 Changed 12 years ago by raimue (Rainer Müller)

Thanks for your changes. Can we consider this ticket as closed now?

comment:10 Changed 12 years ago by cssdev

Resolution: fixed
Status: assignedclosed

There are still a few minor bumps (such as #16938), but in general I think we could consider this closed now.

comment:11 Changed 12 years ago by (none)

Milestone: Port Enhancements

Milestone Port Enhancements deleted

Note: See TracTickets for help on using tickets.