[mdspan] Shorten subclause labels

Author: jensmaurer

source/containers.tex

@@ -19066,7 +19066,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;
 
@@ -19079,7 +19079,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(
@@ -19966,7 +19966,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@;
@@ -20289,7 +20289,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@;
@@ -20613,7 +20613,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@;
@@ -20934,9 +20934,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
@@ -20963,11 +20963,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&);
@@ -20988,7 +20988,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;
 
@@ -21010,10 +21010,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@;
@@ -21035,7 +21035,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}
@@ -21088,7 +21088,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@;
@@ -21125,7 +21125,7 @@
 \end{note}
 \end{itemdescr}
 
-\rSec5[mdspan.layout.leftpadded.cons]{Constructors}
+\rSec5[mdspan.layout.leftpad.cons]{Constructors}
 
 \indexlibraryctor{layout_left_padded::mapping}%
 \begin{itemdecl}
@@ -21425,7 +21425,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;
@@ -21556,9 +21556,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
@@ -21586,11 +21586,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&);
@@ -21612,7 +21612,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;
 
@@ -21635,11 +21635,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@;
@@ -21661,7 +21661,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}
@@ -21714,7 +21714,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@;
@@ -21752,7 +21752,7 @@
 \end{note}
 \end{itemdescr}
 
-\rSec5[mdspan.layout.rightpadded.cons]{Constructors}
+\rSec5[mdspan.layout.rightpad.cons]{Constructors}
 
 \indexlibraryctor{layout_right_padded::mapping}%
 \begin{itemdecl}
@@ -22053,7 +22053,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}
@@ -22986,9 +22986,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}
@@ -22997,7 +22997,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}
@@ -23031,7 +23031,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
@@ -23070,7 +23070,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}
@@ -23096,7 +23096,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_}}%
@@ -23219,7 +23219,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}
@@ -23326,12 +23326,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
@@ -23396,7 +23396,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}
@@ -23477,7 +23477,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}
@@ -23561,7 +23561,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}
@@ -23586,7 +23586,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}
@@ -23661,7 +23661,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}
@@ -23741,7 +23741,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}