From owner-svn-src-head@freebsd.org Wed Mar 1 15:56:00 2017 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 9DD1DCE4138; Wed, 1 Mar 2017 15:56:00 +0000 (UTC) (envelope-from carpeddiem@gmail.com) Received: from mail-it0-x22c.google.com (mail-it0-x22c.google.com [IPv6:2607:f8b0:4001:c0b::22c]) (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 5FE7D1DE; Wed, 1 Mar 2017 15:56:00 +0000 (UTC) (envelope-from carpeddiem@gmail.com) Received: by mail-it0-x22c.google.com with SMTP id 203so100784639ith.0; Wed, 01 Mar 2017 07:56:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:sender:in-reply-to:references:from:date:message-id :subject:to:cc; bh=KFj7RQlOQ/MCJyBg3E5DMJisNl7IiinueCslMWw/1xg=; b=IGQ06AhtkXCih0ygNU6yVB8CcR8G7pLahgrS8zom+Lzl7Is8nGUxxbLf8p9ttHa2ZM VAjcrfrYqh7kA63vmP4Bke+4ljAWHM2k3+8BpBq76EUi3Jk+c93ljX6ezEMje7DNB5ng jUDkXIVS+33TEWnQvivsfGw4En16a+ezaCAOXMup8WQGoVCOoarvvdHgD919XmV+FwTZ /79KlzEoOFu2i8F6spl51bIAlK+Hn+StZY5iHtegAN3gNyViuTqjBgpFogwIoVn1CzxE 3elrVu+pRFxX85v9R9Tyq5TKYyvQOipCWgVX3SMJNjmoJlui5W+hBW/fnvvY7cj6Wobm s/qw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:sender:in-reply-to:references:from :date:message-id:subject:to:cc; bh=KFj7RQlOQ/MCJyBg3E5DMJisNl7IiinueCslMWw/1xg=; b=e3elptOubnrlwbPjQ37af5nFUvDzulaTb+mIwg2aYXSc/DhPMz8/4fqJTWWuZZU6BH nl9BM5QfVgX8us4fwyFx8zw7g8lNjKpJFul7Y1kcoJ5UOtIOXQ/1OlLLMrEAUOs3lfbM UJEQhe6PmAld2AXql09vkICV/XfF1cYB3gqFCK277PdUNkwejeQMj3NNcKytWLSIvnpx upyu1mf8RLHsIpFqUX4R+1codyYbM87TSByDIIR4Xnj9lCcEf38RzFEhEtEvzUPDGRlk kd4/qnKgR39eDInPRnmdcRZN4rJIhdHyx/sbbrxic6j99RQRsdSKweWya4CUDl8XgoUU n7Wg== X-Gm-Message-State: AMke39kKRiO1SOQI0p9CvljQk+w7lLy7bVRJQpl4+9G0/Lt3phRQ7+Hdbqd84sc1fnKD/FHQrWPef/e+1uskjw== X-Received: by 10.36.209.198 with SMTP id w189mr5014616itg.83.1488383759838; Wed, 01 Mar 2017 07:55:59 -0800 (PST) MIME-Version: 1.0 Sender: carpeddiem@gmail.com Received: by 10.107.12.162 with HTTP; Wed, 1 Mar 2017 07:55:39 -0800 (PST) In-Reply-To: References: <201703010505.v21556lZ034584@repo.freebsd.org> <201703010545.v215jPSG054051@pdx.rh.CN85.dnsmgr.net> From: Ed Maste Date: Wed, 1 Mar 2017 10:55:39 -0500 X-Google-Sender-Auth: 0ecXYx6B7blt8y45ESyA_zONKRY Message-ID: Subject: Re: svn commit: r314473 - head To: Warner Losh Cc: "Rodney W. Grimes" , Warner Losh , src-committers , "svn-src-all@freebsd.org" , "svn-src-head@freebsd.org" Content-Type: text/plain; charset=UTF-8 X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 01 Mar 2017 15:56:00 -0000 On 1 March 2017 at 09:58, Warner Losh wrote: > > It's a verbatim copy of README converted to markdown. Maybe README > should be fixed and this regenerated. The trailing whitespace is part > of the conversion and not a mistake. I think the whitespace is a mistake, since the markdown version is rendered in variable width with proportional font, so hard 80-col wrapping is undesirable. I've removed the whitespace in r314495. > If you want to update README and hier(7) and have README.md generated > from that automatically, be my guest. None of that was in the > submission, and the submission was useful as it was. I'm happy for us to have a README.md although we now have the issue of keeping them in sync (if we want to). There are some minor things that we don't want to make completely identical -- for example, the rendered version claims "This file was last revised on: $FreeBSD$" because the svn-git exporter does not expand $FreeBSD$. I think we ought to just remove that sentence from the markdown version. Perhaps this suggests we don't try to keep them in sync, which is likely fine as they'll generally be seen by different groups of people (markdown for those browsing the project on GitHub, plain README for those with an installed source tree).