From patchwork Sun Aug 9 14:17:27 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Luc Van Oostenryck X-Patchwork-Id: 11706703 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 739D613B1 for ; Sun, 9 Aug 2020 14:17:40 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 5B304206B2 for ; Sun, 9 Aug 2020 14:17:40 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="sDoU+IlG" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726070AbgHIORj (ORCPT ); Sun, 9 Aug 2020 10:17:39 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:59940 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726175AbgHIORi (ORCPT ); Sun, 9 Aug 2020 10:17:38 -0400 Received: from mail-ej1-x643.google.com (mail-ej1-x643.google.com [IPv6:2a00:1450:4864:20::643]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C6082C061786 for ; Sun, 9 Aug 2020 07:17:37 -0700 (PDT) Received: by mail-ej1-x643.google.com with SMTP id d6so6851012ejr.5 for ; Sun, 09 Aug 2020 07:17:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=Z07cW8utdJEcPvKuXVNT/s9ZRb1SDVVIxJFl5jIO414=; b=sDoU+IlGsrM6li745dBjrcwr1RGW5yeBgt93tGxMw/UuGG3rznNmiYFxPwQqWC9xTV cyJgEO+sbzKOC1w0xUJTm8Ew5F8u4htdIj7o1KN9a+5wlSxjtO8dc73PRP1rsgjlFtNY tVHdmkLnt3a9aAEBu+9Do6sEvb982MOKkl0OtV5twG/pgIZIv7URZ8tHu8UNPSusOY0Q 8MIcPmYUa8KGZatIzp+VYcBtwYwazBycyUwTKrLM9rZ0Q2rmf7oW4ga6eZqsXp5d/zvf a72h+/HgcogN98rU7WVpK6V6t2E85Tzn3ZyfQfl/npZAZ/OPo9KK+SaV61hPXcTl1MOC Kkvg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=Z07cW8utdJEcPvKuXVNT/s9ZRb1SDVVIxJFl5jIO414=; b=Y8iFUR6lixax9Atbd84JP0nQ3b1jKeJDl4Z1YdOgdQsSQFB4JlLo0fRROCYB74EITM 3l0pKC4PEVKNJnYPQcpDDdmzaZkc9GmTfKIwHmWtahSFTrx6OiC6U0vTMrdCyomi3SX5 7sFDI9DMiJ2AhRvukHo/G0+0LvLxC/V5dlJZr0jdAW41KEPVg8fntm81d67WML+3R9zs KBjBZZ/7wNztGoXYcL+nd0A5PMkYM7S9+bt8AfZaPUKiEQTbojfasrsFeipqNeW4kDYz MvxqEbFEV3O+mcJ6Lit3py1qUc0NeASs+455LS8ZQ5C4hPrZ3sqU0HeJRm2AlABzcRQg pjOg== X-Gm-Message-State: AOAM532c2AlHYqQ6f+PZrVB5dpcO7fA1Qn67P9aar0sMhpeCVJP/xCUV oZqx08vSKCpRCAYWvDewiT/2QBds X-Google-Smtp-Source: ABdhPJxoRJ+VBVM9zblH4M9LJyMRm1DQCFgYc8fS2VMKrAQmoY1m3dlxqeg+guWvJSEY10Nhm87/Rw== X-Received: by 2002:a17:906:f0cc:: with SMTP id dk12mr17034748ejb.97.1596982656111; Sun, 09 Aug 2020 07:17:36 -0700 (PDT) Received: from localhost.localdomain ([2a02:a03f:a7fb:e200:788a:816d:ff27:8087]) by smtp.gmail.com with ESMTPSA id p1sm9917956edu.11.2020.08.09.07.17.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 09 Aug 2020 07:17:35 -0700 (PDT) From: Luc Van Oostenryck To: linux-sparse@vger.kernel.org Cc: Luc Van Oostenryck Subject: [PATCH 1/5] doc: replace nocast-vs-bitwise document with its lore link Date: Sun, 9 Aug 2020 16:17:27 +0200 Message-Id: <20200809141731.32433-2-luc.vanoostenryck@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20200809141731.32433-1-luc.vanoostenryck@gmail.com> References: <20200809141731.32433-1-luc.vanoostenryck@gmail.com> MIME-Version: 1.0 Sender: linux-sparse-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-sparse@vger.kernel.org The nocast-vs-bitwise document was copied here to be sure to remain accessible but isn't really useful here now because: 1) the original document have also been archived to lore.kernel.org 2) nocast & bitwise have now been documented 3) 2) contains a link to 1) So, remove this redundant document. Signed-off-by: Luc Van Oostenryck --- Documentation/index.rst | 1 - Documentation/nocast-vs-bitwise.md | 43 ------------------------------ 2 files changed, 44 deletions(-) diff --git a/Documentation/index.rst b/Documentation/index.rst index 9c76419ba5dd..cbe0521b7091 100644 --- a/Documentation/index.rst +++ b/Documentation/index.rst @@ -69,7 +69,6 @@ User documentation :maxdepth: 1 annotations - nocast-vs-bitwise Developer documentation ----------------------- diff --git a/Documentation/nocast-vs-bitwise.md b/Documentation/nocast-vs-bitwise.md deleted file mode 100644 index 9ba5a789fc26..000000000000 --- a/Documentation/nocast-vs-bitwise.md +++ /dev/null @@ -1,43 +0,0 @@ -__nocast vs __bitwise -===================== - -`__nocast` warns about explicit or implicit casting to different types. -HOWEVER, it doesn't consider two 32-bit integers to be different -types, so a `__nocast int` type may be returned as a regular `int` -type and then the `__nocast` is lost. - -So `__nocast` on integer types is usually not that powerful. It just -gets lost too easily. It's more useful for things like pointers. It -also doesn't warn about the mixing: you can add integers to `__nocast` -integer types, and it's not really considered anything wrong. - -`__bitwise` ends up being a *stronger integer separation*. That one -doesn't allow you to mix with non-bitwise integers, so now it's much -harder to lose the type by mistake. - -So the basic rule is: - -- `__nocast` on its own tends to be more useful for *big* integers - that still need to act like integers, but you want to make it much - less likely that they get truncated by mistake. So a 64-bit integer - that you don't want to mistakenly/silently be returned as `int`, for - example. But they mix well with random integer types, so you can add - to them etc without using anything special. However, that mixing also - means that the `__nocast` really gets lost fairly easily. - -- `__bitwise` is for *unique types* that cannot be mixed with other - types, and that you'd never want to just use as a random integer (the - integer `0` is special, though, and gets silently accepted - it's - kind of like `NULL` for pointers). So `gfp_t` or the `safe endianness` - types would be `__bitwise`: you can only operate on them by doing - specific operations that know about *that* particular type. - -Generally, you want `__bitwise` if you are looking for type safety. -`__nocast` really is pretty weak. - -Reference: ----------- - -* Linus' e-mail about `__nocast` vs `__bitwise`: - - From patchwork Sun Aug 9 14:17:28 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Luc Van Oostenryck X-Patchwork-Id: 11706705 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id D3545138C for ; Sun, 9 Aug 2020 14:17:40 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id BC076206B6 for ; Sun, 9 Aug 2020 14:17:40 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="gry5PTbi" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726207AbgHIORk (ORCPT ); Sun, 9 Aug 2020 10:17:40 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:59946 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726175AbgHIORj (ORCPT ); Sun, 9 Aug 2020 10:17:39 -0400 Received: from mail-ed1-x542.google.com (mail-ed1-x542.google.com [IPv6:2a00:1450:4864:20::542]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 30D0CC061756 for ; Sun, 9 Aug 2020 07:17:39 -0700 (PDT) Received: by mail-ed1-x542.google.com with SMTP id df16so4566822edb.9 for ; Sun, 09 Aug 2020 07:17:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=vMR958jp0vJQLVfI8K9AS2+BZAqdKo73Q3KMou+/moQ=; b=gry5PTbivruLgld4ypi/vmVPyk8xtr+NuWfI6p1m5CV44pQnMiPkXfn5mHex3fLn1v Ci05jjqRp3wzsjdwm5xnN9K3NA6IZbC6iGEMByeuvdWypVFCa+0l+Mai7QxB1gYkfIgs si9ObMddq0RvK2mAJddF2Bk5vHGq0vYYbSQHt61+cZUQam3rdIugsOJ58ocu3zoq3244 p/lW2PcrKVbXz6iTLwaWt1DlcNOS76HYJi4YUMtyhMrQTt0EAoW2YZ/FAQXSgERr0p9f kAYUUCuNDMH1wgroTA01Zv1uQfzDTwf4lFRHgULVux6ES8Pr0Q+H3OJXm4xr1yciuTu5 dfug== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=vMR958jp0vJQLVfI8K9AS2+BZAqdKo73Q3KMou+/moQ=; b=Bw0wPOJCLBI7WXaaUJ6WVQ72DoZZQ05q2tuUghQzMuwRyjzxTuEjeUihhibUl4N1B3 gA0GTn3aWsWzaB0zvHzoFpmAchAyh+tXR/EbFUHmthR7rHAN091QRjambTcC9fhqiabs 0xlwNZqYrl8t0OonHJEbqB8rXOlt2xjHX2OLQyoEazqEnWJhsWorNGwoqOL0HsN8M3fu epDaEd8I+v44Uu6wl9dSE6Yug00YNlVoLjRxoLCuZgN4EAMkbgL+Xq0ripRU5GocOswi cS7yeCMU/92QVPpr35UE3Dx6xB4BvQsQAcdZgI0pZyCis8eUswE4smwA94zzgmyrYMFD 1XiQ== X-Gm-Message-State: AOAM531RJVDwG/PGoaqH887+Ggv+c17w2WYDV/Wc3kqDE1RPt6tIpukL xlpiKGnQl+7d0Kf9+yc6vBO5gmbj X-Google-Smtp-Source: ABdhPJxLVceopFBtPML8e9QrADIlcLPR9LEk4E6tl6oL5ZsoDNDCyxtNpY3XZhGZZaSjC0O37W1jyg== X-Received: by 2002:a05:6402:1386:: with SMTP id b6mr1077777edv.296.1596982657676; Sun, 09 Aug 2020 07:17:37 -0700 (PDT) Received: from localhost.localdomain ([2a02:a03f:a7fb:e200:788a:816d:ff27:8087]) by smtp.gmail.com with ESMTPSA id p1sm9917956edu.11.2020.08.09.07.17.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 09 Aug 2020 07:17:37 -0700 (PDT) From: Luc Van Oostenryck To: linux-sparse@vger.kernel.org Cc: Luc Van Oostenryck Subject: [PATCH 2/5] doc: simplify the toctree Date: Sun, 9 Aug 2020 16:17:28 +0200 Message-Id: <20200809141731.32433-3-luc.vanoostenryck@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20200809141731.32433-1-luc.vanoostenryck@gmail.com> References: <20200809141731.32433-1-luc.vanoostenryck@gmail.com> MIME-Version: 1.0 Sender: linux-sparse-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-sparse@vger.kernel.org Combine the 'user' documentation with the one for developers and add captions for each sections in order to have this structuration visible in the sidebar. Signed-off-by: Luc Van Oostenryck --- Documentation/index.rst | 28 +++++++--------------------- 1 file changed, 7 insertions(+), 21 deletions(-) diff --git a/Documentation/index.rst b/Documentation/index.rst index cbe0521b7091..e8e40c0cd109 100644 --- a/Documentation/index.rst +++ b/Documentation/index.rst @@ -63,42 +63,28 @@ To subscribe to the list, send an email with Bugs can also be reported and tracked via the Linux kernel's bugzilla: http://bugzilla.kernel.org/enter_bug.cgi?component=Sparse&product=Tools. -User documentation ------------------- -.. toctree:: - :maxdepth: 1 - - annotations -Developer documentation ------------------------ .. toctree:: + :caption: Documentation :maxdepth: 1 - test-suite + annotations dev-options + types api IR - types + test-suite + doc-guide -How to contribute ------------------ .. toctree:: + :caption: How to contribute :maxdepth: 1 submitting-patches TODO -Documentation -------------- -.. toctree:: - :maxdepth: 1 - - doc-guide - -Release Notes -------------- .. toctree:: + :caption: Release Notes :maxdepth: 1 release-notes/index From patchwork Sun Aug 9 14:17:29 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Luc Van Oostenryck X-Patchwork-Id: 11706707 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id E5A3813B1 for ; Sun, 9 Aug 2020 14:17:43 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id CEA00206B6 for ; Sun, 9 Aug 2020 14:17:43 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="ivaNQ3sz" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726242AbgHIORn (ORCPT ); Sun, 9 Aug 2020 10:17:43 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:59952 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726175AbgHIORl (ORCPT ); Sun, 9 Aug 2020 10:17:41 -0400 Received: from mail-ej1-x641.google.com (mail-ej1-x641.google.com [IPv6:2a00:1450:4864:20::641]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 7BF96C061756 for ; Sun, 9 Aug 2020 07:17:40 -0700 (PDT) Received: by mail-ej1-x641.google.com with SMTP id t10so2484115ejs.8 for ; Sun, 09 Aug 2020 07:17:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=tihCaIaZ8hO8FrGKsGmEVleU+9e1Nh2kqy6MJhKG7B0=; b=ivaNQ3szIjcJwCQtSIPpQFimUWq15bm6Q+6zErXOQcYomcPHIVxKP2LHaWqfweTzkG JJojF4HevIAi43s0vS/PXO8DQQBNjumY7MRBByd4qhYSlyHXoDcW4CyOVV5LvVF1sBMa t+iFurLDDhPQsVUyYyNaKlSQIOfFJKXBsi9GnODhtV71MDZfvFO61lSZEqKQj5A1W5Gx 71xcjnMaGfL75WiZhAxE6I734R+sb3r+fA6U6D8Ai2eXsWCQncyo2X8zcwIlsdItGS2L McjE46gfs/uVgXSlODh/BJ0gcS8KZQwniMaJN15l+y46UNX6Q8HPJJOokYLcauDiY6sl Ko/A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=tihCaIaZ8hO8FrGKsGmEVleU+9e1Nh2kqy6MJhKG7B0=; b=LzNJTvXT9XWF9zH9v4vq1NH/H+WkeTfVu0qMKKCsxZgkwDGRRrW0EPgiYpiIraretH M9ssC4awyrVX3mSBjRUY82HMgzxbzcvaCbfeUqft8mtL4DD1RykN04Ls9rPxeFOS5CfO JENG0AzShPQKz5YiSWv6/hem3cAREtbmjxYGbOBfIb3lmgvyhNIYFWU6Srx41qKNWomX PnLlWIeO8fRwraWnnvlg6srM4S7ym3K2TgaJ6+gC6hisR28eQUQbClymPMhY8UAvTTgT f4+QVWy+q1OdwoAbQSnTTiCEA7CIkXBVXcv2+8rb9jPrZ65cmq5Cx62f9L3ZbKknshZH PKqA== X-Gm-Message-State: AOAM530NnLaFm4IpmA+tSKSGltXQZwOMyUGev97zMqBqdDDU+Ual5qDr PTQQv0AR5RUX9ka3BKbAQ7STRieU X-Google-Smtp-Source: ABdhPJwTnh2ZL92U9IEH0XNcZ0E/Sknse7xQso6mTCsYXDCMNXrscOrW429HVOxZAtdKxqtFhMiwRg== X-Received: by 2002:a17:906:9512:: with SMTP id u18mr15960602ejx.207.1596982658966; Sun, 09 Aug 2020 07:17:38 -0700 (PDT) Received: from localhost.localdomain ([2a02:a03f:a7fb:e200:788a:816d:ff27:8087]) by smtp.gmail.com with ESMTPSA id p1sm9917956edu.11.2020.08.09.07.17.37 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 09 Aug 2020 07:17:38 -0700 (PDT) From: Luc Van Oostenryck To: linux-sparse@vger.kernel.org Cc: Luc Van Oostenryck Subject: [PATCH 3/5] doc: add index to the sidebar Date: Sun, 9 Aug 2020 16:17:29 +0200 Message-Id: <20200809141731.32433-4-luc.vanoostenryck@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20200809141731.32433-1-luc.vanoostenryck@gmail.com> References: <20200809141731.32433-1-luc.vanoostenryck@gmail.com> MIME-Version: 1.0 Sender: linux-sparse-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-sparse@vger.kernel.org It's very useful to be able to access the index from the sidebar but no change in the configuration seems to allow this. Trying to abuse the toctree give the same result. So, add it directly via the template system. Signed-off-by: Luc Van Oostenryck --- Documentation/templates/layout.html | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Documentation/templates/layout.html b/Documentation/templates/layout.html new file mode 100644 index 000000000000..a2fe215fcef6 --- /dev/null +++ b/Documentation/templates/layout.html @@ -0,0 +1,8 @@ +{% extends "!layout.html" %} +{% block menu %} + {{ super() }} +

