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.