From nobody Thu Aug 03 14:08:33 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 4RGrKt2t6bz2tvCm for ; Thu, 3 Aug 2023 14:08:34 +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 4RGrKt0jP9z4G09 for ; Thu, 3 Aug 2023 14:08:34 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1691071714; 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=vBTBI2EcvwhF032YXEtJQF5Evko2HkhnRqMTN5g0214=; b=Z5Q8z6Z/6xDIBu5CJbQrVyaNSHuW/7igxFnR6d3+vxPexw4JliebV+vPJ2S6ZrY7hXNLHR /Gsj+YhPVRpnLVaIWkgodLZNUFICa0gcHOqI7SF9YtDthDBXFdi9DhYudMi2q4Z3W8fp/h g58W6PHZ/wvOLYejIp3NXaDUzN3LAn+HLKsjFMzuD2v231SloLPg1GHtn4bh0pe3I8sGEc eQ8BteZac7mNEIJacuSpIHcSpo+YtwvcCxo7Tt1Q+aeONDSVdygEDp+oqXolcXXmnNtnAL pavP14hTulPCwYaf43TR5fk7uZ6scR5sSN1EA9lcxCr76EFaWMgY34zuUe2KzQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1691071714; a=rsa-sha256; cv=none; b=wfa4cJuu3OHVpCbqvvSQNjX1J6WzhBJFKlw1ovjKGbk8q1iqgF+UF4jzV9GGJnrF40NMU9 elD4iGxdvVhYoIC13qeCJ7IoE2/Ox4C1zlnOpRA6hiSpN6pk5RSO8Dt9j2D6T2Jcd28oNK mhu+jLfvs3xFZB43F1X61z1YhqMKlX2rkRH/0sPGCZCItmSQs95uG97faU7+sPguTE8D3W Tv164ZCFCl4liV2xcJw7isACe51W2UqJZZzCGyuJ6T775QkB9ko/vDjwezORNdGILmrvPr yfvqNAp1/3qt+HZiKkrSB8bmUvsLsLrPr6nofhm1Q9lbLZ17a9zIw/XvJIAnQw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4RGrKs68rPz7wH for ; Thu, 3 Aug 2023 14:08:33 +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 373E8XgW092488 for ; Thu, 3 Aug 2023 14:08:33 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from bugzilla@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 373E8Xrd092487 for arch@FreeBSD.org; Thu, 3 Aug 2023 14:08:33 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: Thu, 03 Aug 2023 14:08:33 +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 #3 from commit-hook@FreeBSD.org --- A commit in branch main references this bug: URL: https://cgit.FreeBSD.org/src/commit/?id=3D84f9f2c5cf7841fffc03ccb1833814892= ae15132 commit 84f9f2c5cf7841fffc03ccb1833814892ae15132 Author: Mitchell Horne AuthorDate: 2023-08-03 13:48:15 +0000 Commit: Mitchell Horne CommitDate: 2023-08-03 14:07:41 +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 share/man/man9/intro.9 | 594 +++++++++++++++++++++++++++++++++++++++++----= ---- 1 file changed, 504 insertions(+), 90 deletions(-) --=20 You are receiving this mail because: You are on the CC list for the bug.=