From nobody Tue May 19 00:36:54 2026 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4gKG2v30bRz6d6yV for ; Tue, 19 May 2026 00:37:11 +0000 (UTC) (envelope-from carpeddiem@gmail.com) Received: from mail-lj1-f181.google.com (mail-lj1-f181.google.com [209.85.208.181]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "WR4" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4gKG2v14BKz4B6y for ; Tue, 19 May 2026 00:37:11 +0000 (UTC) (envelope-from carpeddiem@gmail.com) Authentication-Results: mx1.freebsd.org; none Received: by mail-lj1-f181.google.com with SMTP id 38308e7fff4ca-38e7d983f91so31908141fa.2 for ; Mon, 18 May 2026 17:37:11 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1779151029; cv=none; d=google.com; s=arc-20240605; b=jLozW3nj5l3WOpalPSZIzwcdTZckE7TGHAGiZPyPrNI/r7hOsETlIQVi1n6mSzGEA3 NbUiAgIONnnhCp2gWWWE44RzG9bPBzehwL+1s1Ez6nnWelvUmmfg2DlzL0ehu7LBRabr ucfSlgjfLSLnorq+BlGxntwhAPjMwjRs5E9k4M15DAsbzcn1RNfSLi7VmSqWBJ4oTbNp Tjz7H3xshq3yn62VlPHwCuC8bw6+ha6sE0T8xW7LIBwGT/JA+izA5fFJIT56BvgoiNsS 9iQQXVaJnlh889rv0/7n96Gp5ii6iuGPNL8hCIzfn3iFsiyvdIvmIPIx6SXRWl69kUBM qbtg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version; bh=XKlU2k2iRK9OkHv6PKrHFebJYEJjE8fzH8+eUKnprHM=; fh=BzpZJxr1QGMSTxX/0dNtvXRFYXmOCOFSxkEt/xud+Yo=; b=Lr3ynucCkbiK9bl/9Ud6VUQx9TlmGC0skb/8EtFb7JDeOADVodCkvBP+fxOt/crCCM sGz6eRQv1Y1uzaHYJjmUS4dXSYU/a7tEnc5ILW2yt7vQYngz/pBTBSaofJnDneakuplo ExB5BsUgEQRL5hqy7zWFp/DhLNvobzf/WjnKYDeN1N5IZal2yeAoVBpnqhXfbSDdQjBo 4Q0Zd3j25S+DUx/lKSrY6ayxQZhzIThYU2uu+u+F4aC5xkN7xF527Q2I8123cb8uKgTZ THj71WdfMJiDe0c0afUQV2Qub4lk6ztMSDYjPUeTDssgCBgXd2m3A3/myrNBOckkSuSW wqjg==; darn=freebsd.org ARC-Authentication-Results: i=1; mx.google.com; arc=none X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1779151029; x=1779755829; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=XKlU2k2iRK9OkHv6PKrHFebJYEJjE8fzH8+eUKnprHM=; b=I+wC5eYAkUi5S2h0wvm3+cLgi2bZZJ3YviVBPZkoE2FrGTll4Uf3Yqo7xLAQskAcPj Qfsnbrw4DAoIEpPjdXLAJxu4Z5rOaK3d2GzIcL7vsBeW1duOjrF5tYq7pg4rnzbr/WHn z/nkiy6mvQreyU2KKbqKLb+txrO7L4XiBgBftAFbM9zAs7zUEOec8mNHuEtrbIBGLik/ muap9MuaeDdrRcDkiOxX9+xoc0FsktfMXR5NPL0J22/2g+qjstEY/CCkXX53Q13rc3/O 8U39hZ6r01bJ6RaA6BkudUac47hnvdxEFX1rOvVqgk+zOOdQ+yvgZ6S1/uuNbiDoEXZn +D2g== X-Forwarded-Encrypted: i=1; AFNElJ/IocxwB8Nv9YLO75OKJGlcPsTHLZs+6tvuQwW5Jo4yx0rQLUfJk9Ur2Iq3muRjQTxT/0a+szXRd35tY8Uc+iDivO46@freebsd.org X-Gm-Message-State: AOJu0Ywt5ypLnqkW9EI4iQJS/NKkrAWStDINGoArbT73wXHg/eVBmqyt lg3nG+T3l4vhoqwMEY9B02ZBlJtPhJJXSrUzQ9PtQmHzYOdyi49q6CT+99nex4VIkC+VLxaYJkh Njbg32oyocth058HB411I/NkDaJvvI2A= X-Gm-Gg: Acq92OENpBWP38UupXvlUW2y0UDKLAUJ30va2WYhgB9OGGfJLny+KviybMBAQjRWLDR K3DjjqfGp1pDoVbdHrqHNt5l16e94pinBTvrvYFt1DnP590gUM8g9aMeTauuvr3O3SNDSKK/udN VMrxZH/cemmPZZKKCHcHOew/sZ8qn149+9lL1q3PU1Vw2HB9RrLu1MShaSAXWUAxp74kU/pzZYM ZagtOR3I5cr8r6I056V80NCNPM/MiHimXhTn80pytz2zXYVzVEU6kk64f+hTK4V1QVsIWdelNHi 0u0YKIv3FBl3k70alFVN0D0LVQyoHgw2eWKkZHg= X-Received: by 2002:a2e:a584:0:b0:393:e571:276c with SMTP id 38308e7fff4ca-39561c04d5fmr54231401fa.5.1779151028968; Mon, 18 May 2026 17:37:08 -0700 (PDT) List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 References: <6a0b286c.40371.a734374@gitrepo.freebsd.org> In-Reply-To: From: Ed Maste Date: Mon, 18 May 2026 20:36:54 -0400 X-Gm-Features: AVHnY4Js7KNWksmP4wyYhhPh-c1mj9On36wFc4POetHLoOkirfXliFdEDp4upuQ Message-ID: Subject: Re: git: 876a17321c89 - main - nlist.3: Replace a.out(5) Xref with elf(5) To: Brooks Davis Cc: src-committers@freebsd.org, dev-commits-src-all@freebsd.org, dev-commits-src-main@freebsd.org Content-Type: text/plain; charset="UTF-8" X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; ASN(0.00)[asn:15169, ipnet:209.85.128.0/17, country:US] X-Rspamd-Queue-Id: 4gKG2v14BKz4B6y X-Spamd-Bar: ---- X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated On Mon, 18 May 2026 at 15:06, Brooks Davis wrote: > > On Mon, May 18, 2026 at 02:55:40PM +0000, Ed Maste wrote: > > The branch main has been updated by emaste: > > > > URL: https://cgit.FreeBSD.org/src/commit/?id=876a17321c896427d70de94101df4d888a19189b > > > > commit 876a17321c896427d70de94101df4d888a19189b > > Author: Ed Maste > > AuthorDate: 2026-05-18 14:50:22 +0000 > > Commit: Ed Maste > > CommitDate: 2026-05-18 14:55:32 +0000 > > > > nlist.3: Replace a.out(5) Xref with elf(5) > > > > ELF support was added to nlist() in 1997, and a.out support was removed > > in 2020. The man page was not updated for either of these changes. > > I'm not sure this is quite the right change. struct nlist is documented in > a.out(5) not elf(5). It's also documented in stab(5) so it might be > that is a better reference. Ultimately, we might want to embed > documentation of the relevant parts of struct nlist in nlist(3). stab(5) seems like a suitable reference, yeah. I've added that now. While we could copy the `struct nlist` definition into nlist I think the stab(5) Xr might give a bit more of a clue about why struct fields are as they are. > There's a whole cluster of excedingly obsolete manpages in this area > including, for example, link(5) which seems to have not had a technical > content change since 1995. Oh, indeed. Looking now I see over 250 man pages with a .Dd still in the 1900s. About 50 of those are in lib/libc, 90 in share/man. Those may be good lists to start from.