xorg-libxcb +docs @1.13.1 does not build on High Sierra (macOS 10.13.6) because building documentation never finds an end

[ballapete (Peter "Pete" Dyballa)]

/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:536: warning: The following parameters of xcb\
_xvmc_create_context(xcb_connection_t *c, xcb_xvmc_context_t context_id, xcb_xv_port_t port_id, xcb_xvmc_surface_t surface_id, uint16_t width, uint16_t height, uint32_t flags) are not documented:
  parameter 'context_id'
  parameter 'port_id'
  parameter 'surface_id'
  parameter 'width'
  parameter 'height'
  parameter 'flags'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:556: warning: The following parameters of xcb\
_xvmc_create_context_unchecked(xcb_connection_t *c, xcb_xvmc_context_t context_id, xcb_xv_port_t port_id, xcb_xvmc_surface_t surface_id, uint16_t width, uint16_t height, uint32_t flags) are not documented:
  parameter 'context_id'
  parameter 'port_id'
  parameter 'surface_id'
  parameter 'width'
  parameter 'height'
  parameter 'flags'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:718: warning: The following parameters of xcb\
_xvmc_create_subpicture(xcb_connection_t *c, xcb_xvmc_subpicture_t subpicture_id, xcb_xvmc_context_t context, uint32_t xvimage_id, uint16_t width, uint16_t height) are not documented:
  parameter 'subpicture_id'
  parameter 'context'
  parameter 'xvimage_id'
  parameter 'width'
  parameter 'height'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:737: warning: The following parameters of xcb\
_xvmc_create_subpicture_unchecked(xcb_connection_t *c, xcb_xvmc_subpicture_t subpicture_id, xcb_xvmc_context_t context, uint32_t xvimage_id, uint16_t width, uint16_t height) are not documented:
  parameter 'subpicture_id'
  parameter 'context'
  parameter 'xvimage_id'
  parameter 'width'
  parameter 'height'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:631: warning: The following parameters of xcb\
_xvmc_create_surface(xcb_connection_t *c, xcb_xvmc_surface_t surface_id, xcb_xvmc_context_t context_id) are not documented:
  parameter 'surface_id'
  parameter 'context_id'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:647: warning: The following parameters of xcb\
_xvmc_create_surface_unchecked(xcb_connection_t *c, xcb_xvmc_surface_t surface_id, xcb_xvmc_context_t context_id) are not documented:
  parameter 'surface_id'
  parameter 'context_id'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:616: warning: The following parameters of xcb\
_xvmc_destroy_context(xcb_connection_t *c, xcb_xvmc_context_t context_id) are not documented:
  parameter 'context_id'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:604: warning: The following parameters of xcb\
_xvmc_destroy_context_checked(xcb_connection_t *c, xcb_xvmc_context_t context_id) are not documented:
  parameter 'context_id'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:796: warning: The following parameters of xcb\
_xvmc_destroy_subpicture(xcb_connection_t *c, xcb_xvmc_subpicture_t subpicture_id) are not documented:
  parameter 'subpicture_id'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:784: warning: The following parameters of xcb\
_xvmc_destroy_subpicture_checked(xcb_connection_t *c, xcb_xvmc_subpicture_t subpicture_id) are not documented:
  parameter 'subpicture_id'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:703: warning: The following parameters of xcb\
_xvmc_destroy_surface(xcb_connection_t *c, xcb_xvmc_surface_t surface_id) are not documented:
  parameter 'surface_id'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:691: warning: The following parameters of xcb\
_xvmc_destroy_surface_checked(xcb_connection_t *c, xcb_xvmc_surface_t surface_id) are not documented:
  parameter 'surface_id'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:811: warning: The following parameters of xcb\
_xvmc_list_subpicture_types(xcb_connection_t *c, xcb_xv_port_t port_id, xcb_xvmc_surface_t surface_id) are not documented:
  parameter 'port_id'
  parameter 'surface_id'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:827: warning: The following parameters of xcb\
_xvmc_list_subpicture_types_unchecked(xcb_connection_t *c, xcb_xv_port_t port_id, xcb_xvmc_surface_t surface_id) are not documented:
  parameter 'port_id'
  parameter 'surface_id'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:478: warning: The following parameters of xcb\
_xvmc_list_surface_types(xcb_connection_t *c, xcb_xv_port_t port_id) are not documented:
  parameter 'port_id'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/src/xvmc.h:493: warning: The following parameters of xcb\
_xvmc_list_surface_types_unchecked(xcb_connection_t *c, xcb_xv_port_t port_id) are not documented:
  parameter 'port_id'
make[1]: *** [manual] Error 1
make: *** [all-recursive] Interrupt: 2
Command failed:  cd "/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1" && /usr/bin/make -j8 -w all
Killed by signal: 2
Error: Aborted: SIGINT received.

Aborted after almost one hour. Actual cause could be here:

make[1]: Leaving directory `/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/tests'
Making all in doc
make[1]: Entering directory `/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.13.1/doc'
doxygen xcb.doxygen
warning: Tag `USE_WINDOWS_ENCODING' at line 64 of file `xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag `DETAILS_AT_TOP' at line 156 of file `xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag `SHOW_DIRECTORIES' at line 390 of file `xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag `HTML_ALIGN_MEMBERS' at line 675 of file `xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag `XML_SCHEMA' at line 907 of file `xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag `XML_DTD' at line 913 of file `xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag `MAX_DOT_GRAPH_WIDTH' at line 1197 of file `xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag `MAX_DOT_GRAPH_HEIGHT' at line 1205 of file `xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"

[ballapete (Peter "Pete" Dyballa)]

