From patchwork Wed May 12 12:50:08 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 12253517 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-17.7 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,INCLUDES_CR_TRAILER,INCLUDES_PATCH,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 37A79C43461 for ; Wed, 12 May 2021 12:54:11 +0000 (UTC) Received: from desiato.infradead.org (desiato.infradead.org [90.155.92.199]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 96F8761104 for ; Wed, 12 May 2021 12:54:10 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 96F8761104 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=desiato.20200630; h=Sender:Content-Transfer-Encoding :Content-Type:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To:Message-Id:Date: Subject:Cc:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=S09xX/t5dZ6+Oomvkg/+4QxPADmAw5+WpJ1CWsOVgD0=; b=Jk+r8cGxKl9kMaVSpLvHV4lR7 FF9fHkm9BxiaiAneK4sq33t23LX8VNKog4pRH3D1FCCKilmmg2QrS/ogwrOcOaTe1MYR3i6x/d0PB UVLGUuwhywvRWc/YDAcInXdp+Z4L/tWH++cswXB0GS3bML/6IQEWBp2Y0PZmO4yBufIPiAE2AHEDW wb4KKQ5q5Hzxlspepo+Sp/5n63lBolLAtOY3w14+MNX7ysHs0V4Dxvk1+gjfO8u/ulRJzPHl2F1gv 5soYNIXOkFCpjMu4MX3OHOJzL5d3AodCobVWsIDWoWnSt3j0GVlRk0faPwLEXaKwwjhardakslZHE /jsQ1Gtpg==; Received: from localhost ([::1] helo=desiato.infradead.org) by desiato.infradead.org with esmtp (Exim 4.94 #2 (Red Hat Linux)) id 1lgoLu-002nog-HI; Wed, 12 May 2021 12:52:38 +0000 Received: from bombadil.infradead.org ([2607:7c80:54:e::133]) by desiato.infradead.org with esmtps (Exim 4.94 #2 (Red Hat Linux)) id 1lgoL3-002naQ-J4 for linux-arm-kernel@desiato.infradead.org; Wed, 12 May 2021 12:51:45 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Sender:Content-Transfer-Encoding: Content-Type:MIME-Version:References:In-Reply-To:Message-Id:Date:Subject:Cc: To:From:Reply-To:Content-ID:Content-Description; bh=GV8eqAh2yOdnNbrbuocm8kPN9nKi68ptxoDJEr4rEf0=; b=CdlM0EjjidZ+/n6Pq8DAbuyNSd jdy8o40C33IIQKuQf2MP9UgLtdcb9uPLZt3vab2p4cAbgIXYnwMRFXXGY5jWWNEDgtacVLgT9vbTD gctvd+BzV+KUmRxFttF0GsCrv5+xD/S/NZx9FSaInbS49/NtGKo3N8swnVlwvqmaeAVbZeamwnlPq +qZMC6T5ZSFMgVudRMfwoz0X1Ako9gNPbfleeEmvRygRTW+u39YXJrXOSHA7EJ279fhbhi2+Zwc1y mMAmTvgXFAmJYjJXwijoynL15WkyYysPkyp52rQFbukrTSMhMYk3tKchXSYYrcyaaFVfW3eezSbJc zVeAJG8g==; Received: from mail.kernel.org ([198.145.29.99]) by bombadil.infradead.org with esmtps (Exim 4.94 #2 (Red Hat Linux)) id 1lgoL0-00AM8p-Pq for linux-arm-kernel@lists.infradead.org; Wed, 12 May 2021 12:51:44 +0000 Received: by mail.kernel.org (Postfix) with ESMTPSA id 2272D61026; Wed, 12 May 2021 12:51:42 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1620823902; bh=4ofQsASU/MTwLwGKXLy4pALcxYirc0LvzC8mUKPB/jw=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ehzI2dkTGNdt5gGWNwWX6aEbUWTKTcHsHA94sroT8TDjUq/Q3pkOpjXDQv+s4Yi/s PBHz9zWgtT4LkxetufTeN1UleiUQD/OEl5xiI2fCXEZa9/yG805RxRe76wtalNjJUy GHUCgCdyu+0OsC3NIfKKKTcaaH+kBE8g0Zdz1ZUZl8ZGQNOyYYLKIUk3NqN/JeyJtW m7G2j4ROxj7snXxIU1NczZuchYo/F5ypGxi2gGbX2mrI0+rBWUsyiWaFi9OY8+KpUk k6aDYvX9D1L/hEACwIfirnbguoAcMprcG+OjFdB3vZ9z3ZCUJwE7Lcm/wmhS8+KYFY Cb64hvbzq4zAQ== Received: by mail.kernel.org with local (Exim 4.94.2) (envelope-from ) id 1lgoKy-0018h3-78; Wed, 12 May 2021 14:51:40 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , Fabio Estevam , Frank Li , NXP Linux Team , Pengutronix Kernel Team , Sascha Hauer , Shawn Guo , linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org Subject: [PATCH v2 04/40] docs: admin-guide: perf: imx-ddr.rst: Use ASCII subset instead of UTF-8 alternate symbols Date: Wed, 12 May 2021 14:50:08 +0200 Message-Id: X-Mailer: git-send-email 2.30.2 In-Reply-To: References: MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20210512_055142_936102_9B8A5226 X-CRM114-Status: GOOD ( 15.29 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org The conversion tools used during DocBook/LaTeX/Markdown->ReST conversion and some automatic rules which exists on certain text editors like LibreOffice turned ASCII characters into some UTF-8 alternatives that are better displayed on html and PDF. While it is OK to use UTF-8 characters in Linux, it is better to use the ASCII subset instead of using an UTF-8 equivalent character as it makes life easier for tools like grep, and are easier to edit with the some commonly used text/source code editors. Also, Sphinx already do such conversion automatically outside literal blocks: https://docutils.sourceforge.io/docs/user/smartquotes.html So, replace the occurences of the following UTF-8 characters: - U+201c ('“'): LEFT DOUBLE QUOTATION MARK - U+201d ('”'): RIGHT DOUBLE QUOTATION MARK Signed-off-by: Mauro Carvalho Chehab --- Documentation/admin-guide/perf/imx-ddr.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/admin-guide/perf/imx-ddr.rst b/Documentation/admin-guide/perf/imx-ddr.rst index 90926d0fb8ec..269d0b564903 100644 --- a/Documentation/admin-guide/perf/imx-ddr.rst +++ b/Documentation/admin-guide/perf/imx-ddr.rst @@ -9,7 +9,7 @@ control register which causes a large number of PERF signals to be generated. Selection of the value for each counter is done via the config registers. There is one register for each counter. Counter 0 is special in that it always counts -“time” and when expired causes a lock on itself and the other counters and an +"time" and when expired causes a lock on itself and the other counters and an interrupt is raised. If any other counter overflows, it continues counting, and no interrupt is raised. From patchwork Wed May 12 12:50:10 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 12253529 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-17.7 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,INCLUDES_CR_TRAILER,INCLUDES_PATCH,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id BAA41C433ED for ; Wed, 12 May 2021 12:55:33 +0000 (UTC) Received: from desiato.infradead.org (desiato.infradead.org [90.155.92.199]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 2553A61177 for ; Wed, 12 May 2021 12:55:33 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 2553A61177 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=desiato.20200630; h=Sender:Content-Transfer-Encoding :Content-Type:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To:Message-Id:Date: Subject:Cc:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=PYLHvZnKPkeLXT/doEpGlI9+yvEblH6KPJO6OXuao0o=; b=MkiVEu1K5pcCPxv++j+78JEdm jt018aGqgmkyI6ArG36+9S1NBsuf2rPANVc4+7t4ky1PgL49nwe1oTdZiyi+6O9iQUclBSFBfOtPW HsjVlP9yz9NqAZaFrVz1RKO4S+yBwQYEqnp9/Uqt23lplza/KdRkSMCu6ngFeBCZyTYZkAIRxst61 Er4WUdoKodONsVFIXLoxmih6Gh/Iup2BWh3nibA5X3B0D/yCafjfnuUOrIz3xcW+o3WN5JkoATfY5 f+fD4L1YeD/4eBMYT30JBBJdxK0/ieuLqmORmusVxirkVu3+buMhhBWKEID8jZKGzORQEEkdG9I8P 9t/hRehNw==; Received: from localhost ([::1] helo=desiato.infradead.org) by desiato.infradead.org with esmtp (Exim 4.94 #2 (Red Hat Linux)) id 1lgoMt-002o9B-92; Wed, 12 May 2021 12:53:39 +0000 Received: from bombadil.infradead.org ([2607:7c80:54:e::133]) by desiato.infradead.org with esmtps (Exim 4.94 #2 (Red Hat Linux)) id 1lgoL7-002nbl-AO for linux-arm-kernel@desiato.infradead.org; Wed, 12 May 2021 12:51:49 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Sender:Content-Transfer-Encoding: Content-Type:MIME-Version:References:In-Reply-To:Message-Id:Date:Subject:Cc: To:From:Reply-To:Content-ID:Content-Description; bh=EcfVOb1eTDRxqTt8s1jBvrHX8n1yB2Xt+OakbeuAr7o=; b=E/Ppi/rIEY+kbhY/baofeoY1L+ 7l/lDPoARR8DJtKVeKoeLgYpqWCrCSh4N6nvXTlmMhIDua/PCseajtArxRORzALPUKs8ZZbaL4yQZ gP2pPAn17BB6f0ugJdQms9+i2CMEbJ7zpFqfrUIe3muBc31FMI/aCq2vhFGhgAQRrmwrNev5vh7ej sfXQsX8gm33cSF0H+JyRF6fZdB+dHyxrM1Dy4gLhUOvp99Zb1xBnQmVT+tpb2Dd9qbzUW19bARRgM 289BBMKD04kJdeNQ1B6OqkutHuxMZiBL21es5HnviCAS8e5PjoPweziUEWZvSRY6xpLQAmw1C8BzB uSCVvW5A==; Received: from mail.kernel.org ([198.145.29.99]) by bombadil.infradead.org with esmtps (Exim 4.94 #2 (Red Hat Linux)) id 1lgoL2-00AMAc-D5 for linux-arm-kernel@lists.infradead.org; Wed, 12 May 2021 12:51:48 +0000 Received: by mail.kernel.org (Postfix) with ESMTPSA id 5A87E6192C; Wed, 12 May 2021 12:51:43 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1620823903; bh=a2ciNHKQtdy9yKU7hgq+HbZ1G3BlRKUgnhBsmHQl52Q=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=FhOgSFeSes/0Y4VigsXGqH46I33Iif1FNXc8PCR5FWAYIq0aY0AQAYxB6d7q+zxvC 4DOh6Y8pnik83uGrWspdaaxkO4jSqtSMz0TZb4X7jZrjjP8f8gCiyBPHoiSnU90yRH XsnVdToIuqUqOUVE4H3QO3Dir5vCd/GOpoMJIPSuVV6iTLGfo0e8oeg1gJXnocgLYn vaIhea9QJyjaUZu5Xlj5XDt6ogA2nqcr1rko0GAlYrAJDunmW9okqoJS7V0kzOBk7I ONys0cf7Fihlp2kOAHTRMuPFFpb9uFDj+FaOoUDJOqmk2n81eKk5Hj5zTswx7rFr7r 65GtdzwtYbRwQ== Received: by mail.kernel.org with local (Exim 4.94.2) (envelope-from ) id 1lgoKy-0018hB-9I; Wed, 12 May 2021 14:51:40 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , Leo Yan , Mathieu Poirier , Mike Leach , Suzuki K Poulose , coresight@lists.linaro.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org Subject: [PATCH v2 06/40] docs: trace: coresight: coresight-etm4x-reference.rst: Use ASCII subset instead of UTF-8 alternate symbols Date: Wed, 12 May 2021 14:50:10 +0200 Message-Id: <14c34b8034d4916c5f81c59b6c7f28d622a84bb4.1620823573.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.30.2 In-Reply-To: References: MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20210512_055144_559170_BAC2FD18 X-CRM114-Status: GOOD ( 14.51 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org The conversion tools used during DocBook/LaTeX/Markdown->ReST conversion and some automatic rules which exists on certain text editors like LibreOffice turned ASCII characters into some UTF-8 alternatives that are better displayed on html and PDF. While it is OK to use UTF-8 characters in Linux, it is better to use the ASCII subset instead of using an UTF-8 equivalent character as it makes life easier for tools like grep, and are easier to edit with the some commonly used text/source code editors. Also, Sphinx already do such conversion automatically outside literal blocks: https://docutils.sourceforge.io/docs/user/smartquotes.html So, replace the occurences of the following UTF-8 characters: - U+00a0 (' '): NO-BREAK SPACE - U+2018 ('‘'): LEFT SINGLE QUOTATION MARK - U+2019 ('’'): RIGHT SINGLE QUOTATION MARK Reviewed-by: Mathieu Poirier Signed-off-by: Mauro Carvalho Chehab --- .../coresight/coresight-etm4x-reference.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/Documentation/trace/coresight/coresight-etm4x-reference.rst b/Documentation/trace/coresight/coresight-etm4x-reference.rst index b64d9a9c79df..e8ddfc144d9a 100644 --- a/Documentation/trace/coresight/coresight-etm4x-reference.rst +++ b/Documentation/trace/coresight/coresight-etm4x-reference.rst @@ -15,14 +15,14 @@ Root: ``/sys/bus/coresight/devices/etm`` The following paragraphs explain the association between sysfs files and the ETMv4 registers that they effect. Note the register names are given without -the ‘TRC’ prefix. +the 'TRC' prefix. ---- :File: ``mode`` (rw) :Trace Registers: {CONFIGR + others} :Notes: - Bit select trace features. See ‘mode’ section below. Bits + Bit select trace features. See 'mode' section below. Bits in this will cause equivalent programming of trace config and other registers to enable the features requested. @@ -89,7 +89,7 @@ the ‘TRC’ prefix. :Notes: Pair of addresses for a range selected by addr_idx. Include / exclude according to the optional parameter, or if omitted - uses the current ‘mode’ setting. Select comparator range in + uses the current 'mode' setting. Select comparator range in control register. Error if index is odd value. :Depends: ``mode, addr_idx`` @@ -277,7 +277,7 @@ the ‘TRC’ prefix. :Trace Registers: VICTLR{23:20} :Notes: Program non-secure exception level filters. Set / clear NS - exception filter bits. Setting ‘1’ excludes trace from the + exception filter bits. Setting '1' excludes trace from the exception level. :Syntax: @@ -427,7 +427,7 @@ the ‘TRC’ prefix. :Syntax: ``echo idx > vmid_idx`` - Where idx <  numvmidc + Where idx < numvmidc ---- @@ -628,7 +628,7 @@ the reset parameter:: -The ‘mode’ sysfs parameter. +The 'mode' sysfs parameter. --------------------------- This is a bitfield selection parameter that sets the overall trace mode for the @@ -696,7 +696,7 @@ Bit assignments shown below:- ETM_MODE_QELEM(val) **description:** - ‘val’ determines level of Q element support enabled if + 'val' determines level of Q element support enabled if implemented by the ETM [IDR0] @@ -780,7 +780,7 @@ Bit assignments shown below:- ---- *Note a)* On startup the ETM is programmed to trace the complete address space -using address range comparator 0. ‘mode’ bits 30 / 31 modify this setting to +using address range comparator 0. 'mode' bits 30 / 31 modify this setting to set EL exclude bits for NS state in either user space (EL0) or kernel space (EL1) in the address range comparator. (the default setting excludes all secure EL, and NS EL2) From patchwork Wed May 12 12:50:38 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 12253531 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-17.7 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,INCLUDES_CR_TRAILER,INCLUDES_PATCH,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 92761C433ED for ; Wed, 12 May 2021 12:55:59 +0000 (UTC) Received: from desiato.infradead.org (desiato.infradead.org [90.155.92.199]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id ED79F61026 for ; Wed, 12 May 2021 12:55:58 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org ED79F61026 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=desiato.20200630; h=Sender:Content-Transfer-Encoding :Content-Type:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To:Message-Id:Date: Subject:Cc:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=2bH9tp2uUPjibO9I/Rr0i5cSIbWyPpSjGnWHQtU7LmY=; b=Wh42+iJVyzCXjJSscStKwpy0p l1AC8LGuY1YwK7zt7tXLn/CaSJ0RTdX8jwP/kZJ1gDoq5as3VJrnqCiLY6ALXV0Pj1tsonXpBiVbv cRI0scq/fQzPgIecGZVOAYOvzmtS1NE69pLl3ks7HYUzPu5VJK2oYBL3L84yP5CE3+moDVo2RvLrZ RdXN4jazDsW23ILVp+fAY0qMkkSwawbHFpfS8pzCK9+uQoA+WqZOQFLuKtmI/KBuNY7LB4T1FV/nT FqEWLkVYIsOg9oGRZTawlFqN7hH5qY2sJ+yJlMteR3m3UJf9Rr4HYG9fEI8BbXstUg8l46e0DB5U9 ViqXSTSGw==; Received: from localhost ([::1] helo=desiato.infradead.org) by desiato.infradead.org with esmtp (Exim 4.94 #2 (Red Hat Linux)) id 1lgoNM-002oK0-4u; Wed, 12 May 2021 12:54:08 +0000 Received: from bombadil.infradead.org ([2607:7c80:54:e::133]) by desiato.infradead.org with esmtps (Exim 4.94 #2 (Red Hat Linux)) id 1lgoLB-002ncP-99 for linux-arm-kernel@desiato.infradead.org; Wed, 12 May 2021 12:51:53 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Sender:Content-Transfer-Encoding: Content-Type:MIME-Version:References:In-Reply-To:Message-Id:Date:Subject:Cc: To:From:Reply-To:Content-ID:Content-Description; bh=NFKoMoWGKyW29WOeBCr/X8KoZddP/IabuR7mSNyqQeA=; b=tLYQnsF52/l8YhxupFng+dqAW4 z8GaiUx4HsXf+YF4+jiz1DshEP4nu+TJDjAfVv5mrQlrCWqItm1bdQB4zaJEFRJGsYBlLz4OVEEap Qybm3l3GynWtU8RZoEcFiVSz95SvCtCEqMdee+iG9vJrPjPry2Are+hmmhW1D9gb90eIyvvmMWMAO 4UxQpkNqZRZOp8svED9P8kfIYfsEigrCzK7EDlLBHx7RgKOjuP5aPtGSvYDhC6HQGG8j5xHNKE9MO iXvMBH86oxf3HUxqf2BBSMdCLym8qHdPMieaJtQG+OYplBOAWuSSndpjSvUE6YDQDQPhdsf0mqBZl eqGBZyPA==; Received: from mail.kernel.org ([198.145.29.99]) by bombadil.infradead.org with esmtps (Exim 4.94 #2 (Red Hat Linux)) id 1lgoL6-00AMEI-B2 for linux-arm-kernel@lists.infradead.org; Wed, 12 May 2021 12:51:52 +0000 Received: by mail.kernel.org (Postfix) with ESMTPSA id C70A461411; Wed, 12 May 2021 12:51:47 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1620823907; bh=KTM32Ye2fL9Id0AwrSb2rffCbYWJx7KuFaES6hlu5vM=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Kruu/u5A/QkxqqDE+ru62qmCOYAdppcU1W6wmi4zAlPcy6mKfGryGQS5qu5w63qCj 3+qEdtb+6WX6wb0qoYBxakkuJzq7ubxLRl9PX6auSiI6nN/6Fgki065sgHUFU7RUBT e9U6EWnAV0md1mBj740yGthGxBYO4WA6J4R8GnYhT7jKCPx+xuQcDsPu0N9qTDRQ2B gMt9hojMCxc8v6UoRsyfMweXIShsa5/l10rRfOqJOJFrxoimVO7RmGQ+F9z34K4v95 yQm8WR8c3xktpQb3hMxHE/ouxb9Yyegg26O33m/1Mm66GCoqONVEBjV5BY/d5j4hIV 6ZfI2MKCu5XhQ== Received: by mail.kernel.org with local (Exim 4.94.2) (envelope-from ) id 1lgoL3-0018na-MF; Wed, 12 May 2021 14:51:45 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , Catalin Marinas , Will Deacon , linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org Subject: [PATCH v2 34/40] docs: arm64: arm-acpi.rst: Use ASCII subset instead of UTF-8 alternate symbols Date: Wed, 12 May 2021 14:50:38 +0200 Message-Id: <4ea53cd3be333779091bea0c4680b11b83129f69.1620823573.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.30.2 In-Reply-To: References: MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20210512_055148_510243_C0704704 X-CRM114-Status: GOOD ( 20.32 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org The conversion tools used during DocBook/LaTeX/Markdown->ReST conversion and some automatic rules which exists on certain text editors like LibreOffice turned ASCII characters into some UTF-8 alternatives that are better displayed on html and PDF. While it is OK to use UTF-8 characters in Linux, it is better to use the ASCII subset instead of using an UTF-8 equivalent character as it makes life easier for tools like grep, and are easier to edit with the some commonly used text/source code editors. Also, Sphinx already do such conversion automatically outside literal blocks: https://docutils.sourceforge.io/docs/user/smartquotes.html So, replace the occurences of the following UTF-8 characters: - U+2019 ('’'): RIGHT SINGLE QUOTATION MARK Signed-off-by: Mauro Carvalho Chehab --- Documentation/arm64/arm-acpi.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Documentation/arm64/arm-acpi.rst b/Documentation/arm64/arm-acpi.rst index 47ecb9930dde..ceb109ff82aa 100644 --- a/Documentation/arm64/arm-acpi.rst +++ b/Documentation/arm64/arm-acpi.rst @@ -36,12 +36,12 @@ of the summary text almost directly, to be honest. The short form of the rationale for ACPI on ARM is: -- ACPI’s byte code (AML) allows the platform to encode hardware behavior, +- ACPI's byte code (AML) allows the platform to encode hardware behavior, while DT explicitly does not support this. For hardware vendors, being able to encode behavior is a key tool used in supporting operating system releases on new hardware. -- ACPI’s OSPM defines a power management model that constrains what the +- ACPI's OSPM defines a power management model that constrains what the platform is allowed to do into a specific model, while still providing flexibility in hardware design. @@ -69,7 +69,7 @@ Key to the use of ACPI is the support model. For servers in general, the responsibility for hardware behaviour cannot solely be the domain of the kernel, but rather must be split between the platform and the kernel, in order to allow for orderly change over time. ACPI frees the OS from needing -to understand all the minute details of the hardware so that the OS doesn’t +to understand all the minute details of the hardware so that the OS doesn't need to be ported to each and every device individually. It allows the hardware vendors to take responsibility for power management behaviour without depending on an OS release cycle which is not under their control. @@ -81,7 +81,7 @@ in place. DT does exactly what Linux needs it to when working with vertically integrated devices, but there are no good processes for supporting what the server vendors need. Linux could potentially get there with DT, but doing so really just duplicates something that already works. ACPI already does what -the hardware vendors need, Microsoft won’t collaborate on DT, and hardware +the hardware vendors need, Microsoft won't collaborate on DT, and hardware vendors would still end up providing two completely separate firmware interfaces -- one for Linux and one for Windows.