From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-lj1-f171.google.com (mail-lj1-f171.google.com [209.85.208.171]) by sourceware.org (Postfix) with ESMTPS id AC3203858D20 for ; Sun, 21 May 2023 17:29:49 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org AC3203858D20 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-lj1-f171.google.com with SMTP id 38308e7fff4ca-2af2c35fb85so18313111fa.3 for ; Sun, 21 May 2023 10:29:49 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1684690188; x=1687282188; 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=2nKJYJFXRPYgCmlxF/iJR9H+K/lyYFHh7QzVktwanrA=; b=BT8fCytbgIVsRX9FwkM/oDDc7dcKkCrkFmdLwnDqaejCM44RDLKHiayaewKU4qNLEL hFYUE6AwH1liCI6dZ3oRn3Te8ipoBABzIMhSRPVyzL0adC/Wey5H/hHd5xjfmtU8bk9P 9t6C/3bOGhV4P6MUzS0J/nx7lXzU1rL51M2QLqAG1Wig5uKHg+lQJooYZwQfbHzjiX6E ibDsSX+t9BGew5/SUSJRPwjLTEp1fIurQr5yFw5c6o2ovB/gFSKxkfhqllEk7NdOL984 XuXWVj4pAgCygRmeHylGHjdsijecIAnUYZW/6H9yFIf9AYdJlHmnKY0ZW7xQJPM9WdB7 edjA== X-Gm-Message-State: AC+VfDzSWT9uK57JWw117DNI60XAmizuC1/dMcvQxHYzzKVK6+BadhB3 7qoln+wnhnB7/Z94uKo2cEqGh0IhFMinQFfiNVo= X-Google-Smtp-Source: ACHHUZ4LGLTlwWlrLWU5yCZnRbQBLL1cIg8IsWAo5zFU1S9hjmv8PSAAMvKHwgzJ6lRsqo8cSHOUA8dY0B2RbqIufAI= X-Received: by 2002:a2e:80d7:0:b0:2a8:dce8:2d13 with SMTP id r23-20020a2e80d7000000b002a8dce82d13mr3217430ljg.14.1684690187828; Sun, 21 May 2023 10:29:47 -0700 (PDT) MIME-Version: 1.0 References: <703ec07e-dd2b-bbc6-f1bc-f495e53b764f@gmail.com> <93aba0c9-ad1d-d488-1471-be30b7a8bb0c@gmail.com> In-Reply-To: <93aba0c9-ad1d-d488-1471-be30b7a8bb0c@gmail.com> From: Xavier Leroy Date: Sun, 21 May 2023 19:29:19 +0200 Message-ID: Subject: Re: Manual pages from glibc-doc To: Alejandro Colomar Cc: GNU Libc Maintainers , lnx-man , glibc , "Carlos O'Donell" Content-Type: multipart/alternative; boundary="00000000000033c41a05fc37803f" X-Spam-Status: No, score=-1.8 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: --00000000000033c41a05fc37803f Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Sun, May 21, 2023 at 12:25=E2=80=AFPM Alejandro Colomar wrote: > Hi Xavier, > > On 5/21/23 11:40, Xavier Leroy wrote: > > 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 LinuxThrea= ds > > 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 we= re > > 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. > > Thanks for the history. I've investigated a bit after your email. > Thanks for the historian's work ! > It seems that the pages were removed from glibc upstream in 2005 [1], > This is consistent with the development of NPTL, the LinuxTheads replacement, at RedHat in 2004-2005. Once NPTL was ready for inclusion in Glibc, it made sense to remove the LinuxThread man pages. > and then imported in the Debian glibc source package later in 2013 [2]. > I didn't know about that. Strange move from the Debian maintainers. The last time a page's text was updated seems from 2002 by Drepper. > OK, this confirms that the text is probably outdated. > > > > > To answer your question: > > - I don't think it's a good idea to take these man pages "as is" and dr= op > > 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. > > Yes, I plan to import these pages, specifying the historic details > found in this thread, keeping your name in the import commit, if you > don't mind, and then remove your name in the first commit, and start > cleaning them up. I'd compare them to the POSIX pages, to see if > there's any obviously outdated stuff, and fix it. Small details > that are not obvious from reading POSIX, I guess time will fix them. > > So, you want your name removed. Any other request? The pages don't > seem to have a license. Should GPL be applied to them as they were > once part of glibc? If so, is GPL-3.0-or-later a good one? Or > should I relicense as Linux-man-pages-copyleft? > I'm happy with the man-pages-copyleft license. If you need me to write a more formal message for the licensing of these pages, let me know. No other requests than 1- removing my name, and 2- updating the pages as much as you and others can. > Does the above plan look good to you? > > Yes ! Thank you for proposing it. Kind regards, - Xavier Leroy > Cheers, > Alex > > > > > Kind regards, > > > > - Xavier Leroy > > > > > > > > > > > > > >> > >> Cheers, > >> Alex > >> > >> -- > >> > >> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5 > >> > > > > [1]: > > alx@debian:~/src/gnu/glibc/glibc$ git lg --stat -- > 'linuxthreads/man/pthread*'; > * 88e3fbcb5d N - Sun, 3 Jul 2005 04:40:34 +0000 (18 years ago) > | linuxthreads, linuxthreads_db: Directories removed (preserved > in ports repository). - Roland McGrath| > | linuxthreads/man/pthread_atfork.man | 53 ----- > | linuxthreads/man/pthread_attr_init.man | 221 > ------------------ > | linuxthreads/man/pthread_cancel.man | 155 ------------- > | linuxthreads/man/pthread_cleanup_push.man | 194 --------------= -- > | linuxthreads/man/pthread_cond_init.man | 234 > -------------------- > | linuxthreads/man/pthread_condattr_init.man | 39 ---- > | linuxthreads/man/pthread_create.man | 46 ---- > | linuxthreads/man/pthread_detach.man | 44 ---- > | linuxthreads/man/pthread_equal.man | 23 -- > | linuxthreads/man/pthread_exit.man | 32 --- > | linuxthreads/man/pthread_join.man | 70 ------ > | linuxthreads/man/pthread_key_create.man | 151 ------------- > | .../man/pthread_kill_other_threads_np.man | 40 ---- > | linuxthreads/man/pthread_mutex_init.man | 213 > ------------------ > | linuxthreads/man/pthread_mutexattr_init.man | 84 ------- > | linuxthreads/man/pthread_mutexattr_setkind_np.man | 39 ---- > | linuxthreads/man/pthread_once.man | 34 --- > | linuxthreads/man/pthread_self.man | 23 -- > | linuxthreads/man/pthread_setschedparam.man | 79 ------- > | linuxthreads/man/pthread_sigmask.man | 123 ---------- > | 20 files changed, 1897 deletions(-) > > * a334319f65 N - Wed, 22 Dec 2004 20:10:10 +0000 (18 years ago) > | (CFLAGS-tst-align.c): Add -mpreferred-stack-boundary=3D4. - > Ulrich Drepper| > | linuxthreads/man/pthread_atfork.man | 53 +++++ > | linuxthreads/man/pthread_attr_init.man | 221 > ++++++++++++++++++ > | linuxthreads/man/pthread_cancel.man | 155 +++++++++++++ > | linuxthreads/man/pthread_cleanup_push.man | 194 ++++++++++++++= ++ > | linuxthreads/man/pthread_cond_init.man | 234 > ++++++++++++++++++++ > | linuxthreads/man/pthread_condattr_init.man | 39 ++++ > | linuxthreads/man/pthread_create.man | 46 ++++ > | linuxthreads/man/pthread_detach.man | 44 ++++ > | linuxthreads/man/pthread_equal.man | 23 ++ > | linuxthreads/man/pthread_exit.man | 32 +++ > | linuxthreads/man/pthread_join.man | 70 ++++++ > | linuxthreads/man/pthread_key_create.man | 151 +++++++++++++ > | .../man/pthread_kill_other_threads_np.man | 40 ++++ > | linuxthreads/man/pthread_mutex_init.man | 213 > ++++++++++++++++++ > | linuxthreads/man/pthread_mutexattr_init.man | 84 +++++++ > | linuxthreads/man/pthread_mutexattr_setkind_np.man | 39 ++++ > | linuxthreads/man/pthread_once.man | 34 +++ > | linuxthreads/man/pthread_self.man | 23 ++ > | linuxthreads/man/pthread_setschedparam.man | 79 +++++++ > | linuxthreads/man/pthread_sigmask.man | 123 ++++++++++ > | 20 files changed, 1897 insertions(+) > > * 0ecb606cb6 N - Thu, 12 Jul 2007 18:26:36 +0000 (16 years ago) > | 2.5-18.1 - Jakub Jelinek| > | linuxthreads/man/pthread_atfork.man | 53 ----- > | linuxthreads/man/pthread_attr_init.man | 221 > ------------------ > | linuxthreads/man/pthread_cancel.man | 155 ------------- > | linuxthreads/man/pthread_cleanup_push.man | 194 --------------= -- > | linuxthreads/man/pthread_cond_init.man | 234 > -------------------- > | linuxthreads/man/pthread_condattr_init.man | 39 ---- > | linuxthreads/man/pthread_create.man | 46 ---- > | linuxthreads/man/pthread_detach.man | 44 ---- > | linuxthreads/man/pthread_equal.man | 23 -- > | linuxthreads/man/pthread_exit.man | 32 --- > | linuxthreads/man/pthread_join.man | 70 ------ > | linuxthreads/man/pthread_key_create.man | 151 ------------- > | .../man/pthread_kill_other_threads_np.man | 40 ---- > | linuxthreads/man/pthread_mutex_init.man | 213 > ------------------ > | linuxthreads/man/pthread_mutexattr_init.man | 84 ------- > | linuxthreads/man/pthread_mutexattr_setkind_np.man | 39 ---- > | linuxthreads/man/pthread_once.man | 34 --- > | linuxthreads/man/pthread_self.man | 23 -- > | linuxthreads/man/pthread_setschedparam.man | 79 ------- > | linuxthreads/man/pthread_sigmask.man | 123 ---------- > | 20 files changed, 1897 deletions(-) > > * 79996eeed1 N - Sun, 28 Jul 2002 19:04:09 +0000 (21 years ago) > | Update. - Ulrich Drepper| > | linuxthreads/man/pthread_mutex_init.man | 2 +- > | 1 file changed, 1 insertion(+), 1 deletion(-) > > * 6736e93bab N - Sat, 6 Apr 2002 01:45:15 +0000 (21 years ago) > | Update. - Ulrich Drepper| > | linuxthreads/man/pthread_mutexattr_init.man | 20 +++++------ > | linuxthreads/man/pthread_mutexattr_setkind_np.man | 39 > +++++++++++++++++++++ > | 2 files changed, 49 insertions(+), 10 deletions(-) > > * 638621aff9 N - Fri, 14 Dec 2001 22:17:03 +0000 (21 years ago) > | Update. - Ulrich Drepper| > | linuxthreads/man/pthread_atfork.man | 13 ++++--------- > | 1 file changed, 4 insertions(+), 9 deletions(-) > > * 0a51738ed9 N - Sun, 23 May 1999 09:27:35 +0000 (24 years ago) > | Correct example. - Ulrich Drepper| > | linuxthreads/man/pthread_cond_init.man | 5 ++--- > | 1 file changed, 2 insertions(+), 3 deletions(-) > > * 5afdca0087 N - Wed, 11 Mar 1998 12:42:25 +0000 (25 years ago) > LinuxThreads library. - Ulrich Drepper > linuxthreads/man/pthread_atfork.man | 58 +++++ > linuxthreads/man/pthread_attr_init.man | 221 > ++++++++++++++++++ > linuxthreads/man/pthread_cancel.man | 155 +++++++++++++ > linuxthreads/man/pthread_cleanup_push.man | 194 ++++++++++++++= ++ > linuxthreads/man/pthread_cond_init.man | 235 > ++++++++++++++++++++ > linuxthreads/man/pthread_condattr_init.man | 39 ++++ > linuxthreads/man/pthread_create.man | 46 ++++ > linuxthreads/man/pthread_detach.man | 44 ++++ > linuxthreads/man/pthread_equal.man | 23 ++ > linuxthreads/man/pthread_exit.man | 32 +++ > linuxthreads/man/pthread_join.man | 70 ++++++ > linuxthreads/man/pthread_key_create.man | 151 +++++++++++++ > .../man/pthread_kill_other_threads_np.man | 40 ++++ > linuxthreads/man/pthread_mutex_init.man | 213 > ++++++++++++++++++ > linuxthreads/man/pthread_mutexattr_init.man | 84 +++++++ > linuxthreads/man/pthread_once.man | 34 +++ > linuxthreads/man/pthread_self.man | 23 ++ > linuxthreads/man/pthread_setschedparam.man | 79 +++++++ > linuxthreads/man/pthread_sigmask.man | 123 ++++++++++ > 19 files changed, 1864 insertions(+) > > > > [2]: > > alx@debian:~/src/debian/glibc$ git lg --stat -- > 'debian/local/manpages/pthread*'; > * 2c35c554 N - Fri, 29 Nov 2013 11:00:45 +0000 (9 years ago) > * Remove linuxthreads from the tarball: - rules.d/ > tarball.mk: don't fetech linuxthreads and linuxthreads_db. - rules.d/ > build.mk: don't build linuxthreads manpages. - rules: don't run make > clean in linuxthreads directory. - patches/any/local-sysctl.diff: drop > the linuxthreads part. - patches/all/local-pthread-manpages.diff: > remove. - local/manpages/pthread_*.3: import the few remaining > linuxthreads manpages. - debhelper.in/glibc-doc.manpages: > update manpage locations. - Aurelien Jarno > debian/local/manpages/pthread_atfork.3 | 53 +++++++ > debian/local/manpages/pthread_cond_init.3 | 229 > ++++++++++++++++++++++++++++++ > debian/local/manpages/pthread_condattr_init.3 | 38 +++++ > debian/local/manpages/pthread_key_create.3 | 151 > ++++++++++++++++++++ > debian/local/manpages/pthread_mutex_init.3 | 209 > +++++++++++++++++++++++++++ > debian/local/manpages/pthread_mutexattr_init.3 | 81 +++++++++++ > debian/local/manpages/pthread_mutexattr_setkind_np.3 | 38 +++++ > debian/local/manpages/pthread_once.3 | 34 +++++ > 8 files changed, 833 insertions(+) > > -- > > GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5 > --00000000000033c41a05fc37803f--