Date: Wed, 1 Mar 2017 10:55:39 -0500 From: Ed Maste <emaste@freebsd.org> To: Warner Losh <imp@bsdimp.com> Cc: "Rodney W. Grimes" <freebsd-rwg@pdx.rh.cn85.dnsmgr.net>, Warner Losh <imp@freebsd.org>, src-committers <src-committers@freebsd.org>, "svn-src-all@freebsd.org" <svn-src-all@freebsd.org>, "svn-src-head@freebsd.org" <svn-src-head@freebsd.org> Subject: Re: svn commit: r314473 - head Message-ID: <CAPyFy2BabmR9Y_aXc3Tdu9vLuCZ86457i4_Gs7RQaN9u_rJdnQ@mail.gmail.com> In-Reply-To: <CANCZdfrxUwv4_8JJ7QjeBNzYGvG5mxyaR2K4TW-0yny8kak25A@mail.gmail.com> References: <201703010505.v21556lZ034584@repo.freebsd.org> <201703010545.v215jPSG054051@pdx.rh.CN85.dnsmgr.net> <CANCZdfrxUwv4_8JJ7QjeBNzYGvG5mxyaR2K4TW-0yny8kak25A@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On 1 March 2017 at 09:58, Warner Losh <imp@bsdimp.com> 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).
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAPyFy2BabmR9Y_aXc3Tdu9vLuCZ86457i4_Gs7RQaN9u_rJdnQ>