Index

+ +{% endblock %} From patchwork Sun Aug 9 14:17:30 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Luc Van Oostenryck X-Patchwork-Id: 11706709 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 2F3DD13B1 for ; Sun, 9 Aug 2020 14:17:45 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 1842F206B6 for ; Sun, 9 Aug 2020 14:17:45 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="BGf/B7/A" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726293AbgHIORn (ORCPT ); Sun, 9 Aug 2020 10:17:43 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:59954 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726210AbgHIORl (ORCPT ); Sun, 9 Aug 2020 10:17:41 -0400 Received: from mail-ej1-x643.google.com (mail-ej1-x643.google.com [IPv6:2a00:1450:4864:20::643]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 6E2EEC061786 for ; Sun, 9 Aug 2020 07:17:41 -0700 (PDT) Received: by mail-ej1-x643.google.com with SMTP id t10so2484142ejs.8 for ; Sun, 09 Aug 2020 07:17:41 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=eyH1x57reXpzJnCyTr9Yv867+dI1WVPFqwezGVLbo+8=; b=BGf/B7/AijCL6iPLZWWeexhCf1qcxKPulMTS3M+KqsOMj68gyWOW2++NKHjPh8L9wn 4IF25Fgk03KmZ7gzK+o+8SUqHFeZOM5qPq4OAtULsoizRETFwf1HSXJvNVnHr5SnZh5e IFHVuv7r4sE9eiyRSC9xcKn82Eh0zhQoFV47Tx3dksvbPGKETe/rXPX7qwY9R7dUH024 ehRu8aZADr/PZsV949dDVvpT/4QXDScm2TKvA5PSMjgYm68B1krGZUgWBu3nZCxt9osS q2oC/jpPNOeyDkp4NDBFGvCNi+TsLJHBQdt4feN1TyDP29cQ0YpX1Ba9Jqp6+W9p8ucR IfAA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=eyH1x57reXpzJnCyTr9Yv867+dI1WVPFqwezGVLbo+8=; b=W0mxe8uVtuBGLiJl0Arv6adImHlJyZx8ImYA1h2LLQVyZk1t1U5TeXEiSYGH3qlDRk xxfeG5g0vfPuub+LviwJyoVoqyead66pEYKSF4jFsqwoNvQjWI1/f8iVr/iDuUxnhZYM WbiGo7x3T1wGpWnOkOupLac7UP4Pw6ll9VP6KF35F3XmsqEn0Doj5sSQPFg2GPHRJmbr c6Ta8PXynTz+yK2Ryw68h4eKDLqhtquNaA4G2mGyl6/Sha1cL8MWoLAqWjiQz0pqXmTi 340msXTHel4C2eFQ/2ciicwBYTFMAE85FEIuQLfCrfJ6vgjBZDApQ2OWT0WAo8hTHhhq 2jKQ== X-Gm-Message-State: AOAM5309Mtur20G84BzdygGylpsqM2vwbGqEtMLLA4dqFmVhcyBCI9WM isGfDiLDQiDz0Cu75xOcZEWsB2iR X-Google-Smtp-Source: ABdhPJzwnP5pJOQ+EisOvjhB6akqNgqdmAcGYZF4NiQX+/1OJXJRTnO6kmZuzWPuC7ge5yJNF+Qn/A== X-Received: by 2002:a17:906:3790:: with SMTP id n16mr17595543ejc.256.1596982659931; Sun, 09 Aug 2020 07:17:39 -0700 (PDT) Received: from localhost.localdomain ([2a02:a03f:a7fb:e200:788a:816d:ff27:8087]) by smtp.gmail.com with ESMTPSA id p1sm9917956edu.11.2020.08.09.07.17.39 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 09 Aug 2020 07:17:39 -0700 (PDT) From: Luc Van Oostenryck To: linux-sparse@vger.kernel.org Cc: Luc Van Oostenryck Subject: [PATCH 4/5] doc: remove link "edit on github" Date: Sun, 9 Aug 2020 16:17:30 +0200 Message-Id: <20200809141731.32433-5-luc.vanoostenryck@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20200809141731.32433-1-luc.vanoostenryck@gmail.com> References: <20200809141731.32433-1-luc.vanoostenryck@gmail.com> MIME-Version: 1.0 Sender: linux-sparse-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-sparse@vger.kernel.org since the development isn't done on github, the link "edit on github" is useless and confusing. So remove this link (but leave the one "View page source" as it's sometimes quite handy). Signed-off-by: Luc Van Oostenryck --- Documentation/templates/breadcrumbs.html | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/Documentation/templates/breadcrumbs.html b/Documentation/templates/breadcrumbs.html new file mode 100644 index 000000000000..4f22fa9a8163 --- /dev/null +++ b/Documentation/templates/breadcrumbs.html @@ -0,0 +1,11 @@ +{%- extends "sphinx_rtd_theme/breadcrumbs.html" %} + +{% block breadcrumbs_aside %} + {% if hasdoc(pagename) %} +
  • + {% if show_source and has_source and sourcename %} + {{ _('View page source') }} + {% endif %} +
    • + {% endif %} +{% endblock %} From patchwork Sun Aug 9 14:17:31 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Luc Van Oostenryck X-Patchwork-Id: 11706711 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 528C5138C for ; Sun, 9 Aug 2020 14:17:45 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 3B0012070B for ; Sun, 9 Aug 2020 14:17:45 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="gy7bIST/" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726175AbgHIORo (ORCPT ); Sun, 9 Aug 2020 10:17:44 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:59958 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726236AbgHIORm (ORCPT ); Sun, 9 Aug 2020 10:17:42 -0400 Received: from mail-ed1-x543.google.com (mail-ed1-x543.google.com [IPv6:2a00:1450:4864:20::543]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 5D567C061787 for ; Sun, 9 Aug 2020 07:17:42 -0700 (PDT) Received: by mail-ed1-x543.google.com with SMTP id i26so4582141edv.4 for ; Sun, 09 Aug 2020 07:17:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=ItfZzrkH2XxylQjc1Fg63UxGYkx3Ea15KMrGhNnI6xc=; b=gy7bIST/whvb8qjtZhH6FDsrpUHR729r4XoUHCIq/pLaHpbxcFLwmFrdgmTIZk1MKo MrkveBs8CwhG56hbvb1b/veRA3pGh3aHVB1gqZSJKkEaSxXZOIUwExAqBhWeYNK/Z9sk 7m/7mQCp/9ytSjs2eMrbicw5V068zpoxl0MGC/D3A3c3ybmYOnlns1H/h36zb8hazUQS TSjluy2vROEdrv2N0SE6E/hcXcrA2NQxoKzpv55DJnkoa3HasKoHPbbu6bu/Ux0Cmb0m G5U8NNfR0W9RxCUArU5zhKOn37Jnbq4e1tVyekqWmoehAd7m5gwgaIL6sKb0P4qyyRXj 81kw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=ItfZzrkH2XxylQjc1Fg63UxGYkx3Ea15KMrGhNnI6xc=; b=ttvdxhyzzoE9Uh8UXsqMVaiHGyFutdIuIfwStoeNAZyRscxemtUTHSmvJq8vd3TSba p6+jK4rqM1o0CT2783uZJ3NG0B1+dzWQsWHgyCRFyGBEmzymAZW4To0/6VDwKOaxUwmy honeIHuxEaLfa1mnLVqGI3gIdGBiMWP9TxzCzx4EWg48/SPPVhIBBeTk+AmKT46+LN8v uwOmGEvA8ueTMrNRglxqJBZrRXZt7wWYrSY9YBHFcHoVK/X4gezaSD0/c+dDBrWVy5R9 aq2vddggiyrdViGkm8fkYNsJPP6381wiP2kZDb1h7sk01GABgWDy++Tppni7QpyLP6wo NWBQ== X-Gm-Message-State: AOAM530UtliHdDa6meH9iN554ks/5fPOW2G82DcZ17vXv4QvSQvTQrXc Q1dw+wYUQR4S4TDLLqc6fk0kXbV0 X-Google-Smtp-Source: ABdhPJzGYBuQqXlwb1ANJ3iblbxIjS3oFrHdZjM8M6ip9QLexp/8SpbtNgA9qLqSG7mgPcgXoPB08A== X-Received: by 2002:a05:6402:17c2:: with SMTP id s2mr16742321edy.188.1596982660893; Sun, 09 Aug 2020 07:17:40 -0700 (PDT) Received: from localhost.localdomain ([2a02:a03f:a7fb:e200:788a:816d:ff27:8087]) by smtp.gmail.com with ESMTPSA id p1sm9917956edu.11.2020.08.09.07.17.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 09 Aug 2020 07:17:40 -0700 (PDT) From: Luc Van Oostenryck To: linux-sparse@vger.kernel.org Cc: Luc Van Oostenryck Subject: [PATCH 5/5] doc: shorter title for "submitting-patches.md" Date: Sun, 9 Aug 2020 16:17:31 +0200 Message-Id: <20200809141731.32433-6-luc.vanoostenryck@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20200809141731.32433-1-luc.vanoostenryck@gmail.com> References: <20200809141731.32433-1-luc.vanoostenryck@gmail.com> MIME-Version: 1.0 Sender: linux-sparse-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-sparse@vger.kernel.org The documentation for submitting patches has ": the sparse version" is in its title. This is quite useless and makes it longer than needed. So, remove this part from the title. Signed-off-by: Luc Van Oostenryck --- Documentation/submitting-patches.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/submitting-patches.md b/Documentation/submitting-patches.md index fb176ce51d46..6a4275c3fd35 100644 --- a/Documentation/submitting-patches.md +++ b/Documentation/submitting-patches.md @@ -1,5 +1,5 @@ -Submitting patches: the sparse version -====================================== +Submitting patches +================== Sparse uses a patch submit process similar to the Linux Kernel [Submitting Patches](https://www.kernel.org/doc/html/v4.12/process/submitting-patches.html)