From patchwork Tue Jul 28 09:07:37 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Niko Mauno X-Patchwork-Id: 93723 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 73DF0C54EFC for ; Tue, 28 Jul 2026 09:08:13 +0000 (UTC) Received: from AS8PR04CU009.outbound.protection.outlook.com (AS8PR04CU009.outbound.protection.outlook.com [52.101.70.79]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.7661.1785229689386398720 for ; Tue, 28 Jul 2026 02:08:10 -0700 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@vaisala.com header.s=selector1 header.b=WnVyMIMz; spf=permerror, err=parse error for token &{10 18 spf.protection.outlook.com}: limit exceeded (domain: vaisala.com, ip: 52.101.70.79, mailfrom: niko.mauno@vaisala.com) ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=cE+OFiPXKzKei+d0w4WvxnokSc3mpBGBpeIpr7QbKpl+Fu5rhGf7ie/1qJzVfX8ujJzpPGrvj90S4TnniEEjGSsk6v12lknkearjnLfvfrl0tFn8ZySD7WeC5nlGcoS8TEc/uC3juytkLg9ZeyfZHobEkEj/HWTy64djWSChya9+N4NNR52Llp96HVCjMcFJWUhQC8s3l5ZNbUb90n5hj8k2KW2+nIQcx+vs6c/vGyLx5ctqPxzqVbCjxS0ziKy/K5EViYdyFL/j/SmNuVzVCYGbXM1NAbj+g0MZhq0ImIIKcLeEVERUuoli20heDSPqfcT1ahIWudTOv638pBF+ZQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=maUfVJFF+AlAvGHtF6bDTxluFhmeFZDM2irTWInropQ=; b=NJYFQHLn0HT1VbUOilbnQTMPoybpbc0D+nb7Uz7bxi+f8IG9GU4blz4sbqdjScfHK/GCpXlK3RC4rdFWNKwVHndCxRe1N+bC2Q3S7YRx8rmGHY2L/yy0Ix/AkLek+vH4QFLuSx8CmYqRspHzpBHRXRD5XXfuQO8+VSmZJ9OWUfjQI25vHxO0DqkE4DIFZ06J7JlM44Qfe0XXs564h6y2JHAejyESt8IuuuUIbvE+BpePL7BGzmyPU0eBZqtxW3SaQKkJsDiu+8xXeGksjXiMjLSkxPgHoC5rBnI5zt6+bN/Tes+PdARJNMPJ0lTePY+IzBpmWfpaFet2zKtt76UHbA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=vaisala.com; dmarc=pass action=none header.from=vaisala.com; dkim=pass header.d=vaisala.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=vaisala.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=maUfVJFF+AlAvGHtF6bDTxluFhmeFZDM2irTWInropQ=; b=WnVyMIMzB7UynO7eBQTH8WOVax3y+YpnMV3Tw3wIWaRQvRAIrwc2EZbBJVWSoFoXFxRKtEurVwMWdxEZTDykJNtix0SIgJAB2Ia67SssYPPormm2ckcoWPOueQFIgF+lkmctXefiMrkl1Yt3Jw6Uu5qWsMI6h08QBallTN+Pg2IehoqDLT+6eQh1caopelzqTwj34anjKdZehEQh1iQ1Pd8jiD6LOMvuN8r1K4Pv1ZhkuYbs/2reT1N+xxfFx+/MXpHbnZqooqdLqrgV/FS1RjpxM2/Q0FS3+ksxmrH9buX+lDjeN9RN5XhIbJzjCvlNC2R0I0uKQh/6nQZFSzoLAA== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=vaisala.com; Received: from AS8PR06MB7557.eurprd06.prod.outlook.com (2603:10a6:20b:337::17) by PA1PR06MB9700.eurprd06.prod.outlook.com (2603:10a6:102:44a::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.21.270.12; Tue, 28 Jul 2026 09:08:03 +0000 Received: from AS8PR06MB7557.eurprd06.prod.outlook.com ([fe80::44ca:1bbb:6b57:4c16]) by AS8PR06MB7557.eurprd06.prod.outlook.com ([fe80::44ca:1bbb:6b57:4c16%4]) with mapi id 15.21.0270.009; Tue, 28 Jul 2026 09:08:03 +0000 From: niko.mauno@vaisala.com To: docs@lists.yoctoproject.org CC: antonin.godard@bootlin.com, quentin.schulz@cherry.de, Niko Mauno , "Claude Opus 4.8 (1M context)" Subject: [PATCH v3 4/5] documentation: Replace non-ASCII confusable characters with ASCII Date: Tue, 28 Jul 2026 12:07:37 +0300 Message-ID: <20260728090746.27793-5-niko.mauno@vaisala.com> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260728090746.27793-1-niko.mauno@vaisala.com> References: <20260728090746.27793-1-niko.mauno@vaisala.com> X-ClientProxiedBy: GVZP280CA0039.SWEP280.PROD.OUTLOOK.COM (2603:10a6:150:26f::7) To AS8PR06MB7557.eurprd06.prod.outlook.com (2603:10a6:20b:337::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AS8PR06MB7557:EE_|PA1PR06MB9700:EE_ X-MS-Office365-Filtering-Correlation-Id: d2ff3d7a-aece-4316-210e-08deec87b9a7 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|366016|52116014|376014|23010399003|1800799024|38350700014|6133799003|56012099006|6123799006|11063799006|10067099003|3023799007|18002099003|22082099003; X-Microsoft-Antispam-Message-Info: TRdNAW+56CvizVH5Oz3ZjHud9TZwdBn3MVF/swxNlbi36Whx293RJBVC7PK8OfdQsdTN1lnsmzYR3T9wqg1OhdmbEb5P1emkPq6ozdHRJ33JkZtpnVGo8yJYtrNwffPqUN6uZXag3BW9DfXJtM4k79eUT0156bTqsOSIvwEil9dtAMCoBsNMm9ZOvrXNmZ1HksiYs2EpVfGgpLtzXHsQkuVAj9RKUQjSVpMGlAYwQllEqNjHv3JbCfxngBORQdoib3W5vmSAuFKEonJvJUy7wSJkel3UBLNYtMUEmst1Bo0jKH1mH/BeD3BHuEF6LJPMSs0hq7f/UEfyFleL5jcfVxtmUzzEBg+z1PK+p4tBdxJVLKXBTGLzdCZezKDoUI4plQ4Z+VmOXJKSKIRmoGCv0lyeSty+kP9jlHDfheiii8FKF+1l6S6g0+fdSu/lZk359mYeIVTsPB75XCSCk2Y9n+0clWbq0UbS8IT2Gtp/X8sIjG6z7394XlMABLizrEPzZZ6085ukb5lp7RGK7Hy6SGCM4xVJVpnuyFCyVD9b+CWL2aiFQt+18dQUG0l8EbO5akzgp5oVb99ydVMb7djXLurXZrACQNWONKxBBBg8L9KtJ6bakF1aUib/kVDjO1rTk64Yg3DSy7YA56TAxuSk1jLg3Mf9nC91fvFp4EDgzuw= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AS8PR06MB7557.eurprd06.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(366016)(52116014)(376014)(23010399003)(1800799024)(38350700014)(6133799003)(56012099006)(6123799006)(11063799006)(10067099003)(3023799007)(18002099003)(22082099003);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: Ocd6/jEfVFV859dSQqVeP7mBintmL7/5Y7sHaiUPcreRZO92RDJtd5nZ33yZLlSwGFkdnfdkJ76vxopeSEczuGywxIpd4HCjx+G6g5iVBLb/knZMwbrs/CYJDQrVxmE6stFessFKvf973yn0lvkg/qAX6/ypOVDj28BBs4kjUc/AMG8vopZ18JQFa0R5qB43kTa5vbJo1SLf7FdmljOtCcZ0SN6+GycnUbe7aLSI3HtLWvDXZVAosJb304JqrVkBzMvbozmD6QoNP9V1KyueCYWNIISsU4Ed/nTipM/UlYL4MAs4OMQs7Ywbn9sUK8B3O4PBlTw+Hp/+E6hF1MdhxixLNCx3JYRph3vWWpjnJ2e6R7to5KoX0s0iQ0A1F1p9l8S5w8iSV8LrIqpS3EsaDgeKkmc/knjtGCAa5pP/ij+WEJEXubIcLRwZT4TdO8c2MwysXwFqcg4bWAPOzvWQ69KXC3xYm/Htmb1h1cat/WZAwZlrOV59uyWgl2Hf2DCD6HRVQUqUMHGdRKNn23a+5xoMWEN0vNkNZ22UmuYHPz7cVJOpDOOkv0X+dg9fp4Lrm7LcoSC/75U+lMxnuOs98CvbmLezNjrYO9RUwb+kdwtFku9zmJbM2rszwuv7VPoPTV22Hb0nrR/meK0gCLKKmr7j2+f9G/R+UZqT4SpDbYjJL18TYJJuK2aQdU5yEuYVkVUBvPKv8gG0eaVL3LI7N5jdTYhiAQOjCN2M/RqYOetUcnsQ6CdOdlcD0Uc4ZcNjiUS0qtDILae7+rsyt9NaMlYgafGxUFfZQqeNm4ps4tbyvavfX0+mVbdrv11/Uf1xwkxSrYAo2Y7cvCyKTNJf19Sbzv+yPuoyhT5foshcqGUOsjxT453HWKaJkW1qa67ZkThu+h+lnujEp3+im4QVllWMe2wzFPMCOLlP+i4O2fVcjweABdfhSuoC+a/otnDBo4N1T4eVqPFcK6IFSFhq7AnXV4jZBAd+zL1PgMeKMQsnN7wrQn79xeadS3glI5H6hZF6u7XegbZkhJOHLFSav3vaWPDOEBRqwc33YUKgKfuYcLKlqMVigR9tiexBESIyzqLnqlxZXT2XwsOL2+mMXvWjoVXinodTFAMuiY2uss32MPcch53hgTfZ+G82x7Errl78P93qMVXh9XDFBLe7nAN7terTzsPMyv+eD7tey6xtL9Y+lq2PIA9JFY11fkg8niItiJMkr8LSznhV/EI9OIWnW/qib2bSmXdTeideYy+eucNYwO8AeZmoNptRGGtF9dxqPRAt5satlFnCbXLQgE7u9TslMPgCxrfkkYFPv5OOxNuStaEp7OA12iOwtAhC1/bu1g/pmgHwonfG6fycTtta4Ksyt3tupJkmdGvfqpcpWRdiIZq1Ye5vQfBsCUAnI0+D6tyCtz0hFcnmZ1H/tf0TOvS4kaIHrUDZsJUBciP/XSmaw1IyYDnfMm8reDjAvpmzic07mdwN6g6OvnSsBD82gUYNmetQrbmSanLCteQa5bk7fK/Y7FFEDnLbstRAXJtEqAlJHsoQFFvWiDqMLNbKaRAVSE2mw+a98vGeRhD+d7fvsvu/hfrk6g91+7c+SbGO8H5OwqrZw9jasJWB9qG8h1pRmoDVLtBtN2lGzBY7ShebMZnFFKpAa/1vDkLjObuUqPSL4xKMux3V+E3K45x1jKhxgwM+9bdTHru3rFjWDCpNg02LuQWarGqY21dsyk8u8U5OC3IVllueohyNK3YmJ9MA40+qy3q3RaxI1aI= X-OriginatorOrg: vaisala.com X-MS-Exchange-CrossTenant-Network-Message-Id: d2ff3d7a-aece-4316-210e-08deec87b9a7 X-MS-Exchange-CrossTenant-AuthSource: AS8PR06MB7557.eurprd06.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 28 Jul 2026 09:08:01.4400 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 6d7393e0-41f5-4c2e-9b12-4c2be5da5c57 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: qRbeD8NgcGpkZH9jaytKoFdvCodwkycZFucFdnLxq6b+Zu7/BgqIcGOcxicZd1exTh+wtUPt7o8NwClZMsNumA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PA1PR06MB9700 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Tue, 28 Jul 2026 09:08:13 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10168 From: Niko Mauno Several documentation sources contain non-ASCII "confusable" characters such as curly quotes, en and em dashes, and non-breaking or zero-width spaces. These look almost identical to their plain ASCII counterparts but break tooling and mislead readers who copy text out of the manuals. For example, the curly double quotes present in the recipe style guide example caused parse errors when copied into an actual recipe: ERROR: ParseError at .../foobar.bb:158: unparsed line: 'RDEPENDS:${PN} = "foo"' and dash substitutions silently corrupt command-line options, turning "--help" and "--dump-signatures" into unusable non-ASCII look-alikes. Replace all such occurrences across the documentation with their regular ASCII equivalents. Legitimate non-ASCII content is left untouched: the box-drawing characters and no-break spaces that the tree command emits in directory listings, accented letters in contributor names, and CJK characters. These occurrences were detected with the documentation/tools/check-confusables script introduced in the following commit. Co-Authored-By: Claude Opus 4.8 (1M context) Signed-off-by: Niko Mauno --- .../contributor-guide/identify-component.rst | 4 ++-- documentation/contributor-guide/index.rst | 4 ++-- .../contributor-guide/recipe-style-guide.rst | 8 ++++---- documentation/contributor-guide/submit-changes.rst | 4 ++-- documentation/dev-manual/build-quality.rst | 2 +- documentation/dev-manual/debugging.rst | 14 +++++++------- documentation/dev-manual/new-recipe.rst | 4 ++-- documentation/kernel-dev/common.rst | 10 +++++----- .../migration-guides/release-notes-4.1.rst | 2 +- documentation/ref-manual/classes.rst | 4 ++-- documentation/ref-manual/devtool-reference.rst | 4 ++-- .../yocto-project-supported-features.rst | 10 +++++----- .../test-manual/yocto-project-compatible.rst | 2 +- .../transitioning-to-a-custom-environment.rst | 2 +- documentation/what-i-wish-id-known.rst | 14 +++++++------- 15 files changed, 44 insertions(+), 44 deletions(-) diff --git a/documentation/contributor-guide/identify-component.rst b/documentation/contributor-guide/identify-component.rst index 6cf8ed985..26308a0e9 100644 --- a/documentation/contributor-guide/identify-component.rst +++ b/documentation/contributor-guide/identify-component.rst @@ -18,5 +18,5 @@ maintainers. If the issue is in the core metadata layer (OpenEmbedded-Core) or in BitBake, issues can be reported in the :yocto_bugs:`Yocto Project Bugzilla <>`. The -:yocto_lists:`yocto ` mailing list is a general “catch-all” location -where questions can be sent if you can’t work out where something should go. +:yocto_lists:`yocto ` mailing list is a general "catch-all" location +where questions can be sent if you can't work out where something should go. diff --git a/documentation/contributor-guide/index.rst b/documentation/contributor-guide/index.rst index a83216945..b374cc1c4 100644 --- a/documentation/contributor-guide/index.rst +++ b/documentation/contributor-guide/index.rst @@ -7,8 +7,8 @@ Yocto Project and OpenEmbedded Contributor Guide The Yocto Project and OpenEmbedded are open-source, community-based projects so contributions are very welcome, it is how the code evolves and everyone can effect change. Contributions take different forms, if you have a fix for an -issue you’ve run into, a patch is the most appropriate way to contribute it. -If you run into an issue but don’t have a solution, opening a defect in +issue you've run into, a patch is the most appropriate way to contribute it. +If you run into an issue but don't have a solution, opening a defect in :yocto_bugs:`Bugzilla <>` or asking questions on the mailing lists might be more appropriate. This guide intends to point you in the right direction to this. diff --git a/documentation/contributor-guide/recipe-style-guide.rst b/documentation/contributor-guide/recipe-style-guide.rst index f81ffb2ab..84c6bb14e 100644 --- a/documentation/contributor-guide/recipe-style-guide.rst +++ b/documentation/contributor-guide/recipe-style-guide.rst @@ -192,11 +192,11 @@ Custom tasks should be sorted similarly. Package specific variables are typically grouped together, e.g.:: - RDEPENDS:${PN} = “foo” - RDEPENDS:${PN}-libs = “bar” + RDEPENDS:${PN} = "foo" + RDEPENDS:${PN}-libs = "bar" - RRECOMMENDS:${PN} = “one” - RRECOMMENDS:${PN}-libs = “two” + RRECOMMENDS:${PN} = "one" + RRECOMMENDS:${PN}-libs = "two" Recipe License Fields --------------------- diff --git a/documentation/contributor-guide/submit-changes.rst b/documentation/contributor-guide/submit-changes.rst index ae7a097ad..48c8af2fe 100644 --- a/documentation/contributor-guide/submit-changes.rst +++ b/documentation/contributor-guide/submit-changes.rst @@ -17,7 +17,7 @@ Both Yocto Project and OpenEmbedded have many key components that are maintained by patches being submitted on mailing lists. We appreciate this approach does look a little old fashioned when other workflows are available through web technology such as GitHub, GitLab and others. Since we are often -asked this question, we’ve decided to document the reasons for using mailing +asked this question, we've decided to document the reasons for using mailing lists. One significant factor is that we value peer review. When a change is proposed @@ -40,7 +40,7 @@ of key people from the project, which would again be to its detriment. The projects are acutely aware that potential new contributors find the mailing list approach off-putting and would prefer a web-based GUI. -Since we don’t believe that can work for us, the project is aiming to ensure +Since we don't believe that can work for us, the project is aiming to ensure `patchwork `__ is available to help track patch status and also looking at how tooling can provide more feedback to users about patch status. We are looking at improving tools such as ``patchtest`` to diff --git a/documentation/dev-manual/build-quality.rst b/documentation/dev-manual/build-quality.rst index c2e46b69c..e9b066c44 100644 --- a/documentation/dev-manual/build-quality.rst +++ b/documentation/dev-manual/build-quality.rst @@ -358,7 +358,7 @@ You can examine build history output from the command line or from a web interface. To see any changes that have occurred (assuming you have -:term:`BUILDHISTORY_COMMIT` = "1"), +:term:`BUILDHISTORY_COMMIT` = "1"), you can simply use any Git command that allows you to view the history of a repository. Here is one method:: diff --git a/documentation/dev-manual/debugging.rst b/documentation/dev-manual/debugging.rst index 21fb10537..3afc17ad4 100644 --- a/documentation/dev-manual/debugging.rst +++ b/documentation/dev-manual/debugging.rst @@ -152,7 +152,7 @@ Shell functions and tasks can also be inspected with the same mechanism:: For Python functions and tasks, ``bitbake -e recipename`` can be used instead. -Moreover, the output of the ``bitbake -e`` and ``bitbake -e`` recipe commands +Moreover, the output of the ``bitbake -e`` and ``bitbake -e`` recipe commands includes the following information: - The output starts with a tree listing all configuration files and @@ -187,7 +187,7 @@ Here are a few of the available ``oe-pkgdata-util`` subcommands. that have been built, optionally limiting the match to packages that match pattern. -- ``oe-pkgdata-util list-pkg-files package ...``: Lists the +- ``oe-pkgdata-util list-pkg-files package ...``: Lists the files and directories contained in the given packages. .. note:: @@ -205,7 +205,7 @@ Here are a few of the available ``oe-pkgdata-util`` subcommands. directory, make sure that :ref:`ref-classes-rm-work` is not enabled when you build the recipe. -- ``oe-pkgdata-util find-path path ...``: Lists the names of +- ``oe-pkgdata-util find-path path ...``: Lists the names of the packages that contain the given paths. For example, the following tells us that ``/usr/share/man/man1/make.1`` is contained in the ``make-doc`` package:: @@ -213,7 +213,7 @@ Here are a few of the available ``oe-pkgdata-util`` subcommands. $ oe-pkgdata-util find-path /usr/share/man/man1/make.1 make-doc: /usr/share/man/man1/make.1 -- ``oe-pkgdata-util lookup-recipe package ...``: Lists the name +- ``oe-pkgdata-util lookup-recipe package ...``: Lists the name of the recipes that produce the given packages. For more information on the ``oe-pkgdata-util`` command, use the help @@ -362,7 +362,7 @@ You can also use BitBake to dump out the signature construction information without executing tasks by using either of the following BitBake command-line options:: - ‐‐dump-signatures=SIGNATURE_HANDLER + --dump-signatures=SIGNATURE_HANDLER -S SIGNATURE_HANDLER @@ -1072,7 +1072,7 @@ debugger. the actual image (e.g. ``gdb-cross-i586``). The suggestion is usually the actual name you want to use. -#. *Set up the* ``debugfs``\ *:* +#. *Set up the* ``debugfs``\ *:* Run the following commands to set up the ``debugfs``:: @@ -1106,7 +1106,7 @@ debugger. .. code-block:: shell - root@qemux86:~# gdbserver localhost:1234 /bin/gzip —help + root@qemux86:~# gdbserver localhost:1234 /bin/gzip --help For additional gdbserver options, see the `GDB Server diff --git a/documentation/dev-manual/new-recipe.rst b/documentation/dev-manual/new-recipe.rst index 6888bb46a..d1c863117 100644 --- a/documentation/dev-manual/new-recipe.rst +++ b/documentation/dev-manual/new-recipe.rst @@ -99,14 +99,14 @@ command:: otherwise $EDITOR, otherwise vi. Use recipetool --help to get help on a specific command -Running ``recipetool create -o OUTFILE`` creates the base recipe and +Running ``recipetool create -o OUTFILE`` creates the base recipe and locates it properly in the layer that contains your source files. Here are some syntax examples: - Use this syntax to generate a recipe based on source. Once generated, the recipe resides in the existing source code layer:: - recipetool create -o OUTFILE source + recipetool create -o OUTFILE source - Use this syntax to generate a recipe using code that you extract from source. The extracted code is placed in its own layer diff --git a/documentation/kernel-dev/common.rst b/documentation/kernel-dev/common.rst index 136524e63..4e7d015e4 100644 --- a/documentation/kernel-dev/common.rst +++ b/documentation/kernel-dev/common.rst @@ -577,7 +577,7 @@ applies the new configuration before building the kernel. For a detailed example showing how to configure the kernel, see the ":ref:`kernel-dev/common:configuring the kernel`" section. -Using an "In-Tree"  ``defconfig`` File +Using an "In-Tree" ``defconfig`` File -------------------------------------- It might be desirable to have kernel configuration fragment support @@ -973,7 +973,7 @@ possible. For more information on kernel configuration, see the ":ref:`kernel-dev/common:changing the configuration`" section. -Using  ``menuconfig`` +Using ``menuconfig`` --------------------- The easiest way to define kernel configurations is to set them through @@ -1079,7 +1079,7 @@ kernel layer. Be sure to make a copy of the ``.config`` file and do not just rename it. The build system needs an existing ``.config`` file from which to work. -Creating a  ``defconfig`` File +Creating a ``defconfig`` File ------------------------------ A ``defconfig`` file in the context of the Yocto Project is often a @@ -1708,12 +1708,12 @@ Showing a Particular Feature or Branch Change --------------------------------------------- Tags in the Yocto Project kernel tree divide changes for significant -features or branches. The ``git show`` tag command shows changes based +features or branches. The ``git show`` tag command shows changes based on a tag. Here is an example that shows ``systemtap`` changes:: $ git show systemtap -You can use the ``git branch --contains`` tag command to +You can use the ``git branch --contains`` tag command to show the branches that contain a particular feature. This command shows the branches that contain the ``systemtap`` feature:: diff --git a/documentation/migration-guides/release-notes-4.1.rst b/documentation/migration-guides/release-notes-4.1.rst index 81d541fac..4a3fb0d2c 100644 --- a/documentation/migration-guides/release-notes-4.1.rst +++ b/documentation/migration-guides/release-notes-4.1.rst @@ -191,7 +191,7 @@ Known Issues in 4.1 ~~~~~~~~~~~~~~~~~~~ - The change to :ref:`migration-4.1-complementary-deps` means that images - built with the ``ptest-pkgs`` :term:`IMAGE_FEATURES` don’t automatically + built with the ``ptest-pkgs`` :term:`IMAGE_FEATURES` don't automatically install ``ptest-runner``, as that package is a recommendation of the individual ``-ptest`` packages. This will be resolved in the next point release, and can be worked around by explicitly installing ``ptest-runner`` diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index 98dff1bac..f3d1aa64e 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst @@ -152,7 +152,7 @@ barebox, enabling tasks such as :ref:`ref-tasks-menuconfig` and The generated barebox binaries are deployed to :term:`DEPLOY_DIR_IMAGE` as well as installed to ``BAREBOX_INSTALL_PATH`` -(``/boot`` by default) making them part of the recipe’s base package. +(``/boot`` by default) making them part of the recipe's base package. This setup supports both using the barebox binaries as independent artifacts and installing them into a rootfs. :term:`BAREBOX_BINARY` can be used to select a distinct binary to deploy and @@ -3687,7 +3687,7 @@ for details. The :ref:`ref-classes-upstream-stable-release-point` class automatically generates the :term:`UPSTREAM_STABLE_RELEASE_REGEX` variable for recipes whose version uses a dot-separated scheme. This enables stable point release -upgrades — version upgrades constrained to the same stable series (e.g. +upgrades -- version upgrades constrained to the same stable series (e.g. ``1.4.2`` to ``1.4.3`` but not to ``1.5.0``). The class uses the :term:`STABLE_VERSION_PARTS` variable (defaults to ``"2"``) diff --git a/documentation/ref-manual/devtool-reference.rst b/documentation/ref-manual/devtool-reference.rst index 863825b06..6b21d302f 100644 --- a/documentation/ref-manual/devtool-reference.rst +++ b/documentation/ref-manual/devtool-reference.rst @@ -517,7 +517,7 @@ Deploying Your Software on the Target Machine Use the ``devtool deploy-target`` command to deploy the recipe's build output to the live target machine:: - $ devtool deploy-target recipe target + $ devtool deploy-target recipe target The target is the address of the target machine, which must be running an SSH server (i.e. ``user@hostname[:destdir]``). @@ -588,7 +588,7 @@ command to work, you must have previously used the ":ref:`devtool deploy-target `" command:: - $ devtool undeploy-target recipe target + $ devtool undeploy-target recipe target The target is the address of the target machine, which must be running an SSH server (i.e. diff --git a/documentation/ref-manual/yocto-project-supported-features.rst b/documentation/ref-manual/yocto-project-supported-features.rst index d7229f1c2..e209e54c4 100644 --- a/documentation/ref-manual/yocto-project-supported-features.rst +++ b/documentation/ref-manual/yocto-project-supported-features.rst @@ -164,7 +164,7 @@ to support, however there isn't wide enough interest and support to justify testing all incoming changes on it. There are however project member organisations and maintainers willing to run tests and review fixes. -This category may be applicable as support/usage in an area develops and grows, +This category may be applicable as support/usage in an area develops and grows, or as support/usage fades but we continue to have tests. It can also apply where resourcing isn't available for full primary support but there is member/maintainer support for running tests. @@ -173,21 +173,21 @@ We therefore have the following criteria and policies for such items: - It can be clearly isolated and defined by specific configuration. -- There is a clear documented group of maintainers agreeing to maintain it. +- There is a clear documented group of maintainers agreeing to maintain it. - Those maintainers are active and responsive. - It is being actively and publicly tested (potentially using - the :ref:`Autobuilder ` + the :ref:`Autobuilder ` by agreement, or otherwise). -- Testing would not be part of standard incoming change testing and regressions +- Testing would not be part of standard incoming change testing and regressions would not block incoming patches. - The :yocto_wiki:`SWAT ` team would not handle any test builds on the Autobuilder. -- Test results can be submitted as part of the release process if desired. +- Test results can be submitted as part of the release process if desired. The Yocto Project :yocto_wiki:`Technical Steering Committee (TSC) ` makes decisions on features in this status and Autobuilder testing. Such support would diff --git a/documentation/test-manual/yocto-project-compatible.rst b/documentation/test-manual/yocto-project-compatible.rst index 7a2e00a99..b4da178ec 100644 --- a/documentation/test-manual/yocto-project-compatible.rst +++ b/documentation/test-manual/yocto-project-compatible.rst @@ -115,7 +115,7 @@ Here are key best practices the program tries to encourage: user changes a configuration setting to activate the layer, by selecting a :term:`MACHINE`, a :term:`DISTRO` or a :term:`DISTRO_FEATURES` setting. -- Layers should be documenting where they don’t support normal "core" +- Layers should be documenting where they don't support normal "core" functionality such as where debug symbols are disabled or missing, where development headers and on-target library usage may not work or where functionality like the SDK/eSDK would not be expected to work. diff --git a/documentation/transitioning-to-a-custom-environment.rst b/documentation/transitioning-to-a-custom-environment.rst index c69ab5361..b4dbc5224 100644 --- a/documentation/transitioning-to-a-custom-environment.rst +++ b/documentation/transitioning-to-a-custom-environment.rst @@ -33,7 +33,7 @@ Transitioning to a custom environment for systems development Layer Index <>` to find and acquire the best BSP for your target board. The Yocto Project layer index BSPs are regularly validated. The best place to get your first BSP is from your silicon manufacturer or board - vendor – they can point you to their most qualified efforts. In general, for + vendor - they can point you to their most qualified efforts. In general, for Intel silicon use ``meta-intel``, for Texas Instruments use ``meta-ti``, and so forth. Choose a BSP that has been tested with the same Yocto Project release that you've downloaded. Be aware that some BSPs may not be immediately diff --git a/documentation/what-i-wish-id-known.rst b/documentation/what-i-wish-id-known.rst index d89f43304..a8b9fabad 100644 --- a/documentation/what-i-wish-id-known.rst +++ b/documentation/what-i-wish-id-known.rst @@ -86,13 +86,13 @@ contact us with other suggestions. pinpoint where trouble is occurring and how the build is breaking. The workflow breaks down into the following steps: - #. Fetch – get the source code - #. Extract – unpack the sources - #. Patch – apply patches for bug fixes and new capability - #. Configure – set up your environment specifications - #. Build – compile and link - #. Install – copy files to target directories - #. Package – bundle files for installation + #. Fetch - get the source code + #. Extract - unpack the sources + #. Patch - apply patches for bug fixes and new capability + #. Configure - set up your environment specifications + #. Build - compile and link + #. Install - copy files to target directories + #. Package - bundle files for installation During "fetch", there may be an inability to find code. During "extract", there is likely an invalid zip or something similar. In other words, the