[ANNOUNCEMENT] doxygen 1.9.2-1 (TEST)

[ANNOUNCEMENT] doxygen 1.9.2-1 (TEST)

[Ken Brown via Cygwin-announce]

The following packages have been uploaded to the Cygwin distribution as test 
releases:

* doxygen-1.9.2-1
* doxygen-doxywizard-1.9.2-1

Doxygen is a documentation system for C++, C, Java, Objective-C, IDL (Corba and 
Microsoft flavours) and to some extent PHP, C#, and D.

This is an update to the latest upstream release.  See

   https://www.doxygen.org/manual/changelog.html

for a list of changes since the previous release.

Ken Brown
Cygwin's Doxygen maintainer

Re: [ANNOUNCEMENT] doxygen 1.9.2-1 (TEST)

[Ken Brown]

On 8/22/2021 2:39 PM, Ken Brown via Cygwin-announce via Cygwin wrote:
> The following packages have been uploaded to the Cygwin distribution as test 
> releases:
> 
> * doxygen-1.9.2-1
> * doxygen-doxywizard-1.9.2-1

These have now been promoted from test to current.

Ken

Re: [ANNOUNCEMENT] doxygen 1.9.2-1 (TEST)

[Brian Inglis]

On 2021-09-15 11:55, Ken Brown wrote:
> On 8/22/2021 2:39 PM, Ken Brown wrote:
>> The following packages have been uploaded to the Cygwin distribution 
>> as test releases:
>> * doxygen-1.9.2-1
>> * doxygen-doxywizard-1.9.2-1

> These have now been promoted from test to current.

Hi Ken,

Package doxygen is missing a runtime dependency requirement on epstopdf 
in texlive-collection-fontutils since 1.8.9 (2014-12-25)!

I found this out while dealing with bison and gnulib upstreams about 
bison test crashes due to gnulib updates, as those bison tests of 
doxygen documentation were the only tests still failing.

The runtime dependency requirement of doxygen on epstopdf (and others) 
is indirectly referred to in its Installation documentation of LaTeX, 
texlive, and document converters/generators as prerequisites, and 
mentioned in the doxygen ChangeLog, but not in other docs.

$ fgrep -R epstopdf /usr/share/doc/doxygen/
/usr/share/doc/doxygen/html/changelog.html:<li>Bug <a 
href="https://github.com/doxygen/doxygen/issues/5559">5559</a> - 
plantUML requires epstopdf for building PDF files [<a 
href="https://github.com/doxygen/doxygen/commit/52d216a87451c867c92

I have commented on the above issue, and requested the runtime 
dependency requirement be documented, considered during configuration, 
and checked during testing.

Feel free to add your input and/or correct mine.

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

This email may be disturbing to some readers as it contains
too much technical detail. Reader discretion is advised.
[Data in binary units and prefixes, physical quantities in SI.]

Re: [ANNOUNCEMENT] doxygen 1.9.2-1 (TEST)

[Ken Brown]

On 9/24/2021 2:17 AM, Brian Inglis wrote:
> On 2021-09-15 11:55, Ken Brown wrote:
>> On 8/22/2021 2:39 PM, Ken Brown wrote:
>>> The following packages have been uploaded to the Cygwin distribution as test 
>>> releases:
>>> * doxygen-1.9.2-1
>>> * doxygen-doxywizard-1.9.2-1
> 
>> These have now been promoted from test to current.
> 
> Hi Ken,
> 
> Package doxygen is missing a runtime dependency requirement on epstopdf in 
> texlive-collection-fontutils since 1.8.9 (2014-12-25)!

Thanks for the report, Brian.  I've decided to fix this a different way, 
following Fedora.  Instead of adding dependencies to doxygen, I'm adding a new 
empty package doxygen-latex, which brings in all the dependencies that doxygen 
needs for producing LaTeX/pdf output.  It turns out that there are several of 
them, not just texlive-collection-fontutils.

Ken

Re: [ANNOUNCEMENT] doxygen 1.9.2-1 (TEST)

[Brian Inglis]

On 2021-09-24 10:07, Ken Brown via Cygwin wrote:
> On 9/24/2021 2:17 AM, Brian Inglis wrote:
>> On 2021-09-15 11:55, Ken Brown wrote:
>>> On 8/22/2021 2:39 PM, Ken Brown wrote:
>>>> The following packages have been uploaded to the Cygwin distribution 
>>>> as test releases:
>>>> * doxygen-1.9.2-1
>>>> * doxygen-doxywizard-1.9.2-1
>>
>>> These have now been promoted from test to current.
>>
>> Hi Ken,
>>
>> Package doxygen is missing a runtime dependency requirement on 
>> epstopdf in texlive-collection-fontutils since 1.8.9 (2014-12-25)!
> 
> Thanks for the report, Brian.  I've decided to fix this a different way, 
> following Fedora.  Instead of adding dependencies to doxygen, I'm adding 
> a new empty package doxygen-latex, which brings in all the dependencies 
> that doxygen needs for producing LaTeX/pdf output.  It turns out that 
> there are several of them, not just texlive-collection-fontutils.

That's exactly the same approach as Debian;
I couldn't find anything like that under Fedora RPMs:
doxygen.spec just lists a bunch of Requires: tex(latex) type entries.
Is there some other source of truth about Fedora packages than 
https://src.fedoraproject.org/projects/rpms/ or some other way of 
interpreting tex() requirements?

You could now define doxygen-latex as CATEGORY=virtual to avoid calm 
warnings, which sometimes are public and annoying to all uploaders.

You could also go the other way, as OpenSuSE appears to have --disable-d 
and dropped both latex dependencies and building doxygen-doc:
"Kill doxygen-doc subpackages the latex deps keep growing while it is 
really easy to download the generated pdfs from upstream".
[I can't really blame them, as an ~30MB package should not need to drag 
in ~0.5GB of other stuff to produce output.
I feel sorry for those, such as students working from home or 
apts/flats, on non-broadband, limited, or metered networks.]

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

This email may be disturbing to some readers as it contains
too much technical detail. Reader discretion is advised.
[Data in binary units and prefixes, physical quantities in SI.]

Re: [ANNOUNCEMENT] doxygen 1.9.2-1 (TEST)

[Ken Brown]

On 9/24/2021 5:14 PM, Brian Inglis wrote:
> On 2021-09-24 10:07, Ken Brown via Cygwin wrote:
>> Thanks for the report, Brian.  I've decided to fix this a different way, 
>> following Fedora.  Instead of adding dependencies to doxygen, I'm adding a new 
>> empty package doxygen-latex, which brings in all the dependencies that doxygen 
>> needs for producing LaTeX/pdf output.  It turns out that there are several of 
>> them, not just texlive-collection-fontutils.
> 
> That's exactly the same approach as Debian;
> I couldn't find anything like that under Fedora RPMs:
> doxygen.spec just lists a bunch of Requires: tex(latex) type entries.

Right, and I translated those into texlive-collection-* requirements.  But 
doxygen.spec also contains

   %files latex
   # intentionally left blank

which I took to mean that it's an empty (or virtual) package.

Ken