<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Editor's Report — Library Fundamentals TS</title>
</head>
<body>
<h1>N4563, Editor's Report for the Library Fundamentals TS</h1>
<time pubdate>2015-11-05</time>
<address>
  Geoffrey Romer<br/>
  Google, Inc.<br/>
  <a href="mailto:gromer@google.com">gromer@google.com</a>
</address>

<h2>New Papers</h2>

<ul>
<li>N4562 is the current working draft for V2 of the Library Fundamentals TS.
  It replaces N4529.</li>
<li>N4563 is this Editor's Report.</li>
<li>N4564 is the Library Fundamentals V2 PDTS.</li>
</ul>

<h2>Notable Changes to Issues and Papers as Moved</h2>

<h3>LWG Motion 13 (N4531)</h3>

<p>Some changes in <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/n4531.html">N4531</a>
were retargeted to the Fundamentals TS. N4531 contains changes that are
targeted at the C++17 working draft, as well as changes that are targeted at the
TS. While the wording of Motion 13 is not clear, I understand it to
direct that <em>all</em> changes be applied to the TS, because there was no
corresponding motion to apply changes to C++17, and the TS changes on their
own would be nonsensical (this was LWG's expressed intent when the paper was
discussed there).</p>

<p>I adjusted the headers, section numbers, and normative references to
reflect this retargeting, and created a new section titled "Shuffle", to
parallel [alg.random.shuffle] in the C++ working draft.</p>

<p>N4531's proposed wording for [alg.random.shuffle] is structured to jointly
specify both the existing 3-argument <code>shuffle()</code> function and the
2-argument function introduced by the paper. However, I do not interpret Motion
13 as directing me to clone the 3-argument function (which is not normatively
affected) into the TS, so I had to substantially rephrase [alg.random.shuffle]
as-edited, so that it covers only the 2-argument function.</p>

<h3>LWG Motion 14 (P0013R1)</h3>

<p>I revised the wording to make it explicit that the <code>value</code>
member must be a static data member. I also dropped redundant mentions of
the <code>_v</code> variable templates, since they are fully specified by
the synopsis. I also renamed some meta-variables for clarity, and made minor
changes to the formatting.</p>

<h2>Notable editorial changes</h2>

<p>To avoid confusion with the new "Shuffle" section, the existing section
"Shuffling and sampling" (which contains no shuffling-related content) was
renamed to "Sampling".</p>

<h2>All changes</h2>

<p>A log of all changes since N4529 is below and on
<a href="https://github.com/cplusplus/fundamentals-ts/compare/N4529...N4562">GitHub</a>.</p>

<!-- git log N4529..N4562 --reverse --no-merges -->
<pre>
commit 4a81e1f885ec07dcefccdfbc4e28c76861be5fe6
Author: Jeffrey Yasskin &lt;jyasskin@gmail.com>
Date:   Sun May 10 18:21:51 2015 -0700

    Update the single-page HTML document.

commit 37dd0d344824feaa264f659319b55eaac668bb23
Author: Jeffrey Yasskin &lt;jyasskin@gmail.com>
Date:   Fri May 29 21:44:40 2015 -0700

    Fix editorial nits found by Daniel Krugler.

commit ddf86ab88c7009eb0c2df7222f92f89ed8f20302
Author: Jeffrey Yasskin &lt;jyasskin@gmail.com>
Date:   Fri May 29 22:33:21 2015 -0700

    Use "Equivalent to return" everywhere the expression's return value is used.

commit a7148af862bd6edac4eb939919d6220c1b098645
Author: Jeffrey Yasskin &lt;jyasskin@gmail.com>
Date:   Sat Jun 6 17:41:53 2015 -0700

    Update the HTML document framework.

commit 0f66c508bf846539ec7732892bb665f77eaf087c
Author: timsong-cpp &lt;rs2740@gmail.com>
Date:   Wed Jul 8 14:27:34 2015 -0400

    propagate_const: add semicolons at the end of signatures for consistency

commit 58a42a5f63b4744f9a048b6790483327c2b2992b
Author: timsong-cpp &lt;rs2740@gmail.com>
Date:   Fri Jul 10 02:47:39 2015 -0400

    Fix obvious typo

commit b04f55c14ba161b2c30243bed36ff9e4b0a32cce
Author: Geoff Romer &lt;gromer@google.com>
Date:   Sat Oct 24 19:38:41 2015 -0700

    Apply Kona Motion 11 (LWG 2494)

commit a00df79bd9ecaf90c93b0844657c22a82ef4eb14
Author: Geoff Romer &lt;gromer@google.com>
Date:   Sat Oct 24 21:21:47 2015 -0700

    Apply Kona Motion 12 (LWG 2500, 2515, 2517, 2526)

commit 3aa15af894d8187d91c4e7c8b7b44a38db4626dd
Author: Geoff Romer &lt;gromer@google.com>
Date:   Mon Oct 26 12:51:01 2015 -0700

    Apply Kona motion 13 (N4531)

commit 0257d04d06eda7a750d83a9376153bf4401ed459
Author: Geoff Romer &lt;gromer@google.com>
Date:   Mon Oct 26 14:28:52 2015 -0700

    Apply Kona motion 14 (P0013R1)

commit b1aacfbbe2500aaadfbeb645deac793a65d03b86
Author: Geoff Romer &lt;gromer@google.com>
Date:   Mon Oct 26 17:33:31 2015 -0700

    Update to reflect new project editor.

commit 2fa8c97d9749e5debbb8bbb88a1487c613a0cfb7
Author: Geoff Romer &lt;gromer@google.com>
Date:   Mon Oct 26 18:19:40 2015 -0700

    Update cxx-revises, and clear document number.

commit cae4c129258ab4c678228d9d603eb5adf7e1a7e3
Author: Geoff Romer &lt;gromer@google.com>
Date:   Tue Oct 27 16:19:11 2015 -0700

    Fix errors in application of previous motions.

    Based on feedback from Daniel Krügler.

commit b62ea63ec0287eeeaf90bf2e4c2494f2f9752c81
Author: Geoff Romer &lt;gromer@google.com>
Date:   Tue Oct 27 16:25:41 2015 -0700

    Misc. small editorial cleanups.

    Based on feedback from Daniel Krügler.

commit 0caf57a2016dd6a3fa970b1d1a24f8e91f37d665
Author: Geoff Romer &lt;gromer@google.com>
Date:   Thu Nov 5 09:16:19 2015 -0800

    Publish N4562.
</pre>

<h2>Acknowledgements</h2>

<p>Thank you to the editing committee, consisting of Jeffrey Yasskin,
Daniel Krügler, and Marshall Clow, for their review of the PDTS. Thanks also
to all who submitted editorial issues.</p>

</body>
</html>
