From nobody Mon Jan 30 11:30:56 2023 X-Original-To: freebsd-doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4P55bV0ngnz3cKd1 for ; Mon, 30 Jan 2023 11:31:02 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [IPv6:2610:1c1:1:606c::24b:4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4P55bV0HY5z4771; Mon, 30 Jan 2023 11:31:02 +0000 (UTC) (envelope-from mat@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1675078262; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=kpbiQkJ+GeWMlRgRh5Rb2DDrJJhQGH2iZ60aOmBDNZc=; b=WOEbA1QT4E95SBq3NMTMwXcLSj9nE+oaa4uhU97P/sO0djBMhetmBIGXT9d6DPp+OlgZxk dfzj6CV/OFcNjFV08DZHBz77Pv1s6KjmMgwsYHfr6ArpJjNhoN6JQqICe6n0ks+EQ1ySHk zF1rCu+SG5KVBakN6lGR8BxgKouz67ieBVqhZObGlW6qC7kuiNzuS6Pdq1VfmXaiFbn07z eAW0AOD1NTo67PF1fPJjWhCK/8f/NF0Rg2tuIA0/4F8lXkqaF8LEijg5byNGZL0zlYZ5QQ 4o8UB+vX8WeMsNg8qrAAmCCfRMewir2u7SFlNH/vZg9eyDYYuGIjQwdVIhDTjw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1675078262; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=kpbiQkJ+GeWMlRgRh5Rb2DDrJJhQGH2iZ60aOmBDNZc=; b=F7Pyi6loZNUovjX3pYUnMceFs+PiVlqjYs6l+FfeeFVmR1swGv62eYN/AZgmD/iM0jJpdA cWeWDJpPkezB6o6n+Dq1+XgLOwxzxKDsgHvW/kQ7cH03EJKvRSWK94ZNhRid2HWPTe2jnr QgUwwrTF82vdDc8jHB1DHFM9EpObQ/JKqI6qs5bmbhpZCQS5xHQ5oyocPn9Ig4G/mHXEV5 Wvb0EbENNH/LqFFiznM5UNQJCznsjuqRBZEhNca5/9WyLvkvFoQsRd+jYjE2Qb3W6RFQ2l 6p3qd7snqYaJ0gu3zUNFyqowapyfg+3R3iQeH0Sl9O8mQJq4bdI8ReEA5z9riw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1675078262; a=rsa-sha256; cv=none; b=ISc7QOnxF7DXSaJU9iJZVg6/BoQjDDkHthnOcAvmQ6ymkTIDMCMNjugEv1lBeQbrkfnN+Y PEMzPSQiAWB2x6+C+GdiKQAHxkjT4WXMWOpZUZpRvMFL9R1gxU7olW/gbWcFRUIniI8TGq mTi2zQNe1kq/eX7KduD/bBNJuvHjuo/WTxRw94SYNerfbiAV1oUj/OgrbZJEKQ8D/iTU6L 9vQm9b1mIB38iUMrCPm/IHPVTWbf/x3Oquc80+IySYNiqFS3epKp73rlc764gIyoR0XguH 3VmEQQfwL1kC1kFavym/wbnFUtCT4U+GTKzB3LS0KH7+y/lHw0aiJ8GbL7N1FQ== Received: from mail.j.mat.cc (owncloud.cube.mat.cc [IPv6:2a01:678:4:1::228]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mail.mat.cc", Issuer "R3" (verified OK)) (Authenticated sender: mat/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id 4P55bT5my7z1Mly; Mon, 30 Jan 2023 11:31:01 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from aching.in.mat.cc (unknown [IPv6:2a01:678:ab:50:f4d0:59b4:70a4:bf34]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: mat@mat.cc) by mail.j.mat.cc (Postfix) with ESMTPSA id 97790942D80; Mon, 30 Jan 2023 11:30:57 +0000 (UTC) Date: Mon, 30 Jan 2023 12:30:56 +0100 From: Mathieu Arnold To: Sergio Carlavilla Cc: ykla , "freebsd-doc@FreeBSD.org" Subject: Re: To be deprecated [.filename]## tag in the document? Message-ID: <20230130113056.rxdp4ajyh5adayl4@aching.in.mat.cc> References: List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="6fecnfdyt6t73kto" Content-Disposition: inline In-Reply-To: X-ThisMailContainsUnwantedMimeParts: N --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 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--