Re: [PATCH v2 00/40] Use ASCII subset instead of UTF-8 alternate symbols

David Woodhouse <[email protected]> Wed, 12 May 2021 18:07:04 +0100
Newsgroups gmane.comp.freedesktop.xorg.drivers.intel,gmane.linux.documentation,gmane.linux.alsa.devel,gmane.comp.emulators.kvm.devel,gmane.linux.kernel.iio,gmane.linux.kernel.pci,gmane.comp.video.dri.devel,gmane.linux.drivers.rdma,gmane.linux.acpi.devel,gmane.linux.kernel.input,gmane.comp.file-systems.ext4,gmane.linux.drivers.video-input-infrastructure,gmane.linux.power-management.general,gmane.comp.video.mjpeg.user,gmane.linux.ports.arm.kernel,gmane.linux.kernel.hwmon,gmane.linux.network,gmane.linux.usb.general,gmane.linux.kernel,gmane.linux.file-systems.f2fs
Message-ID <[email protected]>
Your title 'Use ASCII subset' is now at least a bit *closer* to
describing what the patches are actually doing, but it's still a bit
misleading because you're only doing it for *some* characters.

And the wording is still indicative of a fundamentally *misguided*
motivation for doing any of this. Your commit comments should be about
fixing a specific thing, nothing to do with "use ASCII subset", which
is pointless in itself.

On Wed, 2021-05-12 at 14:50 +0200, Mauro Carvalho Chehab wrote:
> Such conversion tools - plus some text editor like LibreOffice  or similar  - have
> a set of rules that turns some typed ASCII characters into UTF-8 alternatives,
> for instance converting commas into curly commas and adding non-breakable
> spaces. All of those are meant to produce better results when the text is
> displayed in HTML or PDF formats.

And don't we render our documentation into HTML or PDF formats? Are
some of those non-breaking spaces not actually *useful* for their
intended purpose?

> While it is perfectly fine to use UTF-8 characters in Linux, and specially at
> the documentation,  it is better to  stick to the ASCII subset  on such
> particular case,  due to a couple of reasons:
> 
> 1. it makes life easier for tools like grep;

Barely, as noted, because of things like line feeds.

> 2. they easier to edit with the some commonly used text/source
>    code editors.

That is nonsense. Any but the most broken and/or anachronistic
environments and editors will be just fine.

_______________________________________________
Intel-gfx mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/intel-gfx
smime.p7s (application/x-pkcs7-signature, 5.1 KB) - not displayed