[mdspan] Shorten subclause labels

Author: jensmaurer

source/containers.tex

@@ -19078,7 +19078,7 @@
            class AccessorPolicy = default_accessor<ElementType>>
     class mdspan;
 
-  // \ref{mdspan.submdspan}, \tcode{submdspan} creation
+  // \ref{mdspan.sub}, \tcode{submdspan} creation
   template<class OffsetType, class LengthType, class StrideType>
     struct strided_slice;
 
@@ -19091,7 +19091,7 @@
   template<class IndexType, class... Extents, class... SliceSpecifiers>
     constexpr auto submdspan_extents(const extents<IndexType, Extents...>&, SliceSpecifiers...);
 
-  // \ref{mdspan.submdspan.submdspan}, \tcode{submdspan} function template
+  // \ref{mdspan.sub.sub}, \tcode{submdspan} function template
   template<class ElementType, class Extents, class LayoutPolicy,
            class AccessorPolicy, class... SliceSpecifiers>
     constexpr auto submdspan(
@@ -19978,7 +19978,7 @@
   private:
     extents_type @\exposid{extents_}@{};                                               // \expos
 
-    // \ref{mdspan.submdspan.mapping}, \tcode{submdspan} mapping specialization
+    // \ref{mdspan.sub.map}, \tcode{submdspan} mapping specialization
     template<class... SliceSpecifiers>
       constexpr auto @\exposid{submdspan-mapping-impl}@(SliceSpecifiers...) const     // \expos
         -> @\seebelow@;
@@ -20301,7 +20301,7 @@
   private:
     extents_type @\exposid{extents_}@{};    // \expos
 
-    // \ref{mdspan.submdspan.mapping}, \tcode{submdspan} mapping specialization
+    // \ref{mdspan.sub.map}, \tcode{submdspan} mapping specialization
     template<class... SliceSpecifiers>
       constexpr auto @\exposid{submdspan-mapping-impl}@(SliceSpecifiers...) const       // \expos
         -> @\seebelow@;
@@ -20625,7 +20625,7 @@
     extents_type @\exposid{extents_}@{};                    // \expos
     array<index_type, @\exposid{rank_}@> @\exposid{strides_}@{};        // \expos
 
-    // \ref{mdspan.submdspan.mapping}, \tcode{submdspan} mapping specialization
+    // \ref{mdspan.sub.map}, \tcode{submdspan} mapping specialization
     template<class... SliceSpecifiers>
       constexpr auto @\exposid{submdspan-mapping-impl}@(SliceSpecifiers...) const       // \expos
         -> @\seebelow@;
@@ -20946,9 +20946,9 @@
 Otherwise, \tcode{false}.
 \end{itemdescr}
 
-\rSec4[mdspan.layout.leftpadded]{Class template \tcode{layout_left_padded::mapping}}
+\rSec4[mdspan.layout.leftpad]{Class template \tcode{layout_left_padded::mapping}}
 
-\rSec5[mdspan.layout.leftpadded.overview]{Overview}
+\rSec5[mdspan.layout.leftpad.overview]{Overview}
 
 \pnum
 \tcode{layout_left_padded} provides a layout mapping
@@ -20975,11 +20975,11 @@
     static constexpr size_t @\exposid{first-static-extent}@ =                 // \expos
       extents_type::static_extent(0);
 
-    // \ref{mdspan.layout.leftpadded.expo}, exposition-only members
+    // \ref{mdspan.layout.leftpad.expo}, exposition-only members
     static constexpr size_t @\exposid{static-padding-stride}@ = @\seebelow@;  // \expos
 
   public:
-    // \ref{mdspan.layout.leftpadded.cons}, constructors
+    // \ref{mdspan.layout.leftpad.cons}, constructors
     constexpr mapping() noexcept : mapping(extents_type{}) {}
     constexpr mapping(const mapping&) noexcept = default;
     constexpr mapping(const extents_type&);
@@ -21000,7 +21000,7 @@
 
     constexpr mapping& operator=(const mapping&) noexcept = default;
 
-    // \ref{mdspan.layout.leftpadded.obs}, observers
+    // \ref{mdspan.layout.leftpad.obs}, observers
     constexpr const extents_type& extents() const noexcept { return @\exposid{extents_}@; }
     constexpr array<index_type, rank_> strides() const noexcept;
 
@@ -21022,10 +21022,10 @@
       friend constexpr bool operator==(const mapping&, const LayoutLeftPaddedMapping&) noexcept;
 
   private:
-    // \ref{mdspan.layout.leftpadded.expo}, exposition-only members
+    // \ref{mdspan.layout.leftpad.expo}, exposition-only members
     index_type @\exposid{stride-1}@ = @\exposid{static-padding-stride}@;                           // \expos
     extents_type @\exposid{extents_}@{};                                               // \expos
-    // \ref{mdspan.submdspan.mapping}, submdspan mapping specialization
+    // \ref{mdspan.sub.map}, submdspan mapping specialization
     template<class... SliceSpecifiers>
       constexpr auto @\exposid{submdspan-mapping-impl}@(SliceSpecifiers...) const     // \expos
         -> @\seebelow@;
@@ -21047,7 +21047,7 @@
 that models \libconcept{regular} for each \tcode{E}.
 
 \pnum
-Throughout \ref{mdspan.layout.leftpadded},
+Throughout \ref{mdspan.layout.leftpad},
 let \tcode{P_rank} be the following
 size \exposid{rank_} parameter pack of \tcode{size_}t values:
 \begin{itemize}
@@ -21100,7 +21100,7 @@
 is representable as a value of type \tcode{index_type}.
 \end{itemize}
 
-\rSec5[mdspan.layout.leftpadded.expo]{Exposition-only members}
+\rSec5[mdspan.layout.leftpad.expo]{Exposition-only members}
 
 \begin{itemdecl}
 static constexpr size_t @\exposid{static-padding-stride}@ = @\seebelow@;
@@ -21137,7 +21137,7 @@
 \end{note}
 \end{itemdescr}
 
-\rSec5[mdspan.layout.leftpadded.cons]{Constructors}
+\rSec5[mdspan.layout.leftpad.cons]{Constructors}
 
 \indexlibraryctor{layout_left_padded::mapping}%
 \begin{itemdecl}
@@ -21437,7 +21437,7 @@
 \end{note}
 \end{itemdescr}
 
-\rSec5[mdspan.layout.leftpadded.obs]{Observers}
+\rSec5[mdspan.layout.leftpad.obs]{Observers}
 
 \begin{itemdecl}
 constexpr array<index_type, @\exposid{rank_}@> strides() const noexcept;
@@ -21568,9 +21568,9 @@
 Otherwise, \tcode{false}.
 \end{itemdescr}
 
-\rSec4[mdspan.layout.rightpadded]{Class template \tcode{layout_right_padded::mapping}}
+\rSec4[mdspan.layout.rightpad]{Class template \tcode{layout_right_padded::mapping}}
 
-\rSec5[mdspan.layout.rightpadded.overview]{Overview}
+\rSec5[mdspan.layout.rightpad.overview]{Overview}
 
 \pnum
 \tcode{layout_right_padded} provides a layout mapping
@@ -21598,11 +21598,11 @@
     static constexpr size_t @\exposid{last-static-extent}@ =             // \expos
       extents_type::static_extent(@\exposid{rank_}@ - 1);
 
-    // \ref{mdspan.layout.rightpadded.expo}, exposition-only members
+    // \ref{mdspan.layout.rightpad.expo}, exposition-only members
     static constexpr size_t @\exposid{static-padding-stride}@ = @\seebelow@; // \expos
 
   public:
-    // \ref{mdspan.layout.rightpadded.cons}, constructors
+    // \ref{mdspan.layout.rightpad.cons}, constructors
     constexpr mapping() noexcept : mapping(extents_type{}) {}
     constexpr mapping(const mapping&) noexcept = default;
     constexpr mapping(const extents_type&);
@@ -21624,7 +21624,7 @@
 
     constexpr mapping& operator=(const mapping&) noexcept = default;
 
-    // \ref{mdspan.layout.rightpadded.obs}, observers
+    // \ref{mdspan.layout.rightpad.obs}, observers
     constexpr const extents_type& extents() const noexcept { return extents_; }
     constexpr array<index_type, rank_> strides() const noexcept;
 
@@ -21647,11 +21647,11 @@
       friend constexpr bool operator==(const mapping&, const LayoutRightPaddedMapping&) noexcept;
 
   private:
-    // \ref{mdspan.layout.rightpadded.expo}, exposition-only members
+    // \ref{mdspan.layout.rightpad.expo}, exposition-only members
     index_type @\exposid{stride-rm2}@ = @\exposid{static-padding-stride}@;                         // \expos
     extents_type @\exposid{extents_}@{};                                               // \expos
 
-    // \ref{mdspan.submdspan.mapping}, submdspan mapping specialization
+    // \ref{mdspan.sub.map}, submdspan mapping specialization
     template<class... SliceSpecifiers>
       constexpr auto @\exposid{submdspan-mapping-impl}@(SliceSpecifiers...) const     // \expos
         -> @\seebelow@;
@@ -21673,7 +21673,7 @@
 that models \libconcept{regular} for each \tcode{E}.
 
 \pnum
-Throughout \ref{mdspan.layout.rightpadded},
+Throughout \ref{mdspan.layout.rightpad},
 let \tcode{P_rank} be the following
 size \exposid{rank_} parameter pack of \tcode{size_}t values:
 \begin{itemize}
@@ -21726,7 +21726,7 @@
 is representable as a value of type \tcode{index_type}.
 \end{itemize}
 
-\rSec5[mdspan.layout.rightpadded.expo]{Exposition-only members}
+\rSec5[mdspan.layout.rightpad.expo]{Exposition-only members}
 
 \begin{itemdecl}
 static constexpr size_t @\exposid{static-padding-stride}@ = @\seebelow@;
@@ -21764,7 +21764,7 @@
 \end{note}
 \end{itemdescr}
 
-\rSec5[mdspan.layout.rightpadded.cons]{Constructors}
+\rSec5[mdspan.layout.rightpad.cons]{Constructors}
 
 \indexlibraryctor{layout_right_padded::mapping}%
 \begin{itemdecl}
@@ -22065,7 +22065,7 @@
 \end{note}
 \end{itemdescr}
 
-\rSec5[mdspan.layout.rightpadded.obs]{Observers}
+\rSec5[mdspan.layout.rightpad.obs]{Observers}
 
 \indexlibrarymember{layout_right_padded::mapping}{strides}%
 \begin{itemdecl}
@@ -22998,9 +22998,9 @@
 \end{codeblock}
 \end{itemdescr}
 
-\rSec3[mdspan.submdspan]{\tcode{submdspan}}
+\rSec3[mdspan.sub]{\tcode{submdspan}}
 
-\rSec4[mdspan.submdspan.overview]{Overview}
+\rSec4[mdspan.sub.overview]{Overview}
 
 \pnum
 The \tcode{submdspan} facilities create a new \tcode{mdspan}
@@ -23009,7 +23009,7 @@
 the \tcode{SliceSpecifier} arguments.
 
 \pnum
-For each function defined in subclause \ref{mdspan.submdspan} that
+For each function defined in subclause \ref{mdspan.sub} that
 takes a parameter pack named \tcode{slices} as an argument:
 
 \begin{itemize}
@@ -23043,7 +23043,7 @@
   \end{itemize}
 \end{itemize}
 
-\rSec4[mdspan.submdspan.strided.slice]{\tcode{strided_slice}}
+\rSec4[mdspan.sub.strided.slice]{\tcode{strided_slice}}
 
 \pnum
 \tcode{strided_slice} represents a set of
@@ -23082,7 +23082,7 @@
 Indices are selected from the half-open interval \range{1}{1 + 10}.
 \end{note}
 
-\rSec4[mdspan.submdspan.submdspan.mapping.result]{\tcode{submdspan_mapping_result}}
+\rSec4[mdspan.sub.map.result]{\tcode{submdspan_mapping_result}}
 
 \pnum
 Specializations of \tcode{submdspan_mapping_result}
@@ -23108,7 +23108,7 @@
 \tcode{LayoutMapping} shall meet
 the layout mapping requirements\iref{mdspan.layout.policy.reqmts}.
 
-\rSec4[mdspan.submdspan.helpers]{Exposition-only helpers}
+\rSec4[mdspan.sub.helpers]{Exposition-only helpers}
 
 \indexlibraryglobal{\exposid{de-ice}}%
 \indexlibraryglobal{\exposid{first_}}%
@@ -23231,7 +23231,7 @@
 \end{itemize}
 \end{itemdescr}
 
-\rSec4[mdspan.submdspan.extents]{\tcode{submdspan_extents} function}
+\rSec4[mdspan.sub.extents]{\tcode{submdspan_extents} function}
 
 \indexlibraryglobal{submdspan_extents}%
 \begin{itemdecl}
@@ -23338,12 +23338,12 @@
 \end{itemize}
 \end{itemdescr}
 
-\rSec4[mdspan.submdspan.mapping]{Specializations of \tcode{submdspan_mapping}}
+\rSec4[mdspan.sub.map]{Specializations of \tcode{submdspan_mapping}}
 
-\rSec5[mdspan.submdspan.mapping.common]{Common}
+\rSec5[mdspan.sub.map.common]{Common}
 
 \pnum
-The following elements apply to all functions in \ref{mdspan.submdspan.mapping}.
+The following elements apply to all functions in \ref{mdspan.sub.map}.
 
 \pnum
 \constraints
@@ -23408,7 +23408,7 @@
 Let \tcode{offset} be a value of type \tcode{size_t} equal to
 \tcode{(*this)(\exposid{first_}<index_type, P>(slices...)...)}.
 
-\rSec5[mdspan.submdspan.mapping.left]{\tcode{layout_left} specialization of \tcode{submdspan_mapping}}
+\rSec5[mdspan.sub.map.left]{\tcode{layout_left} specialization of \tcode{submdspan_mapping}}
 
 \indexlibrarymemberexpos{layout_left::mapping}{submdspan-mapping-impl}%
 \begin{itemdecl}
@@ -23489,7 +23489,7 @@
 \end{itemize}
 \end{itemdescr}
 
-\rSec5[mdspan.submdspan.mapping.right]{\tcode{layout_right} specialization of \tcode{submdspan_mapping}}
+\rSec5[mdspan.sub.map.right]{\tcode{layout_right} specialization of \tcode{submdspan_mapping}}
 
 \indexlibrarymemberexpos{layout_right::mapping}{submdspan-mapping-impl}%
 \begin{itemdecl}
@@ -23573,7 +23573,7 @@
 \end{itemize}
 \end{itemdescr}
 
-\rSec5[mdspan.submdspan.mapping.stride]{\tcode{layout_stride} specialization of \tcode{submdspan_mapping}}
+\rSec5[mdspan.sub.map.stride]{\tcode{layout_stride} specialization of \tcode{submdspan_mapping}}
 
 \indexlibrarymemberexpos{layout_stride::mapping}{submdspan-mapping-impl}%
 \begin{itemdecl}
@@ -23598,7 +23598,7 @@
 \end{itemize}
 \end{itemdescr}
 
-\rSec5[mdspan.submdspan.mapping.leftpadded]{\tcode{layout_left_padded} specialization of \tcode{submdspan_mapping}}
+\rSec5[mdspan.sub.map.leftpad]{\tcode{layout_left_padded} specialization of \tcode{submdspan_mapping}}
 
 \indexlibrarymemberexpos{layout_left_padded::mapping}{submdspan-mapping-impl}%
 \begin{itemdecl}
@@ -23673,7 +23673,7 @@
 \end{itemize}
 \end{itemdescr}
 
-\rSec5[mdspan.submdspan.mapping.rightpadded]{\tcode{layout_right_padded} specialization of \tcode{submdspan_mapping}}
+\rSec5[mdspan.sub.map.rightpad]{\tcode{layout_right_padded} specialization of \tcode{submdspan_mapping}}
 
 \indexlibrarymemberexpos{layout_right_padded::mapping}{submdspan-mapping-impl}%
 \begin{itemdecl}
@@ -23753,7 +23753,7 @@
 \end{itemize}
 \end{itemdescr}
 
-\rSec4[mdspan.submdspan.submdspan]{\tcode{submdspan} function template}
+\rSec4[mdspan.sub.sub]{\tcode{submdspan} function template}
 
 \indexlibraryglobal{submdspan}%
 \begin{itemdecl}