From owner-svn-src-all@FreeBSD.ORG Sun Apr 19 08:42:41 2015 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 00D9F921 for ; Sun, 19 Apr 2015 08:42:40 +0000 (UTC) Received: from mail-wg0-x22b.google.com (mail-wg0-x22b.google.com [IPv6:2a00:1450:400c:c00::22b]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 8805DC13 for ; Sun, 19 Apr 2015 08:42:40 +0000 (UTC) Received: by wgso17 with SMTP id o17so150762053wgs.1 for ; Sun, 19 Apr 2015 01:42:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:sender:in-reply-to:references:from:date:message-id :subject:to:cc:content-type; bh=+J9/csZEEXgoGybOWPYqaBE8zamEvHnRBEF0LT8Il+I=; b=MoOLBmypjq49OmWZisAt+bg0TsC6KsKNG2HXQgoA+mL2FOwWY6rr2BqLwF9rwiBWxc vO1oPz/ccVkE/jpC3VYBKHmzMX9zNXkVt5yHGqLKp/uBOlBQaBRw/Wdys2XqKHA01A9n rurBtf6E5WiKO0KbX9kT3AkSmGZUH159aAfT8= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:sender:in-reply-to:references:from :date:message-id:subject:to:cc:content-type; bh=+J9/csZEEXgoGybOWPYqaBE8zamEvHnRBEF0LT8Il+I=; b=k7YkFIqyP5LDABTPMEE9MIcq8VxCGmnwR4SS1wPGIM2kGHwyanJi6JZQGO27MGqT7B x3enlkkLirrVtrOmYgnw6JOLdUzJIXqA8i9D0HllmcVZFdN/zereMM/pgruXkbuO7QwE 57MaLReMfOpXXo2gtqXXslYm+hwQiNumZgejIAL+W73i876lF0CbKMF+bOSZWlEpDO1q vJCRfvcydJP4zpUGoLQx/Ity5jsZL6aPQYWvpLVJ+6xryr2gSkjIOphWl0+q2Y8mtRPO CGqLPJp15XnrRfrb/vPGkKF9aENMzQjBG8cGhEl4VQiHhg7cBcWiIm9GHwyvv6Uk1hJw ovQg== X-Gm-Message-State: ALoCoQn4OWHeSCZzWAvMA1WDHkd1bw7wZgZ7LUY0cN9HIQEnX6XTr+48HwnNGMa/aD6/WJXPlxh5 X-Received: by 10.194.237.34 with SMTP id uz2mr20487896wjc.157.1429432958988; Sun, 19 Apr 2015 01:42:38 -0700 (PDT) MIME-Version: 1.0 Sender: lists@eitanadler.com Received: by 10.28.211.135 with HTTP; Sun, 19 Apr 2015 01:42:08 -0700 (PDT) In-Reply-To: <20150419083451.GA79519@FreeBSD.org> References: <201504190716.t3J7GjmW072744@svn.freebsd.org> <20150419083451.GA79519@FreeBSD.org> From: Eitan Adler Date: Sun, 19 Apr 2015 01:42:08 -0700 X-Google-Sender-Auth: cuO27SwLTqWeOzO9vV97gTH9XRs Message-ID: Subject: Re: svn commit: r281727 - head To: Alexey Dokuchaev Cc: "src-committers@freebsd.org" , "svn-src-all@freebsd.org" , "svn-src-head@freebsd.org" Content-Type: text/plain; charset=UTF-8 X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 19 Apr 2015 08:42:41 -0000 On 19 April 2015 at 01:34, Alexey Dokuchaev wrote: > On Sun, Apr 19, 2015 at 07:16:45AM +0000, Eitan Adler wrote: >> New Revision: 281727 >> URL: https://svnweb.freebsd.org/changeset/base/281727 >> >> Log: >> README: changes and fixups >> Two orthogonal goals: >> - try to make README look a little nicer on phabricator by using >> Remarkup syntax for commands (using `` instead of using a closing ') >> - try to make README look a little nicer on github. > > FreeBSD had traditionally used both double (``...'') and single (`...') to > express "literal" something; I am not convinced that changing it just to > match GitHub's markdown warrants it. This `...` form is alien to FreeBSD, > and can be also confused with backquoted form of shell's $(...) command > substitution. Without this change, the syntax ends up being parsed very weirdly by both phabricator and github. That said, if there is strong precedent not to use the markdown syntax, and it would cause confusion, I will revert those changes. -- Eitan Adler Source, Ports, Doc committer Bugmeister, Ports Security teams