From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-lf1-f54.google.com (mail-lf1-f54.google.com [209.85.167.54]) by sourceware.org (Postfix) with ESMTPS id CA9053858D20 for ; Sun, 21 May 2023 09:40:41 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org CA9053858D20 Authentication-Results: sourceware.org; dmarc=fail (p=none dis=none) header.from=inria.fr Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gmail.com Received: by mail-lf1-f54.google.com with SMTP id 2adb3069b0e04-4f3b9e54338so906186e87.0 for ; Sun, 21 May 2023 02:40:41 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1684662040; x=1687254040; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=owzQwj8I/MixfXzOghhnsUp3KQsZu72ItCaaiuiVwOU=; b=h1PDhPfDAr1OpkceOc8LlbT0XRjPmz4h6I2MzOUHLZz5daEjVzVCmW9ZMZikQsDIM5 3PqgxLBCTPmWCjHbdcPOHdZWDs2GZznVfRn6SfmsfXt1IZ99fZuB18Wy8+f8jFxdS8WG uZTevD7MxHddQ9zLt+dSWFmg1SMkdugvmEtAbdKAMHspmQjckpboTl5wf55zCMrNsKY1 e2ebGlQ2iRPBGtX8Hpw+69oIgQd0FgQB7DrXGBCoCqnGloOJOfyuaUN3Du94v0DRI2Rm bRi1eSfL462G/hV/N8nhGfuny95DVwv6MGTlByBwW7DI1Ucn/W5YZh2VsLwtW53/l27+ FIUA== X-Gm-Message-State: AC+VfDzf3cr88Nd3b5s80WGjDKmwHg3zBKA9sGiaykeIr70DF3WCHXAr SL+K0VFc3RIHIvzm8yjF10Mqr/HweiIZRVCNdR8= X-Google-Smtp-Source: ACHHUZ73lOIpUJEgVZPsceBRgVMF/BiHjq70S7Mk82K3n82m3UKmNydLXxbQiYep/itnVMP82xMo2pyaK5d0GKxSlcw= X-Received: by 2002:a19:761a:0:b0:4f3:a873:44dc with SMTP id c26-20020a19761a000000b004f3a87344dcmr2192648lff.34.1684662040132; Sun, 21 May 2023 02:40:40 -0700 (PDT) MIME-Version: 1.0 References: <703ec07e-dd2b-bbc6-f1bc-f495e53b764f@gmail.com> In-Reply-To: <703ec07e-dd2b-bbc6-f1bc-f495e53b764f@gmail.com> From: Xavier Leroy Date: Sun, 21 May 2023 11:40:12 +0200 Message-ID: Subject: Re: Manual pages from glibc-doc To: Alex Colomar Cc: GNU Libc Maintainers , lnx-man , glibc , "Carlos O'Donell" Content-Type: multipart/alternative; boundary="00000000000077fe5a05fc30f2b7" X-Spam-Status: No, score=-1.7 required=5.0 tests=BAYES_00,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM,HEADER_FROM_DIFFERENT_DOMAINS,HTML_MESSAGE,KAM_DMARC_STATUS,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_NONE,SPF_PASS,TXREP,T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: --00000000000077fe5a05fc30f2b7 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hello Alex, On Thu, May 18, 2023 at 8:23=E2=80=AFPM Alex Colomar wrote: > Hello Xavier, > > I see there are some manual pages in the glibc-doc package. > Most of glibc's manual pages are part of the Linux man-pages > project. I would be interested in absorbing the ones present > in the glibc-doc package into the Linux man-pages project. > > That would probably remove whatever overhead there is in > maintaining a separate package just for a few manual pages. > > Would you like that? > Well, I wrote those man pages a long time ago, in the late 1990's, to document the first version of the LinuxThreads library. The LinuxThreads code was later completely rewritten by Drepper and Molnar at Redhat (for the better!), so I forgot about the man pages, and did not know they were still distributed as part of the glibc-doc package. I hope the pages have been maintained and updated by the Glibc team, because the first version that I wrote was fairly specific to the LinuxThreads v1 implementation and its limitations, and is probably useless today. Likewise, the POSIX Threads standard changed quite a bit in the last 25 years, with new functions that are implemented in Glibc but lack a man page in glibc-doc. To answer your question: - I don't think it's a good idea to take these man pages "as is" and drop them in the man-pages project, because they are probably obsolete and incomplete. - However, if you or others would like to use these man pages as a starting point for a comprehensive, up-to-date and maintained documentation for POSIX Threads functions in Linux, you're most welcome. - In both cases, I'd like my name and e-mail address to be removed from the man pages, as I no longer support them. Kind regards, - Xavier Leroy > > Cheers, > Alex > > -- > > GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5 > --00000000000077fe5a05fc30f2b7--