Skip to content

Commit 515e84f

Browse files
committed
[std] Remove 'should' and 'may' from footnotes.
Partially addresses ISO/CS 017 (C++20 DIS)
1 parent 90f630a commit 515e84f

File tree

5 files changed

+31
-17
lines changed

5 files changed

+31
-17
lines changed

source/algorithms.tex

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4462,7 +4462,7 @@
44624462
Copies elements in the range \range{first}{last}
44634463
into the range \range{result - $N$}{result}
44644464
starting from \tcode{last - 1} and proceeding to \tcode{first}.%
4465-
\footnote{\tcode{copy_backward} should be used instead of copy
4465+
\footnote{\tcode{copy_backward} can be used instead of copy
44664466
when \tcode{last} is in the range \range{result - $N$}{result}.}
44674467
For each positive integer $n \le N$,
44684468
performs \tcode{*(result - $n$) = *(last - $n$)}.
@@ -4613,7 +4613,7 @@
46134613
Moves elements in the range \range{first}{last}
46144614
into the range \range{result - $N$}{result}
46154615
starting from \tcode{last - 1} and proceeding to \tcode{first}.%
4616-
\footnote{\tcode{move_backward} should be used instead of move
4616+
\footnote{\tcode{move_backward} can be used instead of move
46174617
when \tcode{last} is in the range \range{result - $N$}{result}.}
46184618
For each positive integer $n \le N$,
46194619
performs \tcode{*(result - $n$) = $E$}.

source/expressions.tex

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3932,7 +3932,7 @@
39323932
\pnum
39333933
An object pointer
39343934
can be explicitly converted to an object pointer of a different type.\footnote{The
3935-
types may have different \cv-qualifiers, subject to
3935+
types can have different \cv-qualifiers, subject to
39363936
the overall
39373937
restriction that a \tcode{reinterpret_cast} cannot cast away constness.}
39383938
When a prvalue \tcode{v} of object pointer type is converted to
@@ -3970,7 +3970,7 @@
39703970
A prvalue of type ``pointer to member of \tcode{X} of type \tcode{T1}''
39713971
can be explicitly converted to a prvalue of a different type ``pointer to member of
39723972
\tcode{Y} of type \tcode{T2}'' if \tcode{T1} and \tcode{T2} are both
3973-
function types or both object types.\footnote{\tcode{T1} and \tcode{T2} may have
3973+
function types or both object types.\footnote{\tcode{T1} and \tcode{T2} can have
39743974
different \cv-qualifiers, subject to
39753975
the overall restriction that a \tcode{reinterpret_cast} cannot cast away
39763976
constness.} The null member pointer value\iref{conv.mem} is converted to the
@@ -5171,7 +5171,7 @@
51715171

51725172
\pnum
51735173
\indextext{\idxcode{new}!exception and}%
5174-
If any part of the object initialization described above\footnote{This may
5174+
If any part of the object initialization described above\footnote{This might
51755175
include evaluating a \grammarterm{new-initializer} and/or calling
51765176
a constructor.}
51775177
terminates by throwing an exception and a suitable deallocation function
@@ -7351,12 +7351,12 @@
73517351

73527352
\item
73537353
an immediate subexpression of a \grammarterm{braced-init-list},%
7354-
\footnote{Constant evaluation may be necessary to determine whether a narrowing conversion is performed\iref{dcl.init.list}.}
7354+
\footnote{Constant evaluation might be necessary to determine whether a narrowing conversion is performed\iref{dcl.init.list}.}
73557355

73567356
\item
73577357
an expression of the form \tcode{\&} \grammarterm{cast-expression}
73587358
that occurs within a templated entity,%
7359-
\footnote{Constant evaluation may be necessary to determine whether such an expression is value-dependent\iref{temp.dep.constexpr}.}
7359+
\footnote{Constant evaluation might be necessary to determine whether such an expression is value-dependent\iref{temp.dep.constexpr}.}
73607360
or
73617361

73627362
\item

source/future.tex

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -865,8 +865,6 @@
865865
How many additional write positions are made
866866
available is otherwise unspecified.%
867867
\indextext{unspecified}%
868-
\footnote{An implementation should consider \tcode{alsize} in making this
869-
decision.}
870868
If \tcode{palloc} is not a null pointer, the function calls
871869
\tcode{(*palloc)(n)}
872870
to allocate the new dynamic array object.
@@ -890,6 +888,11 @@
890888
or if
891889
\tcode{(strmode \& frozen) != 0},
892890
the function cannot extend the array (reallocate it with greater length) to make a write position available.
891+
892+
\pnum
893+
\recommended
894+
An implementation should consider \tcode{alsize} in making the
895+
decision how many additional write positions to make available.}
893896
\end{itemdescr}
894897

895898
\indexlibrarymember{pbackfail}{strstreambuf}%

source/iostreams.tex

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -430,8 +430,12 @@
430430
The objects are constructed and the associations are established at some
431431
time prior to or during the first time an object of class
432432
\tcode{ios_base::Init} is constructed, and in any case before the body
433-
of \tcode{main}\iref{basic.start.main} begins execution.\footnote{If it is possible for them to do so, implementations should
434-
initialize the objects earlier than required.}
433+
of \tcode{main}\iref{basic.start.main} begins execution.
434+
435+
\recommended
436+
If it is possible for them to do so, implementations should
437+
initialize the objects earlier than required.
438+
435439
The objects are not destroyed during program execution.\footnote{Constructors and destructors for objects with
436440
static storage duration can
437441
access these objects to read input from

source/locales.tex

Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4057,15 +4057,15 @@
40574057
interpreted identically as the format specifiers in the string
40584058
argument to the standard library function
40594059
\indexlibraryglobal{strftime}%
4060-
\tcode{strftime()}\footnote{Interpretation of the \tcode{modifier}
4061-
argument is implementation-defined, but should follow POSIX
4062-
conventions.},
4060+
\tcode{strftime()},
40634061
except that the sequence of characters produced for those specifiers
40644062
that are described as depending on the C locale are instead \impldef{formatted character
40654063
sequence generated by \tcode{time_put::do_put} in C
4066-
locale}.\footnote{Implementations should refer to other standards
4067-
such as POSIX
4068-
for these definitions.}
4064+
locale}.
4065+
\begin{note}
4066+
Interpretation of the \tcode{modifier}
4067+
argument is implementation-defined.
4068+
\end{note}
40694069

40704070
\pnum
40714071
\returns
@@ -4075,6 +4075,13 @@
40754075
formats or by derivations. A space character is a reasonable
40764076
default for this argument.
40774077
\end{note}
4078+
4079+
\pnum
4080+
\recommended
4081+
Interpretation of the \tcode{modifier} should follow POSIX conventions.
4082+
Implementations should refer to other standards such as POSIX
4083+
for a specification of the character sequences produced for
4084+
those specifiers described as depending on the C locale.
40784085
\end{itemdescr}
40794086

40804087
\rSec3[locale.time.put.byname]{Class template \tcode{time_put_byname}}

0 commit comments

Comments
 (0)