docs: Online docs improvements, mostly formatting (AcademySoftwareFoundation#4736, AcademySoftwareFoundation#4743)

Signed-off-by: Larry Gritz <[email protected]>

Author: lgritz

src/doc/Doxyfile

@@ -2193,12 +2193,13 @@ PREDEFINED             = DOXYGEN_SHOULD_SKIP_THIS \
                          OIIO_CONST_FUNC= \
                          OIIO_MAYBE_UNUSED= \
                          OIIO_NODISCARD:= \
-                         OIIO_DEPRECATED:=[[deprecated]] \
+                         OIIO_DEPRECATED(x)=[[deprecated]] \
                          OIIO_FORMAT_DEPRECATED:= \
                          OIIO_FORCEINLINE=inline \
                          IMATH_HALF_H_=1 \
                          INCLUDED_IMATHVEC_H=1 \
                          INCLUDED_IMATHMATRIX_H=1 \
+                         OIIO_ENABLE_IF(x)="std::enable_if_t<(x), int> = 0" \
 
 
 # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this

src/doc/requirements.txt

@@ -1,4 +1,4 @@
-sphinx >= 5.0
-breathe == 4.34.0
+sphinx >= 8.0
+breathe == 4.36.0
 sphinx-tabs
-furo==2022.6.21
+furo==2024.8.6

src/doc/texturesys.rst

@@ -178,7 +178,7 @@ structure:
 
 - `int colortransformid` :
    If non-zero, specifies a color transformation to apply to the texels, a
-   handle to a transform retrerieved `TextureSystem::get_colortransform_id()`.
+   handle to a transform retrieved `TextureSystem::get_colortransform_id()`.
 
 
 

src/include/OpenImageIO/span.h

@@ -95,6 +95,7 @@ class span {
     /// Copy constructor (copies the span pointer and length, NOT the data).
     constexpr span (const span &copy) noexcept = default;
 
+#ifndef OIIO_DOXYGEN  /* this declaration confuses doxygen */
     /// Copy constructor from a different extent (copies the span pointer and
     /// length, NOT the data). This allows for construction of `span<const T>`
     /// from `span<T>`, and for converting fixed extent to dynamic extent.
@@ -104,6 +105,7 @@ class span {
                              && (extent == dynamic_extent || extent == N))>
     constexpr span (const span<U,N> &copy) noexcept
         : m_data(copy.data()), m_size(copy.size()) { }
+#endif
 
     /// Construct from T* and length.
     constexpr span (pointer data, size_type size) noexcept