[libcxx-commits] [PATCH] D105082: [libcxx][NFC] removes header synopses

[Christopher Di Bella via Phabricator via libcxx-commits]

cjdb created this revision.
cjdb added reviewers: ldionne, EricWF, zoecarver, Mordante, Quuxplusone.
Herald added a reviewer: jfb.
Herald added subscribers: smeenai, jfb, arphaman.
cjdb requested review of this revision.
Herald added a project: libc++.
Herald added a subscriber: libcxx-commits.
Herald added a reviewer: libc++.

It probably made a lot of sense to include the headers' synopses in the
files themselves back when libc++ was first being implemented, but we're
a more connected world a decade on. It's very easy to look up synopses
using wg21.link, and we've also got cppreference, which is a
well-maintained wiki.

The synopses are essentially repeating a lot of the code, and they're a
maintenance burden that has plenty of evidence showing that they're not
always well-maintained. With our transition to more fine-grained
headers, it's also possible to consider these additional headers like a
synopsis summary.

As such, it's not really clear who the header synopses serve, except
maybe Big Storage (not really: we're only saving a little under 614KiB).


Repository:
  rG LLVM Github Monorepo

https://reviews.llvm.org/D105082

Files:
  libcxx/include/algorithm
  libcxx/include/any
  libcxx/include/array
  libcxx/include/atomic
  libcxx/include/barrier
  libcxx/include/bit
  libcxx/include/bitset
  libcxx/include/cassert
  libcxx/include/cctype
  libcxx/include/cerrno
  libcxx/include/cfenv
  libcxx/include/cfloat
  libcxx/include/charconv
  libcxx/include/chrono
  libcxx/include/climits
  libcxx/include/clocale
  libcxx/include/cmath
  libcxx/include/codecvt
  libcxx/include/compare
  libcxx/include/complex
  libcxx/include/concepts
  libcxx/include/condition_variable
  libcxx/include/csetjmp
  libcxx/include/csignal
  libcxx/include/cstdarg
  libcxx/include/cstddef
  libcxx/include/cstdint
  libcxx/include/cstdio
  libcxx/include/cstdlib
  libcxx/include/cstring
  libcxx/include/ctime
  libcxx/include/cwchar
  libcxx/include/cwctype
  libcxx/include/deque
  libcxx/include/exception
  libcxx/include/filesystem
  libcxx/include/format
  libcxx/include/forward_list
  libcxx/include/fstream
  libcxx/include/functional
  libcxx/include/future
  libcxx/include/initializer_list
  libcxx/include/iomanip
  libcxx/include/ios
  libcxx/include/iosfwd
  libcxx/include/iostream
  libcxx/include/istream
  libcxx/include/iterator
  libcxx/include/latch
  libcxx/include/limits
  libcxx/include/list
  libcxx/include/locale
  libcxx/include/map
  libcxx/include/memory
  libcxx/include/mutex
  libcxx/include/new
  libcxx/include/numbers
  libcxx/include/numeric
  libcxx/include/optional
  libcxx/include/ostream
  libcxx/include/queue
  libcxx/include/random
  libcxx/include/ranges
  libcxx/include/ratio
  libcxx/include/regex
  libcxx/include/scoped_allocator
  libcxx/include/semaphore
  libcxx/include/set
  libcxx/include/shared_mutex
  libcxx/include/span
  libcxx/include/sstream
  libcxx/include/stack
  libcxx/include/stdexcept
  libcxx/include/streambuf
  libcxx/include/string
  libcxx/include/string_view
  libcxx/include/strstream
  libcxx/include/system_error
  libcxx/include/thread
  libcxx/include/tuple
  libcxx/include/type_traits
  libcxx/include/typeindex
  libcxx/include/typeinfo
  libcxx/include/unordered_map
  libcxx/include/unordered_set
  libcxx/include/utility
  libcxx/include/valarray
  libcxx/include/variant
  libcxx/include/vector
  libcxx/include/version