From nobody Wed Sep 6 19:18:11 2023 X-Original-To: freebsd-arch@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 4Rgsbj4wYWz4s3XG for ; Wed, 6 Sep 2023 19:18:25 +0000 (UTC) (envelope-from yaneurabeya@gmail.com) Received: from mail-pl1-x630.google.com (mail-pl1-x630.google.com [IPv6:2607:f8b0:4864:20::630]) (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 "GTS CA 1D4" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Rgsbj1GkSz3Vfl for ; Wed, 6 Sep 2023 19:18:25 +0000 (UTC) (envelope-from yaneurabeya@gmail.com) Authentication-Results: mx1.freebsd.org; none Received: by mail-pl1-x630.google.com with SMTP id d9443c01a7336-1c1f7f7151fso1233055ad.1 for ; Wed, 06 Sep 2023 12:18:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1694027904; x=1694632704; darn=freebsd.org; h=references:to:cc:in-reply-to:date:subject:mime-version:message-id :from:from:to:cc:subject:date:message-id:reply-to; bh=LjbiNhOgclvhWBw1ynlgTOLoJ4sTG3wuOXaP4wGl11U=; b=NDTkeZyeYwlg7oiGfHkHEI3H/tI10YKZWVPA4E1gRo5Pq9T5+8liWnjjz9vVxm15WQ q3kVmmDnyvYR2Z0WZ/9cQskN4JYxlL2XYSsKs2DihGRmtwidEL7W11BXCk6rn3oZ8H5g hefnkf3lmBzq9gknDT6PXXx2Lh+8TgfB9Vq/Zh8zEgLOOGXFFDnFwPQxSUGoSoQgQXvl wqvwSLRghQNZ9d+ulnA0xtYC0slIc2ZlyJk5Mg5BQKsXuQRmU59ZqBnMxJVNVNjU1dcc ZGMX/VDsBdnXk/4amec4CY7MDskqRsUD2lwfEXYrNhR3YDyR9ct1IJqUxFJuNLGfj0PC SbdQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1694027904; x=1694632704; h=references:to:cc:in-reply-to:date:subject:mime-version:message-id :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=LjbiNhOgclvhWBw1ynlgTOLoJ4sTG3wuOXaP4wGl11U=; b=Y590228RMhiZlue+6ofHuPUlOsRyn/P4qVDdhCc4sxiBv2c8QV6FzEiX2z450YFjTq omvMgbVMXSnljmnJWILbR/d2EcqjLJS91PDnF2SmrPx4TBRonWjBOIajDoceOdN8BtPl +6Eo+Zf/ApwTYd39o8B1U55xDnewfCqRk/6Z/QtwN/VHYgEtllO7pGxhX106Wbv0YM2s vd7WHdoiAn1VpepNl6LcXIhP5xeiJAZZK5gvhsqY6HgNWBBWY/So2P0RiLUJwsL00ET/ jLrXlAVHRIOXFATa3FB895OtmQibxSkR+pSJpkAm2QFTrrdD4ko4HMIk4pOosv699FZe JzHw== X-Gm-Message-State: AOJu0YzmwtlUdqVJUxWLnJ8jPIg/GlFTsXXhODaS+zBJERBwWtlRaww2 0MnS3w0xwlST6NfI/2LLVWk9hcDxlXU= X-Google-Smtp-Source: AGHT+IEKMa4F9Da/d9nRRC8dZJ/gv83H0Z5zt0JZPBbmjV+OcWRNy4s+Sq8tXxPTLIEWnkBa5ZKgCA== X-Received: by 2002:a17:902:7002:b0:1bd:f1a7:8293 with SMTP id y2-20020a170902700200b001bdf1a78293mr13154721plk.69.1694027903609; Wed, 06 Sep 2023 12:18:23 -0700 (PDT) Received: from smtpclient.apple (c-73-19-52-228.hsd1.wa.comcast.net. [73.19.52.228]) by smtp.gmail.com with ESMTPSA id b14-20020a170903228e00b001bdb8f757besm11459828plh.23.2023.09.06.12.18.22 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 06 Sep 2023 12:18:23 -0700 (PDT) From: Enji Cooper Message-Id: <5263B61F-48AD-4F0F-87EF-6382A4C0664C@gmail.com> Content-Type: multipart/signed; boundary="Apple-Mail=_2410299C-4040-4ACF-851E-26C62CFFC843"; protocol="application/pgp-signature"; micalg=pgp-sha256 List-Id: Discussion related to FreeBSD architecture List-Archive: https://lists.freebsd.org/archives/freebsd-arch List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-arch@freebsd.org Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3731.700.6\)) Subject: Re: Last bits of SCCS, RCS, CVS and Subversion IDs Date: Wed, 6 Sep 2023 12:18:11 -0700 In-Reply-To: Cc: Steve Kargl , Cy Schubert , "freebsd-arch@freebsd.org" To: Warner Losh References: <20230905160359.51C07C0@slippy.cwsent.com> X-Mailer: Apple Mail (2.3731.700.6) X-Spamd-Bar: ---- X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; ASN(0.00)[asn:15169, ipnet:2607:f8b0::/32, country:US] X-Rspamd-Queue-Id: 4Rgsbj1GkSz3Vfl --Apple-Mail=_2410299C-4040-4ACF-851E-26C62CFFC843 Content-Type: multipart/alternative; boundary="Apple-Mail=_269EB318-154C-49C2-8AC3-90F5E566CECF" --Apple-Mail=_269EB318-154C-49C2-8AC3-90F5E566CECF Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 > On Sep 6, 2023, at 10:52 AM, Warner Losh wrote: >=20 > On Tue, Sep 5, 2023 at 12:18=E2=80=AFPM Steve Kargl = > wrote: >> On Tue, Sep 05, 2023 at 11:47:05AM -0600, Warner Losh wrote: >> > >> > The reset of that thought is that the other remaining SVN / CVS / = RCS / >> > SCCS tags are from projects that no longer really have an upstream. >> > They are defunkt now for many years (decades in all cases I'm = familiar >> > with, but I've not done a full audit to say that with certainty). = They >> > also date from a time where marking of sources and binaries was = fundamentally >> > different, and did things that we no longer do and are out of step. = So >> > there's no benefit to retaining it and some desire, at least to = modernize. >> > >>=20 >> Warner, >>=20 >> As part of the purge of the ids, are you planning to remove ident(1)? >=20 > I was not. I have no opinion as to whether or not it should remain. ident still has some value with older versions of FreeBSD (I=E2=80=99ve = used it before to get kernel versions/revisions) or making it into an = optional build tool, but making it optional seems ok to me at least. Thanks, -Enji --Apple-Mail=_269EB318-154C-49C2-8AC3-90F5E566CECF Content-Transfer-Encoding: quoted-printable Content-Type: text/html; charset=utf-8
On Sep 6, = 2023, at 10:52 AM, Warner Losh <imp@bsdimp.com> = wrote:

On Tue, = Sep 5, 2023 at 12:18=E2=80=AFPM Steve Kargl <sgk@troutmask.apl.washing= ton.edu> wrote:
On Tue, Sep 05, 2023 at 11:47:05AM -0600, Warner = Losh wrote:
> 
> The reset of that = thought is that the other remaining SVN / CVS / RCS /
> SCCS tags = are from projects that no longer really have an upstream.
> They = are defunkt now for many years (decades in all cases I'm = familiar
> with, but I've not done a full audit to say that with = certainty). They
> also date from a time where marking of sources = and binaries was fundamentally
> different, and did things that we = no longer do and are out of step. So
> there's no benefit to = retaining it and some desire, at least to modernize.
> 

Warner,

As = part of the purge of the ids, are you planning to remove = ident(1)?

I was not. I have no = opinion as to whether or not it should = remain.

ident still has = some value with older versions of FreeBSD (I=E2=80=99ve used it before = to get kernel versions/revisions) or making it into an optional build = tool, but making it optional seems ok to me at = least.
Thanks,
-Enji

= --Apple-Mail=_269EB318-154C-49C2-8AC3-90F5E566CECF-- --Apple-Mail=_2410299C-4040-4ACF-851E-26C62CFFC843 Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename=signature.asc Content-Type: application/pgp-signature; name=signature.asc Content-Description: Message signed with OpenPGP -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEtvtxN6kOllEF3nmX5JFNMZeDGN4FAmT40HMACgkQ5JFNMZeD GN7VSw/+Kei2X0BIdJjQLIyOv5YXs9h+8aCYoDViwjTOmfqw+AkjmROVUqB7yjm7 AAICW53Cg4dK3wXAz8Xc4ltaIL/mOoNdFtLgME3HUTn8IErbxSx2Zd6OT1Q4sxlg 06nDBAMprxdGGVc80xDGSiARhGT2lc84gOwza42zQXE5WV15oIBJ7WE4r72bqI/n KvZZsuX5OqEqTnY8EsyXAPzvZxaOVuqry9VpLhidG8+m84TiKAxzTeL4BL1DUMAU b/4ABjFIqsBbGHqHVdEx5+F5Tec94+WY/ObHrjcsXEdxLsPichuM9DfZFrQ3XhXk UByfCsI1ToR/J6oMwR8dhGwy67brSvZQ5i4/BY7T0DOZjAtXP6pcJ9b0309gn4k4 uqQHXtVbrWm2xZ9pqEg+h859M89dAOTR2M0Y8mXuRClZA/duJ3JNXU30mHYcFnXW p4jauvhnk5+mkYcr29fMnXj1utWhmkJi1mbaWgZRbE/CXLiw9SzO1EHK8pGCJhYy jqlwNjv3ppEPjH02MsPHQB2qUP3/D3rHhhz/9zur5GyEFOSMjaBWTVIiEIjfGLQ8 aaNsiPIdLlvbcac9JPQIOIFbRZR0oPS0GPAnRYYZ4XgbeK3DdMq93FxloVb+sXt7 vWsqYMOOAYlUsVLRkJwhz2vtEeM1arF6MpO1LaT7wc9ryJzlltE= =2yA1 -----END PGP SIGNATURE----- --Apple-Mail=_2410299C-4040-4ACF-851E-26C62CFFC843-- From nobody Mon Sep 11 22:44:47 2023 X-Original-To: arch@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 4Rl1xX0C50z4sZw1 for ; Mon, 11 Sep 2023 22:44:48 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Rl1xW6H0xz4JpB for ; Mon, 11 Sep 2023 22:44:47 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1694472287; a=rsa-sha256; cv=none; b=UrgpQ/+O0JZsTz+So66zFz+gSPfDDj5py9ZBcZlNWeR/4wtaYFvDmnNr1fAVRURLTqGZ+N 8bHksCRDeqBbhI+LpWpSP5RM20YBlF1SXfAzlzF4EA/stdnBH+Ek24XoRIRtEurPgaLNl7 MX3AyPk5fe39Fjka9Ej+DR1n9S7fHeemwMKHsPwQDnij6u5nBlmod8ZSbEVHDFwLGlmMmH OGTLJi8Q3xB7c74pGRz2rQIfvF8krKRygDF3R83FgaIQoXOLZ2tIuelcSmgBxgyRMurvaj Gy+FAgJlCoEsXuuPDui3EK4sdrN4b97ayJBCZZ03ZmyPGKLpWK6jpshy5ATUMQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1694472287; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=W7DmtRdZAL7x92zNDE6yHu6B19MkyNVJqjUJs8OBKes=; b=fmT5j0mQvykvklN5vr2gXnA7FKvM9IQKko5uhs1coUVA+/RzvevYX71a+G+2c9E2Y0t6M2 7T29Zw9BJxJqiaZOmgEXD7hJUZ0N59QZsOOLK98Z9lvdDem5oDqaJ9fBKkwGKqh1LMXU+k 3hlLM8isM3dSSFDqoflAeYh+jKFH3E6p1bpq03kzp4jXXneNPxZYiolgzs0+Sg0vWGvTM0 tCkL28DtTkUzq/WQckY3S/KR3Y9O7B5DmYiG3C85QWawOImethIo4JyapvJw6yApiKnH7i 8otVIqy9SZ/tztiktRiB9NwHaW9+tX6MEqFRAUkopKKczPZHE1h3y5zu638ALw== Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Rl1xW5G23z171Q for ; Mon, 11 Sep 2023 22:44:47 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 38BMilng079743 for ; Mon, 11 Sep 2023 22:44:47 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from bugzilla@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 38BMilHP079742 for arch@FreeBSD.org; Mon, 11 Sep 2023 22:44:47 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: bugzilla set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: arch@FreeBSD.org Subject: [Bug 270481] intro(9) needs an update/rewrite Date: Mon, 11 Sep 2023 22:44:47 +0000 X-Bugzilla-Reason: CC X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Manual Pages X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Only Me X-Bugzilla-Who: commit-hook@FreeBSD.org X-Bugzilla-Status: In Progress X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: mhorne@freebsd.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Discussion related to FreeBSD architecture List-Archive: https://lists.freebsd.org/archives/freebsd-arch List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-arch@freebsd.org MIME-Version: 1.0 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D270481 --- Comment #5 from commit-hook@FreeBSD.org --- A commit in branch stable/13 references this bug: URL: https://cgit.FreeBSD.org/src/commit/?id=3D5a0c410787b8b2f92a0c3f6126c95ffe3= 4de344c commit 5a0c410787b8b2f92a0c3f6126c95ffe34de344c Author: Mitchell Horne AuthorDate: 2023-08-03 13:48:15 +0000 Commit: Mitchell Horne CommitDate: 2023-09-11 22:42:15 +0000 intro(9): rewrite from scratch This page has existed as a placeholder since its creation in 1995. It does not provide a useful introduction to the content in this section. Reimagine it as a top-level overview page containing brief descriptions and links to existing pages in section 9. It is roughly organized into sub-sections, grouped by topic or subsystem. In other words, the page is meant to function as a map to other content. There is a balance to be found here between providing as many links as possible and keeping the page concise and searchable. In general the aim is to reference pages which provide the best entry point to a particular topic. For example, a link is given to locking(9), but not to the specific lock pages such as mutex(9) or rwlock(9). NetBSD has done something similar with their intro(9), so some inspiration has been taken from there, although their content doesn't align that closely with what we have. I have done a thorough review of our existing pages and formed these subsections around them, but they are meant to evolve. PR: 270481 Reviewed by: imp, emaste MFC after: 3 weeks Relnotes: yes Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D41104 (cherry picked from commit 84f9f2c5cf7841fffc03ccb1833814892ae15132) share/man/man9/intro.9 | 594 +++++++++++++++++++++++++++++++++++++++++----= ---- 1 file changed, 505 insertions(+), 89 deletions(-) --=20 You are receiving this mail because: You are on the CC list for the bug.=