Date: Mon, 30 Jan 2023 12:30:56 +0100 From: Mathieu Arnold <mat@freebsd.org> To: Sergio Carlavilla <carlavilla@freebsd.org> Cc: ykla <yklaxds@gmail.com>, "freebsd-doc@FreeBSD.org" <freebsd-doc@freebsd.org> Subject: Re: To be deprecated [.filename]## tag in the document? Message-ID: <20230130113056.rxdp4ajyh5adayl4@aching.in.mat.cc> In-Reply-To: <CAFwocyO_2gzyG=qN4eiOyR12MrYBhq80mbUEB7qf6X110n5VSA@mail.gmail.com> References: <CA%2BPGaYChwV0uZi4y6fdLwFwX396tbUTzgGS7hCuxwT1LhRYr0g@mail.gmail.com> <CAFwocyO_2gzyG=qN4eiOyR12MrYBhq80mbUEB7qf6X110n5VSA@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--6fecnfdyt6t73kto Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Jan 30, 2023 at 11:36:05AM +0100, Sergio Carlavilla wrote: > El jue., 26 ene. 2023 8:21, ykla <yklaxds@gmail.com> escribi=F3: >=20 > > Hi, > > > > I see that in some sections the [.filename]# # tags have been replaced > > with ` `, which does not effectively distinguish between folders, device > > symbols and specific commands, etc. > > > > Are there any plans for FreeBSD to do this across the board in the > > future? I.e., do we need to do away with the [.filename]# # tag? > > > > ykla > > . > > >=20 > Hi, >=20 > Yes, the idea is to remove the [.filename]## tag and use `` >=20 > This is from the migration of Docbook to AsciiDoc. But, why? This feels like a regression, docbook allowed us to mark things up semantically, like, we would know what was a variable, a filename, a code block... The idea was to be able to differentiate things, and let the rendering do the right thing. If I see [.filename]#PKG# I clearly see it refers to a filename, they used to be rendered as fixed with, in some color, so that they could be differentiated from other fixed width stuff. If I see `PKG` I just see something that will be rendered with a fixed with font, but I have no idea what it refers to. --=20 Mathieu Arnold --6fecnfdyt6t73kto Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQITBAABCgB9FiEE9XJBpJetWizkEBUef2IOCp6dQb4FAmPXqm9fFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldEY1 NzI0MUE0OTdBRDVBMkNFNDEwMTUxRTdGNjIwRTBBOUU5RDQxQkUACgkQf2IOCp6d Qb4vHQv9ENTx6NqaOqg+8SHG/cTaX0baHasOdQzF3hATU/zq4F8zs03/dPYewRnN 3Hktir8WgMvrs6NaHAVQon9GFu6R2VQISadCFnUQrTb9Tb1J7ZESyeAnRLqqOqK1 AIV1h1QQGMJzVzK9zrHUAUBG++O2E1XtT2LM35gGbaxLLzMXZRVw+Yyf8S/pe2RQ JEfmg8JR0iPqOXiEIXW+xw45PrzykkxN7+DpXR9RhdD0ElFo1bn11BEhb9xPeRSC vgoqtcZzgzx2L6VeOhTzbUaPVL1ADkwBkgjHVrh/Zu2AFxNsh4OfnXiI3Bj92jEp tOeFSWIMPOgIzPpej7q3uWejMHbKF+FhFqMN/EsIMpOsjdUcN0qkpEWc/DQTT7nT iyr1UTxPpnioG1ZdGu+aKu3dC2X7QP98MRr3m6tYqnHzd5yD4H3A5b2+8ZEh3IMD HiYd1jwM8nYnEQMdIbq+3+ljgDmHQELbs5/R3p3JvPqRip9v8ZThJX8o+d4a+eaT eCf8uKUW =vdw8 -----END PGP SIGNATURE----- --6fecnfdyt6t73kto--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20230130113056.rxdp4ajyh5adayl4>