From owner-freebsd-doc@FreeBSD.ORG Sun Sep 7 16:59:27 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 0CA828B7 for ; Sun, 7 Sep 2014 16:59:27 +0000 (UTC) Received: from mx1.scaleengine.net (beauharnois2.bhs1.scaleengine.net [142.4.218.15]) by mx1.freebsd.org (Postfix) with ESMTP id C2BE31DC7 for ; Sun, 7 Sep 2014 16:59:25 +0000 (UTC) Received: from [192.168.1.2] (senat1-01.HML3.ScaleEngine.net [209.51.186.5]) (Authenticated sender: allanjude.freebsd@scaleengine.com) by mx1.scaleengine.net (Postfix) with ESMTPSA id DA0FE469D6 for ; Sun, 7 Sep 2014 16:59:24 +0000 (UTC) Message-ID: <540C8EEB.8080602@freebsd.org> Date: Sun, 07 Sep 2014 12:59:23 -0400 From: Allan Jude User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:24.0) Gecko/20100101 Thunderbird/24.6.0 MIME-Version: 1.0 To: freebsd-doc@freebsd.org Subject: Re: /etc/motd update References: In-Reply-To: Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="eKT2k9rokG2fUSjunR4H03jFgdCaVkIbG" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 07 Sep 2014 16:59:27 -0000 This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --eKT2k9rokG2fUSjunR4H03jFgdCaVkIbG Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable On 2014-09-07 12:52, Warren Block wrote: > On Sun, 7 Sep 2014, Royce Williams wrote: >=20 >> On Sun, Sep 7, 2014 at 5:49 AM, Warren Block wrot= e: >>> >>> Based on feedback from -arch, now there is a version that uses only >>> harmless, inoffensive ASCII whitespace to delimit the commands: >>> >>> http://www.wonkity.com/~wblock/motd/motd.whitespace >> >> Not to bikeshed overmuch, but such usage of extra whitespace seems >> odd/rare, and harms readability. >> >> If the intent is to help new users get oriented, it doesn't serve the >> intended purpose, IMO. >> >> Better to offset with quotes or something: >> >> Other questions or problems can be emailed to the questions@FreeBSD.or= g >> mailing list. Please include the output of "uname -a" and any relevan= t >> error messages. The "man man" command gives an introduction to manual= >> pages, and hier(7) describes the FreeBSD directory layout. >=20 > This is pretty much what we have now: >=20 > % `uname -a' > Unmatched `. > % "man man" > man man: Command not found. >=20 > The goal is to give a new user literal commands that do not need > interpretation. I was surprised at how subtly the double spaces showed= > that the command was separate from the rest of the text. It's not > ideal, but there is a serious lack of options in plain ASCII. > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" Yeah, having it on its own line, indented, seems to work the best. But for some of the short ones in the middle of a sentence, like uname -a, that probably doesn't make sense. The double space is the best i've seen so far. --=20 Allan Jude --eKT2k9rokG2fUSjunR4H03jFgdCaVkIbG Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.22 (MingW32) iQIcBAEBAgAGBQJUDI7uAAoJEJrBFpNRJZKf0I8P/0tgL2SZ7HuDM0iPcs/Xdsyn Q4LSzMTIR6mBv+MR+re/WQG47whm5+uw92cYwzN50dF4yR5+/NnG2ZqFGa5jHsfB TrilL9UsxRQzPbFTr/sRMh7/pAlr5dGUZD0Y+V0Dyv8ov4HM85GMkaEJrgGlreMm SxDwYM9fXUQEH5LN+TWbiLOA2kQCqcyq3WKOz2DbrvNHYWTVEM7WX2RaGrnVTW0s 7Ws0VFnX6+WMJMsvb/4djh3AbTTuLEu7YAPo4UpYQmE/39c8CjMPZ0Xux0OYxnBG tYDVqRwgk3WPv89jk8cLu++7mqQCPOIVkDy6xu/ElNHDrKogXPUSc7nfq+XI6MOi hHosY2O1YMr0eQlkRuuYzYv8rq3v2RCN3EdvUzgqGGw7XGXy+zqne20ozaxeh2O2 C1y/gNgdqStfnC6r9xCsNHDN19LvrwlRVdXa4TVhIAyWCO8iCx1xFmXSdfYGUWsm Dxky/uimZPeNIDq7CW01o751qrV43TxAMVLl2p4N6DtCCH/qtw0KGBk9rAb3Yytf ESWI1DW7ImAZKgpo2PBY8xObH1pmPbGiN4jHcVCZDBvQNolIUvjg00AS9kNCx7Kh uCf68tS66FunMBywgMHG2+GUMtzHfSUf1KMLZ0NnwL3ry/Xck5yEqhewjCOi37N6 A0LlcmptSV82hODbczAj =Q/cC -----END PGP SIGNATURE----- --eKT2k9rokG2fUSjunR4H03jFgdCaVkIbG--