From nobody Mon Sep 11 22:44:47 2023 X-Original-To: doc@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 4Rl1xX2yCNz4sZqX 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 4Rl1xX1Yvdz4Jrp for ; Mon, 11 Sep 2023 22:44:48 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1694472288; a=rsa-sha256; cv=none; b=Re9CN9BJp9tNvoWFXEzeSF2Tvf9WSHCg8BUTE91gzwf44eF0gI1dwgev464PFrr9oT1gR4 2JOrMnTyJdpgOqHTf/+tEupMBZhKF9rn9gmqREEqmeFgrsKSgGAqBdtqDnqJQx/uWRXNKR DP6lGftsytcS9+jTKewFMmJQeVwnmI2SmReiIvmT32WQkgDN0g1GFEzCZ3eOUOPOnG4UP2 a16RDtLH9oc7s7Eu2YLbVfdFms0lPGR7wpHRH+4b/Qo9/lW/NnafCWDJdqZRwNx8VsknFT UEk4fSIwaq47lgCXtn+6bvxGoCWKq9EwWeu5oyFlyzHf+jAhktXKvy0RAnRlXw== 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=1694472288; 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=GoE+lV2Ma/uydP/f5hGmagMFTrwEvAEeLe9IdUPpJAO+al8HVGrLhPtrWhXIZ241yjEIQ6 rgMzc7f5MSgAuJ+fb1Orwy/biBigS5fnznEY0OUz33XqrMkBZ4E4ZmLHKGcibIT8Wu8kf6 q3g+CwTx0lP1ZU4cE0zm7votpsiJhv4EynTn5g2zDJTYMjz1Jt6yEbDlZyb6ejocrXgGZJ K88sGhSYNOu30R/YWHK3HXgvPGMvj6zwj8GxuDTUc/w36vJQJwTfMQQssSFxIENDSwx7+r UU9vEVYat6Rw/4JYP3tpcmbjYMkTF0rRSsl9DRoIAQ9p16w5TkPVb3BdYn72ng== 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 4Rl1xX0f8Zz16h6 for ; Mon, 11 Sep 2023 22:44:48 +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 38BMimMm079760 for ; Mon, 11 Sep 2023 22:44:48 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from bugzilla@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 38BMimEd079759 for doc@FreeBSD.org; Mon, 11 Sep 2023 22:44:48 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: doc@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: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@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.=