From: Mauro Carvalho Chehab <mchehab+huawei@kernel•org>
To: David Woodhouse <dwmw2@infradead•org>
Cc: Linux Doc Mailing List <linux-doc@vger•kernel.org>,
linux-kernel@vger•kernel.org, Jonathan Corbet <corbet@lwn•net>,
"David S. Miller" <davem@davemloft•net>,
Theodore Ts'o <tytso@mit•edu>,
Alan Stern <stern@rowland•harvard.edu>,
Andreas Dilger <adilger.kernel@dilger•ca>,
Corentin Labbe <clabbe@baylibre•com>,
Guenter Roeck <linux@roeck-us•net>,
Jakub Kicinski <kuba@kernel•org>,
Jaroslav Kysela <perex@perex•cz>,
Jean Delvare <jdelvare@suse•com>,
Joel Fernandes <joel@joelfernandes•org>,
Lai Jiangshan <jiangshanlai@gmail•com>,
Leo Yan <leo.yan@linaro•org>,
Mathieu Desnoyers <mathieu.desnoyers@efficios•com>,
Mathieu Poirier <mathieu.poirier@linaro•org>,
Mauro Carvalho Chehab <mchehab@kernel•org>,
Mike Leach <mike.leach@linaro•org>,
Steven Rostedt <rostedt@goodmis•org>,
Suzuki K Poulose <suzuki.poulose@arm•com>,
Thorsten Leemhuis <linux@leemhuis•info>,
alsa-devel@alsa-project•org, coresight@lists•linaro.org,
intel-wired-lan@lists•osuosl.org, kvm@vger•kernel.org,
linux-acpi@vger•kernel.org, linux-arm-kernel@lists•infradead.org,
linux-ext4@vger•kernel.org, linux-hwmon@vger•kernel.org,
linux-media@vger•kernel.org, linux-pci@vger•kernel.org,
linux-usb@vger•kernel.org, mjpeg-users@lists•sourceforge.net,
netdev@vger•kernel.org, rcu@vger•kernel.org
Subject: Re: [PATCH v3 00/16] Replace some bad characters on documents
Date: Mon, 17 May 2021 13:24:46 +0200 [thread overview]
Message-ID: <20210517132446.7edba98f@coco.lan> (raw)
In-Reply-To: <30cd6dd9d1049d56b629c92a5f385b84c026b445.camel@infradead.org>
Em Mon, 17 May 2021 11:48:04 +0100
David Woodhouse <dwmw2@infradead•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@kernel•org>
Thanks,
Mauro
prev parent reply other threads:[~2021-05-17 11:25 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-05-16 10:18 [PATCH v3 00/16] Replace some bad characters on documents Mauro Carvalho Chehab
2021-05-16 10:18 ` [PATCH v3 11/16] docs: networking: device_drivers: replace some characters Mauro Carvalho Chehab
2021-05-17 16:11 ` Jesse Brandeburg
2021-05-17 10:48 ` [PATCH v3 00/16] Replace some bad characters on documents David Woodhouse
2021-05-17 11:24 ` Mauro Carvalho Chehab [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20210517132446.7edba98f@coco.lan \
--to=mchehab+huawei@kernel$(echo .)org \
--cc=adilger.kernel@dilger$(echo .)ca \
--cc=alsa-devel@alsa-project$(echo .)org \
--cc=clabbe@baylibre$(echo .)com \
--cc=corbet@lwn$(echo .)net \
--cc=coresight@lists$(echo .)linaro.org \
--cc=davem@davemloft$(echo .)net \
--cc=dwmw2@infradead$(echo .)org \
--cc=intel-wired-lan@lists$(echo .)osuosl.org \
--cc=jdelvare@suse$(echo .)com \
--cc=jiangshanlai@gmail$(echo .)com \
--cc=joel@joelfernandes$(echo .)org \
--cc=kuba@kernel$(echo .)org \
--cc=kvm@vger$(echo .)kernel.org \
--cc=leo.yan@linaro$(echo .)org \
--cc=linux-acpi@vger$(echo .)kernel.org \
--cc=linux-arm-kernel@lists$(echo .)infradead.org \
--cc=linux-doc@vger$(echo .)kernel.org \
--cc=linux-ext4@vger$(echo .)kernel.org \
--cc=linux-hwmon@vger$(echo .)kernel.org \
--cc=linux-kernel@vger$(echo .)kernel.org \
--cc=linux-media@vger$(echo .)kernel.org \
--cc=linux-pci@vger$(echo .)kernel.org \
--cc=linux-usb@vger$(echo .)kernel.org \
--cc=linux@leemhuis$(echo .)info \
--cc=linux@roeck-us$(echo .)net \
--cc=mathieu.desnoyers@efficios$(echo .)com \
--cc=mathieu.poirier@linaro$(echo .)org \
--cc=mchehab@kernel$(echo .)org \
--cc=mike.leach@linaro$(echo .)org \
--cc=mjpeg-users@lists$(echo .)sourceforge.net \
--cc=netdev@vger$(echo .)kernel.org \
--cc=perex@perex$(echo .)cz \
--cc=rcu@vger$(echo .)kernel.org \
--cc=rostedt@goodmis$(echo .)org \
--cc=stern@rowland$(echo .)harvard.edu \
--cc=suzuki.poulose@arm$(echo .)com \
--cc=tytso@mit$(echo .)edu \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox