From nobody Thu Apr 30 13:14:47 2026 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 4g5vm32rQPz6bsjR for ; Thu, 30 Apr 2026 13:14:59 +0000 (UTC) (envelope-from matthew@FreeBSD.org) Received: from smtp.freebsd.org (smtp.freebsd.org [IPv6:2610:1c1:1:606c::24b:4]) (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 "smtp.freebsd.org", Issuer "R12" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4g5vm329Bdz3gM6 for ; Thu, 30 Apr 2026 13:14:59 +0000 (UTC) (envelope-from matthew@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1777554899; 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=rD3A0ieDM9vE+hQ1h2pBIjoPlPKa7wgZsE6OtBstT5c=; b=W8s60CR1YudKnt737GLo+tMIjna3zjXhmfhsPdmpxc2HA1DmK0W7cxYxdIIB/yQUC93YoH 39W1o6ZOP/aoBjhcO20QS0A52DAu//HDcID97d8qHq3a7knuwowM96P28wVV0hlqv0lSKH GMaohrgXRfbXY59srzMYJxhauFg5Qzmoo/bWYAPaKz1TvQj3AcsGK3vqlp0VtGDPddkEOs FOsrRTv3BP7cvTSIZvdtagSziRMPR7DTkcFRv8ZN025v5zX58MxFH1l8/xUY30bTW7OlHx Yf2DC6KC+Rxgt7/E4XQ9JrDqWF3KxUgRZGfOcer9FTBwlqrsMaqQ2rezJYnmxw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1777554899; a=rsa-sha256; cv=none; b=ooNcoIk+ooKVfqcKV9KztzGcpuyqD4lVVC/zYc4Xwyj9zB7VwlABvqIYWJxh6MqA71QykE 9EDqeiStL/U3HZ/r6VDjZoLgNRkp0JeuBXAn3S0q1cCQfBJ0rtwSdc8oLE78RAq+yG9Z23 RFYIPHOBWmblZyh2ShXgu2hrcmyNqDwn48jOoHOTj0FohDpT92MhX6xm2RdftgPX1Snf6n g1RtAwUsQqzPEtYCUNLhXMcNATnFqzNHlwurJfYKzPpM6rBXyGXmUM/puDU49/cKlGrXTX xiJVQydJeboVSy6DtayzTl9okTvHyNmaHn/G7uH66Oa608Z0U7TOEtB3d/WzvA== ARC-Authentication-Results: i=1; smtp.infracaninophile.co.uk; dmarc=fail (p=none dis=none) header.from=FreeBSD.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1777554899; 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=rD3A0ieDM9vE+hQ1h2pBIjoPlPKa7wgZsE6OtBstT5c=; b=f5BpvmJ5UV2ayfjnI3IlHQEgjNCWkFepes+hde/SMxh3sg9mo89yyaIiPvtTfMSQVS42Nu wiHqiyHbE0Ih5PKgPS+v5c/+/7jGybEDsTRpGopLSZaHe6C6LqGmega8jBHgve+p8qcHOM 2EwKPg/xyK1Y5kExsSpYhoE6XwCdOkEOJp3fXMW5MnHDaGpY/nHyERNivq2vgREqNvIUQ4 u2ZYo1R3dHl8ZCcK7lVAjBgL8nPU5aJ6nzS8AvX8jEEY9Ied/+sSCWa8ryyJh2ULZvP63W iGX8uT90j0C0A4SrJcV32bX3Fg8xKaWh0Clg3uwH7UbbVzDJnV2xCn3UARJwPg== Received: from smtp.infracaninophile.co.uk (smtp.infracaninophile.co.uk [81.2.117.100]) (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) (Authenticated sender: matthew/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id 4g5vm30b6zzQmb for ; Thu, 30 Apr 2026 13:14:59 +0000 (UTC) (envelope-from matthew@FreeBSD.org) Received: from [IPV6:2001:8b0:151:1:2583:2daa:5eb7:62c2] (unknown [IPv6:2001:8b0:151:1:2583:2daa:5eb7:62c2]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519MLKEM768 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) (Authenticated sender: m.seaman@infracaninophile.co.uk) by smtp.infracaninophile.co.uk (Postfix) with ESMTPSA id 966001B8E9 for ; Thu, 30 Apr 2026 14:14:47 +0100 (BST) Authentication-Results: smtp.infracaninophile.co.uk; dmarc=fail (p=none dis=none) header.from=FreeBSD.org Message-ID: <5eabb317-8827-4350-bd72-a9342e49c31c@FreeBSD.org> Date: Thu, 30 Apr 2026 14:14:47 +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 User-Agent: Mozilla Thunderbird From: Matthew Seaman Subject: Re: 1.2.1. FreeBSD installation process To: freebsd-doc@freebsd.org References: Content-Language: en-GB In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 30/04/2026 12:47, alex@dawnmail.net wrote: > I want to submit a patch for 'man sh' (/usr/share/man/man1/sh.1.gz). > Step 3 of '1.2.1 FreeBSD installation process' shows the following: > > 3. Edit the documentation files that require > changes. If a file needs major changes, > consult the mailing list for input. > > What is the documentation file for 'man sh'? https://github.com/freebsd/freebsd-src/blob/main/bin/sh/sh.1 Remember to update the date in the .Dd item right below the leading comment block. Also, only ever one sentence per line. If you're not familiar with how nroff macros work, or even if you are, opening a Phabricator review at reviews.freebsd.org would be a good idea, so you can get feedback from developers. Cheers, Matthew