Main.log from High Sierra 10.13.6

[ballapete (Peter "Pete" Dyballa)]

Forgot one thing to mention: Trying to build with +python36.

[jmroot (Joshua Root)]

In 5996ff868b61a85ea6d63904ba66e4d198d91bca/macports-ports (master):

xorg-libxcb: update configure args

See: #58540

[jmroot (Joshua Root)]

I fixed the fact that it was building the docs without +docs, but I guess the same failure still happens with +docs +python36?

[ballapete (Peter "Pete" Dyballa)]

Replying to jmroot:

I fixed the fact that it was building the docs without +docs, but I guess the same failure still happens with +docs +python36?

Yes, it does so.

[ballapete (Peter "Pete" Dyballa)]

It builds alright when lines

 46 #    configure.args-append \
 47 #        --enable-devel-docs

in Portfile are commented.

[ballapete (Peter "Pete" Dyballa)]

Build succeeds as well when the configure option --without-doxygen is given. So the failure is related to doxygen's use.

[ballapete (Peter "Pete" Dyballa)]

I finally tried to build with Python 2.7 – the same error when it comes to building the docs, endlessly doing something silly. I am attaching the corresponding log file.

[ballapete (Peter "Pete" Dyballa)]

Main.log from High Sierra 10.13.6 with Python 2.7

[kencu (Ken)]

somewhere fixed, as it builds now:

​https://ports.macports.org/port/xorg-libxcb/details/

[jmroot (Joshua Root)]

But does it build with +docs? That's not a default variant.

[ballapete (Peter "Pete" Dyballa)]

I did not wait again an hour, but even with Python 3.10 and doxygen @1.9.3_3 it's stuck here, for ten minutes:

/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.15/src/xvmc.h:817: warning: The following parameters of xcb_xvmc_list_subpicture_types_unchecked(xcb_connection_t *c, xcb_xv_port_t port_id, xcb_xvmc_surface_t surface_id) are not documented:
  parameter 'port_id'
  parameter 'surface_id'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.15/src/xvmc.h:471: warning: The following parameter of xcb_xvmc_list_surface_types(xcb_connection_t *c, xcb_xv_port_t port_id) is not documented:
  parameter 'port_id'
/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.15/src/xvmc.h:483: warning: The following parameter of xcb_xvmc_list_surface_types_unchecked(xcb_connection_t *c, xcb_xv_port_t port_id) is not documented:
  parameter 'port_id'

Building the docs starts here:

Making all in doc
make[1]: Entering directory `/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.15/doc'
doxygen xcb.doxygen
warning: Tag 'USE_WINDOWS_ENCODING' at line 64 of file 'xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag 'DETAILS_AT_TOP' at line 156 of file 'xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag 'SHOW_DIRECTORIES' at line 390 of file 'xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag 'COLS_IN_ALPHA_INDEX' at line 620 of file 'xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag 'HTML_ALIGN_MEMBERS' at line 675 of file 'xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag 'XML_SCHEMA' at line 907 of file 'xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag 'XML_DTD' at line 913 of file 'xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag 'PERL_PATH' at line 1074 of file 'xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag 'CLASS_DIAGRAMS' at line 1087 of file 'xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag 'MAX_DOT_GRAPH_WIDTH' at line 1197 of file 'xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: Tag 'MAX_DOT_GRAPH_HEIGHT' at line 1205 of file 'xcb.doxygen' has become obsolete.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u"
warning: argument 'a4wide' for option PAPER_TYPE is not a valid enum value
Using the default: a4!

But, when I sent an interrupt to port a form popped up telling me that dot had crashed, /opt/local/bin/dot (from graphviz-devel @7.0.3). Could be it's worth to upgrade to version 1.9.5 (release date 26 August 2022)? Or test with graphviz @7.0.1?

[ballapete (Peter "Pete" Dyballa)]

I am building once more watching in another window of GNU Emacs what is happening in /opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_macports_release_tarballs_ports_x11_xorg-libxcb/xorg-libxcb/work/libxcb-1.15/doc/manual. It seems that 1888 DOT files à la inherit_graph_<#>.dot are converted into PNG, MAP and MD5 formats. After conversion the DOT file is deleted. The process started at 12:13 h and seems to have some endurance …

[ballapete (Peter "Pete" Dyballa)]

The conversion process of these 1,889 files (they start with a zero number) finished at 13:27 h, followed by some more DOT files. These took another almost ten minutes. Without the docs the port builds in less than a minute.

[ballapete (Peter "Pete" Dyballa)]

On a more powerful intel MacBook Pro build with documentation takes less than ten minutes…

Could there be a warning in Portfile that on some systems (one of them is High Sierra with Sandy Bridge – BTW, there is a utility I only seldom use that can output the CPU's name, which one is that?) building the docs could take very long?

After all: invalid report.

[ballapete (Peter "Pete" Dyballa)]

On a PowerBook G4 with Mac OS X 10.5.8, Leopard, building xorg-libxcb +docs took just 75 min. I presume now that graphviz-devel is the culprit…

[ballapete (Peter "Pete" Dyballa)]

On intel Monterey building xorg-libxcb +docs with graphviz-devel took almost ten minutes as well.

[kencu (Ken)]

If it’s a specific, non-default variant that fails, please remember to put that information in the title as it is relevant to both searching and to ticket cleanup projects.

I fixed almost all your Tiger tickets in a few minutes, but sorting out what is still relevant in the rest of your many tickets is taking a long time.

Can you find a few minutes to close out the ancient, irrelevant ones?

Then I can find and fix the rest of the fixable ones.

[ballapete (Peter "Pete" Dyballa)]

Alright!