Thread (27 messages) 27 messages, 8 authors, 2021-06-16

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

From: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Date: 2021-05-17 11:25:09
Also in: alsa-devel, intel-wired-lan, kvm, linux-acpi, linux-arm-kernel, linux-ext4, linux-hwmon, linux-media, linux-pci, linux-usb, lkml, netdev, rcu

Em Mon, 17 May 2021 11:48:04 +0100
David Woodhouse [off-list ref] escreveu:
On Sun, 2021-05-16 at 12:18 +0200, Mauro Carvalho Chehab wrote:
quoted
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 [off-list ref]


Thanks,
Mauro
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help