From nobody Sun Dec 31 10:58:07 2023 X-Original-To: freebsd-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 4T2x0x6xBZz55TnL for ; Sun, 31 Dec 2023 10:58:09 +0000 (UTC) (envelope-from kolusion@post.com) Received: from mout.gmx.com (mout.gmx.com [74.208.4.201]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "mout.gmx.com", Issuer "GeoTrust TLS RSA CA G1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4T2x0w5hrYz3Skj for ; Sun, 31 Dec 2023 10:58:08 +0000 (UTC) (envelope-from kolusion@post.com) Authentication-Results: mx1.freebsd.org; dkim=pass header.d=post.com header.s=s1089575 header.b=SaxGcM5e; spf=pass (mx1.freebsd.org: domain of kolusion@post.com designates 74.208.4.201 as permitted sender) smtp.mailfrom=kolusion@post.com; dmarc=pass (policy=none) header.from=post.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=post.com; s=s1089575; t=1704020287; x=1704625087; i=kolusion@post.com; bh=OMjD/JMBX9pQl6Wub0R5uqEC9gkgdGOEa4SVU8twTdg=; h=X-UI-Sender-Class:From:To:Subject:Date; b=SaxGcM5eMdI5Vd7G+eqIXyfUQFMXuipvJGpP4ctPTyvsM7F//F2bOCghksd2l+Vf vwWTzWOO/MmBKw0pdpOSWJ+iLhR97iQPpGKsjJ2YzW5OGKT3Kb5yKs6gpXO1MPJjf 5UMFUO9n5CyJYMdrjx6BeSBepknkGeZBGuoqtcGGIOVPI/ixcfcuU1rAsDlrKkIsD FP1mcN82KEYx+2xBA3iWHmjh//sHvxJM96+CvH9WcUzphXQL7VjKMCATnlOfGD3JR nrwbnMe8f+pdyMWK//QxoRXdRNC0kR3FCzw0LnEfny6DRQqdi6dvrkCa5Pr+Xv08g hY6XDAGtkCeD1U2PFA== X-UI-Sender-Class: f2cb72be-343f-493d-8ec3-b1efb8d6185a Received: from [10.237.67.2] ([10.237.67.2]) by msvc-mesg-gmxus002.server.lan (via HTTP); Sun, 31 Dec 2023 11:58:07 +0100 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 Message-ID: From: Kolusion K To: freebsd-doc@FreeBSD.org Subject: Suggestions to improve the FreeBSD Handbook Content-Type: text/plain; charset=UTF-8 Importance: normal Sensitivity: Normal Date: Sun, 31 Dec 2023 11:58:07 +0100 X-Priority: 3 X-Provags-ID: V03:K1:bRfuT84IIcYsQf2Ksb+rgajIYZ5Ljk+cd99xbtnkXS4RrbsksD/K2/lZAIA/1TX+qjB2z LQExTiKa+IsFTevwcFSJgmpy9fBde3C/GCJv8Ak9KgJroAG/TrI/ucMUlF46dOaXt5OLjkPLYbzb UrLH1nP78z3Jo1v5wJuK1yvhFYTkkXCaaKb7SGRWBxQuYr13sGzZVvw37AZad57urJWWvbzowoYH TFEtITbcdtScrWtPimKwJ6a6YHrvq/aEQNgPL3wyiU3eYZdSMvHo6txjmVyzFA1+ubagWjAnLd4S iI= X-Spam-Flag: NO UI-OutboundReport: notjunk:1;M01:P0:8mK1re+Rdy8=;qSgE73CTt/ErvWZKYwUbIilxeyp +L0KSVENc1WzIP1u2cyyyRxDzDoi6IhZ7OmSK2QlrsdpCgeU+0T3LwskcB7CMDQNTS55kxzNU s11w4zphl0tpNzdumLOGtgLwM4uxOmvJgoH1vgqQdItQhYnv9MIjrM/I3mWi2HcXru44zGSPE rskijtjheu92MflHZhOH9Uw07NeSTsVydX5AidHGdajHHBGoMb7u5KjCxcpNa00qnsJ8MefAx 5yZKmZJbrsGPMvJJmXuLPG349k7x+HX+rLMnwVL3Jww9IfHAz8QR18ZCzmW9tV1CLhpAs+qXh 1UEDLHFlO8StFVHAuKrPaybW551E5qXPkitOIKjerdSEKWK7PsySGsSJxG9nVsakzNow+pdKB RCw2HM8e4vmsgVfWXwISiXJO/pdYUwyCB+hgjvGsdhPSYrRvqtCZV1KwimkR5+WAbiUsi/pmV RlKz0p1BJzfGo7oW6eMqCWOSwDclDCmNNXorWupZ47j9Tyw2FSg5rDfSlQgaPxw/q4iynrvSJ pSYSNbA95qejJkWLsBGRctrErSosgM6XCMa2BcFhOYojA3Fknfyztyzlr1ZkCRmN2rFoN8MtB P8WjAqcjBlJ3bvgG+egap/CCK3B2oMAjV1lkJPtxtI4j47cmCD6S7w2CnH8nmppf1Eo5tDuzH 1PIL3rQoj24Gm+pNn7dvVq5WfFgZf6sbdlc2qKogLUAi/cbVEbyMbm2yYbMdVrtQTPofiPOKN EUJayJaIdmoyCOamiGPLe1oddDPlL9BWilKTwuCzakKR7OLltUbsIc6Eb4eMk0CPcRylrWYR5 4blqv3O+OI9+vH60T3+SRCLw== Content-Transfer-Encoding: quoted-printable X-Spamd-Result: default: False [-3.50 / 15.00]; NEURAL_HAM_LONG(-1.00)[-1.000]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; NEURAL_HAM_SHORT(-1.00)[-1.000]; MID_RHS_NOT_FQDN(0.50)[]; DMARC_POLICY_ALLOW(-0.50)[post.com,none]; R_SPF_ALLOW(-0.20)[+ip4:74.208.4.192/26]; R_DKIM_ALLOW(-0.20)[post.com:s=s1089575]; ONCE_RECEIVED(0.10)[]; RCVD_IN_DNSWL_LOW(-0.10)[74.208.4.201:from]; MIME_GOOD(-0.10)[text/plain]; RCPT_COUNT_ONE(0.00)[1]; TO_MATCH_ENVRCPT_ALL(0.00)[]; RCVD_TLS_LAST(0.00)[]; FROM_HAS_DN(0.00)[]; MLMMJ_DEST(0.00)[freebsd-doc@FreeBSD.org]; ASN(0.00)[asn:8560, ipnet:74.208.0.0/16, country:DE]; RWL_MAILSPIKE_POSSIBLE(0.00)[74.208.4.201:from]; HAS_X_PRIO_THREE(0.00)[3]; DKIM_TRACE(0.00)[post.com:+]; TO_DN_NONE(0.00)[]; ARC_NA(0.00)[]; RCVD_COUNT_ONE(0.00)[1]; MIME_TRACE(0.00)[0:+]; FROM_EQ_ENVFROM(0.00)[]; FREEMAIL_ENVFROM(0.00)[post.com]; FREEMAIL_FROM(0.00)[post.com] X-Rspamd-Queue-Id: 4T2x0w5hrYz3Skj X-Spamd-Bar: --- Hi, The FreeBSD Handbook needs improving and I have suggestions to improve it. Yesterday I installed FreeBSD 14-RELEASE and it was a headache. I wanted the GNOME desktop environment, so I navigated the FreeBSD Handboo= k table of contents to section 8.2.2. GNOME and followed the instructions.= The outcome was that GNOME didn't work. The problem was that GNOME depends on either the X Window System or Waylan= d on FreeBSD being installed and they weren't installed. There was no ment= ioned of them needing to be installed under section 8.2.2 GNOME. Section 8.1 Synopsis states the user should understand how to install eith= er the X Window System or Wayland on FreeBSD, but I didn't see that as I a= rrived at section 8.2.2 GNOME by navigating the table of contents. I suggest stating at the start of section 8.2.2 GNOME that either the X Wi= ndow System or Wayland on FreeBSD needs to be installed, and also do it un= der the sections of the other the desktop environments. And section 8.1 Synopsis doesn't actually state the X Window System or Way= land on FreeBSD needs to be installed, it just states the user needs to un= derstand how to install them. That isn't clear. It should state the X Wind= ow System or Wayland on FreeBSD needs to be installed in order to use a de= sktop environment. I also suggest creating a section in the FreeBSD Handbook called 'Window s= ystems' and bringing the the X Window System section and Wayland on FreeBS= D section into it as subsections. Then, for example, instead of it stating GNOME requires the X Window Syste= m or Wayland on FreeBSD being installed, it can just state that GNOME requ= ires a window system be installed. Sincerely, Kolusion