From nobody Sun Dec 31 11:51:58 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 4T2yC36PMSz55ZjS for ; Sun, 31 Dec 2023 11:51:59 +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 4T2yC25Q6Pz3YLW for ; Sun, 31 Dec 2023 11:51:58 +0000 (UTC) (envelope-from kolusion@post.com) Authentication-Results: mx1.freebsd.org; dkim=pass header.d=post.com header.s=s1089575 header.b=k5H7BI7z; 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=1704023518; x=1704628318; i=kolusion@post.com; bh=71mFx7QboUNml9UfM3sao925g5Cr4+0e3MLV4HdrpgU=; h=X-UI-Sender-Class:From:To:Subject:Date; b=k5H7BI7zTg6XhmzssE2NqHuWTR2OvxgPrZY/YvvlSxDzHTnJkirSaIrty59grekN oe5zv8cpsudy30zvVyQqeC6+vZyjX5CybR/0dXT0X8jXXzgTqE1UwkK5sGoH/tzYB GyzS5mljVzuIsuCEwWdzEVf8EfKdoy86iAYHHHUkMZ917YFat0DZ1kFKpjg89r1NW uQbabtll52Hkiigefx4NyXrMFVCgiepduoxOW5WAvfmMdpMblyavkTxeYL/lGqq2K q5UoaN12O/D9lJFz1Q59lt7S9yEGfMcg4I0uEFSIn4KrYVuQ3gOcRt2d9+VaOMniL z605tb3iO9nsSKsTTA== X-UI-Sender-Class: f2cb72be-343f-493d-8ec3-b1efb8d6185a Received: from [10.237.67.2] ([10.237.67.2]) by msvc-mesg-gmxus003.server.lan (via HTTP); Sun, 31 Dec 2023 12:51:58 +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: Systematic broken instructions Content-Type: text/plain; charset=UTF-8 Importance: normal Sensitivity: Normal Date: Sun, 31 Dec 2023 12:51:58 +0100 X-Priority: 3 X-Provags-ID: V03:K1:Y/qRGMQSL2tpsN/EXswQ0K02NFLIqmPOGJLfZoDU9Qgm1CwCWJgwRpC3T20yS3AEdkjbv 20UzD+nlxFwbDe3sA9B0RgqOxAKVHPfVLEADwNwPooiTwlsa9eosIMwnKZfCGl/MaSy2ZB+fmycb NLpvTHZTMWXIiUjGDd3Wwq6epDGOqe9ldEWYWU9KzzgELkdQJVA/3ilHIV9eNfU3BoULwZPH1cki /4NCuivLFyEicvOvkXA5HrTkkxMfo+i2IF5/UzI7HJg+24tJVQo04g9QhVVBOObchuNk9IYGOqCe lA= X-Spam-Flag: NO UI-OutboundReport: notjunk:1;M01:P0:eMnLrn9NX9k=;rwkN3kLyxww2Znjmnhtg/gcmWnQ pLtSCBZIH+JnvHiqhQl+j9juy1LP3Ng5Ih4OorHK6H8bqUtv7sYSWAkCnsascShOATR6WFhov E/OuHWeUwXdU7KwdDKBtF3eO2myL57yl7+yUcSGx2lYbXOMz3uULgl+HEuZLnj0VEsGPYW+kg rXfnq5oFRD+DBISG8ZDybYoJaK5D+OysgtR70550LUjqJQY6V8vjiNVsnHAAj23z7/7v3bLO4 kEfcCU6xamKPnIBuldXD62D9GpZ+ApTTFpbfXnggZM6tt4w10frBv7SC9q0ux4D4CaZ0Ox8V6 KXq8rQUBHT/a5bpKQDvy6Gn512dSX3S3RLiO28snZl/SN4w3QacJugTW0kdALYGOeEgXIQsP+ teByb06Zlpq5twJx881R4fiLOjNVZzKFloZc7VuVvCZMCeB4uQoAdr9k9FktHazXBqKcxLBxZ QvboJWFtILnAntP0D0dMzM7zoR2qZMl3/yN7DvDeKVzzcg4Ad8D0wPlsq1q2lWZhR4igL1Ydg unRxyLTCzc0LUlOBJQ/gMWw0zvhqDv6JwpxP80KaLZsGZEu9HayOQok/4xpkDkWCWuF3PHw/Y /8zin9BoBy0dXkFP9GDKaMajiLW6C8Waybyaze8gZv9XJaB5nrT2FV+3P60iS7zSnZLRa0t3T pJ97tVNBFDbJ4DLXKydFIjqa/wmxqTO2cxIrl073626Gala1NbrX0k4M2uCU2oyfvv301ee7P MU1RaY22/heqTHMjcE6bZPqMxqNJP0WLtmoKyt3WM2D01SSKua0e4hf+N8pSe1CpDnow35zq/ YkCgWMEkLSHla4FHfBYAFgjXMuUxzTOnbgvtfh10AMVGA= X-Spamd-Result: default: False [-3.48 / 15.00]; NEURAL_HAM_LONG(-1.00)[-1.000]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; NEURAL_HAM_SHORT(-0.98)[-0.976]; 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: 4T2yC25Q6Pz3YLW X-Spamd-Bar: --- Hi, The FreeBSD Handbook has a systematic problem where it gives literal instructions that don't work. For example, section 8.2.2.1. Install GNOME meta package states to execute '# pkg install gnome', but '# ' is not part of the command. And the copy button next to the command includes the '# ' which it shouldn't. The instructions should instead say to execute the command as 'root' user. Not everyone knows what '#' means. Its probably explained somewhere in the thousand page manual but most people don't have time to read it all, and they shouldn't have to read it all for something which could easily be explained on the spot. :) Sincerely, Kolusion