This is an archive of the discontinued LLVM Phabricator instance.

[libcxx][spaceship][doc] Repair links and clean up spaceship progress doc
ClosedPublic

Authored by mumbleskates on Aug 15 2022, 4:16 PM.

Details

Summary

Previously the specification was in a table in paragraph 14 of [container.requirements.general] but it has since been given its own sub section header, 24.2.2.4 [container.opt.reqmts].

This happened in https://github.com/cplusplus/draft/commit/93ff092d1cd2b335f372b9546365b3d495caf2d8

This update also includes misc. other cleanups of the spaceship projects sheet.

Diff Detail

Event Timeline

mumbleskates created this revision.Aug 15 2022, 4:16 PM
Herald added a project: Restricted Project. · View Herald TranscriptAug 15 2022, 4:16 PM
Herald added a subscriber: yaxunl. · View Herald Transcript
mumbleskates requested review of this revision.Aug 15 2022, 4:16 PM
Herald added a project: Restricted Project. · View Herald TranscriptAug 15 2022, 4:16 PM
Herald added a reviewer: Restricted Project. · View Herald Transcript
avogelsgesang added inline comments.Aug 15 2022, 4:19 PM
libcxx/docs/Status/SpaceshipProjects.csv
38–43

I get a 404 error when opening https://wg21.link/container.opt.reqmts

  • use a version of the link that does not currently 404 on wg21.link
mumbleskates marked an inline comment as done.Aug 15 2022, 4:27 PM
mumbleskates added inline comments.
libcxx/docs/Status/SpaceshipProjects.csv
38–43

yeah, i don't know why. it should work, it's present in https://eel.is/c++draft/container.opt.reqmts . this change was committed to the draft document in early february, over 6 months ago.

it seems that wg21 may be either lagging very far behind by accident or lagging behind on purpose because it is indexing the headers of an older version of the standards document. in the former case someone should see if they can kick it and get it up to date, and in the latter case it should instead redirect to a site that hosts the version of the document it is trying to reflect.

mumbleskates marked an inline comment as done.
  • fix typo in "chrono::time_point"
  • fix broken formatting for the "basic_string" hyperlink
  • link to differentials of completed project items
  • Merge branch 'main' into doc2
mumbleskates retitled this revision from [libcxx][spaceship][doc] Repair links to the optional container requirements for operator<=> to [libcxx][spaceship][doc] Repair links and clean up spaceship progress doc.Aug 15 2022, 6:59 PM
mumbleskates edited the summary of this revision. (Show Details)
avogelsgesang accepted this revision.Aug 16 2022, 1:17 AM

LGTM, thanks!

avogelsgesang added inline comments.Aug 16 2022, 11:26 AM
libcxx/docs/Status/SpaceshipProjects.csv
43
  • Revert "use a version of the link that does not currently 404 on wg21.link"
Herald added a reviewer: herhut. · View Herald Transcript
Herald added a reviewer: rriddle. · View Herald Transcript
Herald added a reviewer: aartbik. · View Herald Transcript
Herald added a reviewer: MaskRay. · View Herald Transcript
Herald added a reviewer: aartbik. · View Herald Transcript
Herald added a reviewer: aartbik. · View Herald Transcript
Herald added a reviewer: sjarus. · View Herald Transcript
Herald added a reviewer: NoQ. · View Herald Transcript
Herald added a reviewer: dcaballe. · View Herald Transcript
Herald added projects: Restricted Project, Restricted Project, Restricted Project, Restricted Project, Restricted Project, Restricted Project, Restricted Project, Restricted Project, Restricted Project. · View Herald Transcript
  • Merge remote-tracking branch 'upstream/main' into doc2
  • Merge branch 'main' into doc2

Sorry! Something has gone horribly wrong with my usage of arcanist and it diffed against a very old version of main. i will try to repair the reviewers list.

mumbleskates removed projects: Restricted Project, Restricted Project, Restricted Project, Restricted Project, Restricted Project, Restricted Project, Restricted Project, Restricted Project, Restricted Project.
mumbleskates removed subscribers: kbarton, JDevlieghere, sstefan1 and 97 others.
Mordante accepted this revision.Aug 17 2022, 9:56 AM

Please update the commit message to use proper sentences.

Otherwise LGTM and thanks for updating the page!

libcxx/docs/Status/SpaceshipProjects.csv
33

This page is only used to track the status of the spaceship operator. After it's implemented the page will be removed.
I don't mind that you spend time on finding the commit and adding it, but I just want to make sure that you know what the status of this page itself will be.
(For the format status I tend to be more aggressive in removing details.)

This revision is now accepted and ready to land.Aug 17 2022, 9:56 AM
avogelsgesang added inline comments.Aug 17 2022, 10:35 AM
libcxx/docs/Status/SpaceshipProjects.csv
33

Afaict, before calling P1614R2 done, we will have to go through this list once more to make sure we actually implemented everything correctly. (As we saw the other day, this list here is unfortunately incomplete). I guess for this double-checking, having the correct review linked will be useful...

mumbleskates edited the summary of this revision. (Show Details)Aug 17 2022, 12:13 PM
mumbleskates marked 3 inline comments as done.Aug 17 2022, 12:16 PM
mumbleskates added inline comments.
libcxx/docs/Status/SpaceshipProjects.csv
33

Yes to both of these comments. I added these links for consistency and because it's extremely easy to find the related differentials from the blame of the doc. After this is looking done I'm planning to do a full pass through the P1614R2 doc and making sure everything is in.

Mordante added inline comments.Aug 18 2022, 8:58 AM
libcxx/docs/Status/SpaceshipProjects.csv
33

We indeed have to validate it since we know the list is incomplete :-( But for that we don't need the revision numbers per se. I just wanted to make sure we're all aware this page is intended to be temporary.

I know that for regex the removal of the operator!=s is missing, but I'll add these when I start to work on them; probably next week. (I get the impression more of these removals are missing.)

mumbleskates marked 2 inline comments as done.Aug 20 2022, 3:01 PM
mumbleskates added inline comments.
libcxx/docs/Status/SpaceshipProjects.csv
33

You're right, this is a big one to check. when i created the document i did so by grepping through the (at the time) current draft standard for "<=>", so i didn't really find any of the non-ordering operator removals.

Mordante added inline comments.Aug 21 2022, 5:31 AM
libcxx/docs/Status/SpaceshipProjects.csv
33

I think it would be easier to grep the paper for removal of operator!= and look for the ones where no operator<=> is added.

avogelsgesang added inline comments.Aug 21 2022, 11:30 AM
libcxx/docs/Status/SpaceshipProjects.csv
33

note that grepping for operator!= might still not be sufficient. In some cases (e.g., filesystem::space_info, the paper added an operator== but no operator<=>