Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67;
Date:   Thu, 3 Jan 2019 13:34:56 +0100
From:   Otto Sabart <ottosabart@seberm.com>
To:     Jonathan Corbet <corbet@lwn.net>
Cc:     Tejun Heo <tj@kernel.org>, linux-doc@vger.kernel.org,
        linux-kernel@vger.kernel.org
Subject: Re: [PATCH 2/2] doc: cgroup: highlight all paths using the :file:
 inline markup
Message-ID: <20190103123456.GA7586@personal>
References: <20181230165044.GA3097@personal>
 <20190102160149.GQ2509588@devbig004.ftw2.facebook.com>
 <20190102090948.1500a4a8@lwn.net>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
        protocol="application/pgp-signature"; boundary="opJtzjQTFsWo+cga"
Content-Disposition: inline
In-Reply-To: <20190102090948.1500a4a8@lwn.net>
User-Agent: Mutt/1.10.1 (2018-07-13)
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk


--opJtzjQTFsWo+cga
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable


On 02. Jan (Wednesday) v 09:09:48 -0700 2019, Jonathan Corbet wrote:
> On Wed, 2 Jan 2019 08:01:49 -0800
> Tejun Heo <tj@kernel.org> wrote:
>=20
> > On Sun, Dec 30, 2018 at 05:50:44PM +0100, Otto Sabart wrote:
> > > Improve readability using the :file: markup. =20
> >=20
> > Heh, that's a minor plus for formatted output and minor minus for the
> > source.  If this is a convention generally followed for
> > documentations, I have no objects.  That said, can you please reflow
> > the lines?
>=20
> The convention is to minimize markup, especially in cases where it's not
> really needed and it impairs the readability of the plain-text file.  My
> feeling is that this particular markup doesn't provide enough benefit to
> be worth the cost. =20
>=20
> Otto, we all very much appreciate attempts to improve the documentation,
> and I hope you won't stop.  If you would like to do RST work, one very
> helpful thing would be to look into the conversion of the (many) remaining
> plain-text documents and integration into the doc tree.
>=20

Hello Jon,
ok, I try to take a look into it.

Thank you,
Ota

--opJtzjQTFsWo+cga
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAEBCgAdFiEEb6VOpv2s03VHGoilgjuumfi+HjwFAlwuAW4ACgkQgjuumfi+
HjxeGA//cxpZOHNqU96ZxAzCnyO2U+ze5WE/dL6GN9B/itmhXfS+6YNZ7mg3ArhT
v5fEzhYN9vuG5scgMBW61wWXlq/PQvvfyPd4s8PDzLx/oiBKz4bVoi0Mn2pBM+yK
oQ0ew94tWXSBbJplovsegvkZLrd3H1+N4ah5IbHZ5RMtCYYe2/bm4Juqu+mYp53R
ieEpzFTrqo8WNi+YmiYW0bt/SQQpkeuzpCF7dtFryFVd44A4Qt0myTW56JVOMzeZ
mNRIuqcyOzmS4dndBd6g5PDpX5SP73y9P6/sV02LW7G8B+UqTPnBqms6egkIQCxy
2TCmgtE4fnhw+Agex8wCxvo31+oKSLIWiz3x4ieyrE8KdSwoWTThRXTUE/2uHQZK
p3fH7RNXCqefF2NlhYhnOzGjFsAS8NTwYNui3uA6Y6rJ1WqRLAP3PmdPllTFQGjD
oXtuHxNKkaJ+NwnrEk3FtCR9MzhwmuWKvUC2M+xhyoDPxCzx2M7Nrbtd+aERwChD
rs+VwsnN6xQacmgM6v7i+6m7uAj2GyWKc/jPdC8ll2uZFFsqh4WaoGONI2HDDYZq
ouxW7BRz0Yr0jfXWo0boaKfHebnQyPypZx62HqqD2nGa0PIqD+v3X2Czk9BNlHmK
5XsHPTFGRcbTdLdC/zrYI9mSnA/OFlDYOpBgscwm7s25vKsiVDY=
=wwrP
-----END PGP SIGNATURE-----

--opJtzjQTFsWo+cga--