P1642R11 Freestanding Library: Easy [utilities], [ranges], and [iterators]

Author: burblebee

source/concepts.tex

@@ -169,6 +169,7 @@
 
 \indexheader{concepts}%
 \begin{codeblock}
+// all freestanding
 namespace std {
   // \ref{concepts.lang}, language-related concepts
   // \ref{concept.same}, concept \libconcept{same_as}

source/intro.tex

@@ -840,12 +840,16 @@
 
 \pnum
 Two kinds of implementations are defined: a \defnadj{hosted}{implementation} and a
-\defnadj{freestanding}{implementation}. For a hosted implementation, this
-document defines the set of available libraries. A freestanding
+\defnadj{freestanding}{implementation}.
+A freestanding
 implementation is one in which execution may take place without the benefit of
-an operating system, and has an \impldef{required libraries for freestanding
-implementation} set of libraries that includes certain language-support
-libraries\iref{compliance}.
+an operating system.
+A hosted implementation
+supports all the facilities described in this document, while
+a freestanding implementation
+supports the entire \Cpp{} language
+described in \ref{lex} through \ref{cpp} and
+the subset of the library facilities described in \ref{compliance}.
 
 \pnum
 A conforming implementation may have extensions (including

source/iterators.tex

@@ -904,6 +904,51 @@
 \pnum
 An implementation may use any technique that provides equivalent observable behavior.
 
+\rSec3[freestanding.entity]{Freestanding entities}
+
+\pnum
+A \defnadj{freestanding}{entity} is a declaration or macro definition
+that is present in a freestanding implementation and a hosted implementation.
+
+\pnum
+Unless otherwise specified,
+the requirements on freestanding entities on a freestanding implementation
+are the same as the corresponding requirements in a hosted implementation.
+
+\pnum
+In a header synopsis, entities followed with a comment
+that includes \textit{freestanding} are freestanding entities.
+\begin{example}
+\begin{codeblock}
+#define NULL see below      // freestanding
+\end{codeblock}
+\end{example}
+
+\pnum
+If a header synopsis begins with a comment
+that includes \textit{all freestanding},
+then all of the declarations and macro definitions in the header synopsis
+are freestanding entities.
+\begin{example}
+\begin{codeblock}
+// all freestanding
+namespace std {
+\end{codeblock}
+\end{example}
+
+\pnum
+Deduction guides for freestanding entity class templates are freestanding entities.
+
+\pnum
+Enclosing namespaces of freestanding entities are freestanding entities.
+
+\pnum
+Friends of freestanding entities are freestanding entities.
+
+\pnum
+Entities denoted by freestanding entity \grammarterm{typedef-names} and
+freestanding entity alias templates are freestanding entities.
+
 \rSec1[requirements]{Library-wide requirements}
 
 \rSec2[requirements.general]{General}
@@ -1342,38 +1387,31 @@
 \ref{concepts}           & Concepts library          & \tcode{<concepts>}         \\ \rowsep
 \ref{type.traits}        & Type traits               & \tcode{<type_traits>}      \\ \rowsep
 \ref{bit}                & Bit manipulation          & \tcode{<bit>}              \\ \rowsep
-\ref{atomics}            & Atomics                   & \tcode{<atomic>}           \\
+\ref{atomics}            & Atomics                   & \tcode{<atomic>}           \\ \rowsep
+\ref{utility}            & Utility components        & \tcode{<utility>}          \\ \rowsep
+\ref{tuple}              & Tuples                    & \tcode{<tuple>}            \\ \rowsep
+\ref{memory}             & Memory                    & \tcode{<memory>}           \\ \rowsep
+\ref{function.objects}   & Function objects          & \tcode{<functional>}       \\ \rowsep
+\ref{ratio}              & Compile-time rational arithmetic & \tcode{<ratio>}     \\ \rowsep
+\ref{iterators}          & Iterators library         & \tcode{<iterator>}         \\ \rowsep
+\ref{ranges}             & Ranges library            & \tcode{<ranges>}           \\
 \end{libsumtab}
 
 \pnum
-The supplied version of the header \libheaderref{cstdlib}
-shall declare at least the functions
-\indexlibraryglobal{abort}%
-\tcode{abort},
-\indexlibraryglobal{atexit}%
-\tcode{atexit},
-\indexlibraryglobal{at_quick_exit}%
-\tcode{at_quick_exit},
-\indexlibraryglobal{exit}%
-\tcode{exit},
-and
-\indexlibraryglobal{quick_exit}%
-\tcode{quick_exit}\iref{support.start.term}.
-\indextext{implementation!hosted}%
-The supplied version of the header \libheaderrefx{atomic}{atomics.syn}
-shall meet the same requirements as for a hosted implementation
-except that support for
-always lock-free integral atomic types\iref{atomics.lockfree}
-is \impldef{support for always lock-free integral atomic types in
-freestanding environments}, and
-whether or not the type aliases \tcode{atomic_signed_lock_free} and
-\tcode{atomic_unsigned_lock_free} are defined\iref{atomics.alias}
-is \impldef{type aliases \tcode{atomic_signed_lock_free} and
-\tcode{atomic_unsigned_lock_free} in freestanding environments}.
-The other headers listed in this table
-shall meet the same requirements as for a hosted implementation.
+For each of the headers listed in \tref{headers.cpp.fs},
+a freestanding implementation provides at least
+the freestanding entities\iref{freestanding.entity} declared in the header.
 \indextext{implementation!freestanding|)}%
 
+\pnum
+\begin{note}
+Throwing a standard library provided exception
+is not observably different from \tcode{terminate()}
+if the implementation does not
+unwind the stack during exception handling\iref{except.handle} and
+the user's program contains no catch blocks.
+\end{note}
+
 \rSec2[using]{Using the library}
 
 \rSec3[using.overview]{Overview}