ORNL / ORNL/cpp-proposals-pub

P2642: LWG 2024/02/28 review

Open
#450 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
HTML
Stars
29
Forks
26
PR merge metrics
No merged PRs in 30d

Description

P2642: LWG 2024/02/28 review

Changes from previous review

"Paragraph numbers are off at the top of the wording." (This is still the case; it awaits more time for formatting.)

LWG is pleased on 2024/02/28. Also pleased with the updated green diff style.

Extra LEAST-MULTIPLE-AT-LEAST condition on constructors.

Paragraphs 6 and 9 of observers now use preferred if/else/otherwise format.

Resuming

Converting ctor from layout_stride::mapping to layout_right_padded::mapping.

11.1 needs a period; make it a complete sentence. Preconditions generally have implicit and between them, so each can be a complete sentence.

18.1 has a missing closing backtick for true. Also, make those Constraints each a stand-alone sentence, just like the preconditions. (Constraints for converting constructor from LayoutLeftPaddedMapping.)

20: Capital letter for direct-non-list-initializes.

21: Remove space between ! and rest of expression.

Note after 21: "... affects neither the constraints nor the preconditions."

[mdspan.layout.rightpadded.obs]

Wording for strides() could declare the function on one line instead of two.

Para 2 Returns: Reformat as one sentence, since it's just two bullets. (Just remove the bullets; leave the current structure.)

(Just for future reference: para 5 is by-construction correct because of the new Mandates and Preconditions.)

Para 9 under stride is a bit wacky, but OK to leave alone, since it's consistent with Ranges. (Add an entry to the Editorial Wiki about this.)

[mdspan.submdspan.mapping]

(Corresponding to 4.2, there was a bug in the current draft. They actually need to be ordered.)

Add a drafting Note to explain that 4.2 is a drive-by fix, an intentional deviation from the current Draft that LWG reviewed and approved.

layout_right specialization of submdspan_mapping, para 1.3, first inner bullet: Add a comma, as with layout_left above, to separate out the values.


Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The issue names P2642 and the sections [mdspan.layout.rightpadded.obs] and [mdspan.submdspan.mapping], but no file or test. Start by locating the P2642 wording in the repository and review the listed constructor, observer, and submdspan mapping paragraphs. Done means applying the specified editorial corrections, adding the drafting Note, and adding the requested Editorial Wiki entry.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.