linux-kernel - Re: [PATCH v3 00/16] Replace some bad characters on documents

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20210517132446.7edba98f@coco.lan>
Date:   Mon, 17 May 2021 13:24:46 +0200
From:   Mauro Carvalho Chehab <mchehab+huawei@...nel.org>
To:     David Woodhouse <dwmw2@...radead.org>
Cc:     Linux Doc Mailing List <linux-doc@...r.kernel.org>,
        linux-kernel@...r.kernel.org, Jonathan Corbet <corbet@....net>,
        "David S. Miller" <davem@...emloft.net>,
        Theodore Ts'o <tytso@....edu>,
        Alan Stern <stern@...land.harvard.edu>,
        Andreas Dilger <adilger.kernel@...ger.ca>,
        Corentin Labbe <clabbe@...libre.com>,
        Guenter Roeck <linux@...ck-us.net>,
        Jakub Kicinski <kuba@...nel.org>,
        Jaroslav Kysela <perex@...ex.cz>,
        Jean Delvare <jdelvare@...e.com>,
        Joel Fernandes <joel@...lfernandes.org>,
        Lai Jiangshan <jiangshanlai@...il.com>,
        Leo Yan <leo.yan@...aro.org>,
        Mathieu Desnoyers <mathieu.desnoyers@...icios.com>,
        Mathieu Poirier <mathieu.poirier@...aro.org>,
        Mauro Carvalho Chehab <mchehab@...nel.org>,
        Mike Leach <mike.leach@...aro.org>,
        Steven Rostedt <rostedt@...dmis.org>,
        Suzuki K Poulose <suzuki.poulose@....com>,
        Thorsten Leemhuis <linux@...mhuis.info>,
        alsa-devel@...a-project.org, coresight@...ts.linaro.org,
        intel-wired-lan@...ts.osuosl.org, kvm@...r.kernel.org,
        linux-acpi@...r.kernel.org, linux-arm-kernel@...ts.infradead.org,
        linux-ext4@...r.kernel.org, linux-hwmon@...r.kernel.org,
        linux-media@...r.kernel.org, linux-pci@...r.kernel.org,
        linux-usb@...r.kernel.org, mjpeg-users@...ts.sourceforge.net,
        netdev@...r.kernel.org, rcu@...r.kernel.org
Subject: Re: [PATCH v3 00/16] Replace some bad characters on documents

Em Mon, 17 May 2021 11:48:04 +0100
David Woodhouse <dwmw2@...radead.org> escreveu:

> On Sun, 2021-05-16 at 12:18 +0200, Mauro Carvalho Chehab wrote:
> > The conversion tools used during DocBook/LaTeX/html/Markdown->ReST 
> > conversion and some cut-and-pasted text contain some characters that
> > aren't easily reachable on standard keyboards and/or could cause 
> > troubles when parsed by the documentation build system.  
> 
> Better.
> 
> But you still don't say *why* it matters whether given characters are
> trivial to reach with standard keyboard layouts, or specify *what*
> 'troubles' the offending characters cause.

See the patches in the series. The reason for each particular case
is there on each patch, like on this one:

	[PATCH v3 13/16] docs: sound: kernel-api: writing-an-alsa-driver.rst: replace some characters

	The conversion tools used during DocBook/LaTeX/html/Markdown->ReST
	conversion and some cut-and-pasted text contain some characters that
	aren't easily reachable on standard keyboards and/or could cause
	troubles when parsed by the documentation build system.
	 
	Replace the occurences of the following characters:
	
		- U+00a0 (' '): NO-BREAK SPACE
		  as it can cause lines being truncated on PDF output

	Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@...nel.org>


Thanks,
Mauro