* Paul Eggert: > On 10/2/20 12:01 PM, Alejandro Colomar wrote: >> If you propose not to document the stdint types either, > > This is not a stdint.h issue. __int128 is not in stdint.h and is not a > system data type in any real sense; it's purely a compiler > issue. Besides, do we start repeating the GCC manual too, while we're > at it? At some point we need to restrain ourselves and stay within the > scope of the man pages.
The manual pages also duplicate the glibc manual, and as far as I know, it's what programmers actually read. (Downstream, we receive many more man-pages bugs than glibc or GCC manual bugs.) Most developers use distributions which do not ship the glibc or GCC manual for licensing policy reasons, so the GNU manuals are not installed locally. > PS. Have you ever tried to use __int128 in real code? I have, to my > regret. It's a portability and bug minefield and should not be used > unless you really know what you're doing, which most people do not. Doesn't this suggest we need improved documentation? Thanks, Florian -- Red Hat GmbH, https://de.redhat.com/ , Registered seat: Grasbrunn, Commercial register: Amtsgericht Muenchen, HRB 153243, Managing Directors: Charles Cachera, Brian Klemm, Laurie Krebs, Michael O'Neill
