From nobody Tue May 19 00:36:54 2026 X-Original-To: dev-commits-src-main@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 4gKG2v5phwz6d7Cf for ; Tue, 19 May 2026 00:37:11 +0000 (UTC) (envelope-from carpeddiem@gmail.com) Received: from mail-lj1-f169.google.com (mail-lj1-f169.google.com [209.85.208.169]) (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 4gKG2v1dVkz49lV 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-f169.google.com with SMTP id 38308e7fff4ca-39389398838so30758521fa.3 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=U4XGnHRuh4xDLrDttr2T2OlTnpLOug46in/j3NsNgKfKzCaLtLGdJ4IIodIY8T3BSz SCaueBAJJ+fVt3kCFVHq42qczb/z12Dn6c+yYZb5W8zfFYXrWzegtzN3fT8ZEbbFwJHD IQNpy8FhD7Q8KguCkgPAoxsbuo/q6iCe+COsMTeBBkilPaRQ+qjMqIMD8/XeoVg4//wn 0rUgIS9QWfU0wsGRLhmdLvwOQk/sLSk2g0TY71aRms2YVAdEygCDE9pJdGpSswSA1UEZ qbT2j7VbiaFgEmI/LmQcjfHP50yp9UAS1GLiMSdkZfxlJOmZdyn4br+x0bpk9oWtHVJK LpcQ== 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=5HRH7n9ZyKB5e60B7b8VePVwoSLQ6Mt8+3r3EnSUN7A=; b=N2NzNpGfZDEvl1pKZuedjUPYCz/fS8+xHwklwC8GraV67uGeo40dmTnBUmdcCoqhHB /riEJn56nKhA9761z2NJij5OftmAK1mNY+ajgidznetP5RxsVBntZSTbjPLQHMVfp7k8 XK+WrPEQRZZlpOVWpVf8aAZepV7Vk1BGb1AhjgNgbY3n7lby3CrLlyBE+jLHfV4ZTOvW bkWmwCgyI6Wlt7dw5wb7LRNZ38tgI1tS9rjd/OT9OvoAy5tF6CoSE8L41OcppK4IY5vw ejUBYozRfi8pTgIKvMSlRwXWcLxRb4npxIZZAxSTe4b5WyE+LmAa4D6RYrMf24r0XEmZ QSDQ==; 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=ebJWO6U3290gA1CZyzO9ymLTvjreBWJ8VXRTwXJ/s9hYJv2FqTN9NsxDFb0lOUHYvo hyY5tLRMoOhiy5IheFYU3i8F261pm1IG2MKJRgxsgH59K1tt5WOOIVx+O1eMVttTqSMy /sBSkzet2rdmjRhS7jn1IIWupm6aGJq1KulFIbotFPZxyqfWnDVllRLj9iRa1shadUeM 8OdlmbQABb3fRiy8sgeRPGvPANWCh4TnDHKhK7HnBof1nHDcE/0o3JSOXsKaAkGstjxl K08PS8S+GlLRSn7nGMiRbsd6+W679BOM+UnIw5OqLOaUmh9RDm5S/soGkirxiFeN7fmD BpPg== X-Forwarded-Encrypted: i=1; AFNElJ+/ZcImgeomU524bNPZGLEMrnXqJIm1dHo/ngRCTebOuMx4eSyQ0Nh71eN4yG0bnyt7VmpbwYeiFOPchQJFdcr448P9RQ==@freebsd.org X-Gm-Message-State: AOJu0Yx/FbrVeZ6DoSFW/IUcjR75KHIhYN+zMgANXBf1ikzEmNvVQrQm NsHzwueF29knbuM+t3JTrYwRj/EWUyn6AM7EEmQJTQ+tE+JpURZVtlpPvpqodjdSjHARLVyYkd1 3iBup08QFFteA/AfJ3coWvJzIlfZjrG8= X-Gm-Gg: Acq92OH0jBYkGl+Pfa05X02M9iG4cGvCWvoghoXEkfqPLTBC1FLA3l4jVRbUqEMS8yC xXT9Ap4sWnoxo1m+KbXc31QStr7R2KjcW/ZltVoAKm5blaomX4bhj+3QHx93NSD3qy9IrFdY5/A feWvm1FAita2+DqM8FzfGuqrGSTWikyLMcG3whgAsd15wtOSp/mD+tjQ2iQCX2THNJQtvO8uBCC wC9rLbvSbhq14eqdgiBrG8z4GjEsbdq1A4SJGqT1FbtdeFE2alJtkMCIwm6UvNXWqqcVuuJZNEs RCyoJQNlKK4OmOiN4pnXIi5nU6gJwP1nS/X0iBI= 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 the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@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: 4gKG2v1dVkz49lV 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.