Received: by 2002:a25:ab43:0:0:0:0:0 with SMTP id u61csp3655209ybi; Mon, 10 Jun 2019 14:14:12 -0700 (PDT) X-Google-Smtp-Source: APXvYqygg5raWxTvO7HqLvZdFGPozCq1tMYWLZAwNlIC0Na31Eb7NZh9ytPCI93en1LEi3ZD71Zm X-Received: by 2002:a17:90a:19d:: with SMTP id 29mr23794512pjc.71.1560201252446; Mon, 10 Jun 2019 14:14:12 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1560201252; cv=none; d=google.com; s=arc-20160816; b=nOAOrlUjgHophkzTXXZ9mlavCxkxKh1sGD52hzvNwexUH3QL0RgcKbzAJuWvM9Aqm0 WrOk3laH79frN3D+llBB2p/2vW7l95K8z6rm6Ns3OgGFREABmK/eI31aWwd4nzD0MZsd OB6MgAq1sdlPmd8NOprg6abr8wyJis8/dab4uhqiBdxuiFz1/qENyKbt0lsNQzqhsOzF 55oiOZnYe+sZl8tZdG9l7NXMIjBJoAhEvfHAmpP8kBr8al5aSSU/WULtcQ4AXzznWyBA n9eCYYlEvF7EaaBp70UOuMetPtE3EqOntmUOe+D7QUfIIqwt2n3oPMynZxrK1RfnHzbA ebNA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=ARkpqDw6hh5K+0monDK5QS19Np6XwBxbJQxbed0bnp0=; b=sMa1C8fiRFbKNfPN1l5NBCtKVIDLb6qKgfju92HpqoX2VkPYqlFawWhhPSseSQyudp +S7XxtOb834Ida8+ZX1m30WY7bagGa3K+tqkQhpvQOdg/SOcr0gZxBzrWxhKmVxOfCfF CB4Bi0rPQ4SGmCrniKZ9seVJ3kLkVgr+7bajUS3kx57o5UOpV178V9sg7O5jCm1wxiDs 2HzVJWRg2Sb4JbLiL3K5ACjxWh+uX9CgGyDVNwIU1hPQ1NX7mYtlBMQBajczQesUmd+9 HyRrdzL3lUILkW69FHiJOtQVN1f5pm/WP1iO8Wz4T9CbqIlz/YM1uAdNO/q0/0gKA+J3 0xIw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kolabnow.com header.s=dkim20160331 header.b=DNscEI5W; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id m2si10246692pgv.89.2019.06.10.14.13.57; Mon, 10 Jun 2019 14:14:12 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@kolabnow.com header.s=dkim20160331 header.b=DNscEI5W; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2389926AbfFJVNR (ORCPT + 99 others); Mon, 10 Jun 2019 17:13:17 -0400 Received: from mx.kolabnow.com ([95.128.36.41]:9204 "EHLO mx.kolabnow.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726663AbfFJVNR (ORCPT ); Mon, 10 Jun 2019 17:13:17 -0400 Received: from localhost (unknown [127.0.0.1]) by ext-mx-out002.mykolab.com (Postfix) with ESMTP id B4F99844; Mon, 10 Jun 2019 23:13:14 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kolabnow.com; h= content-type:content-type:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:date:subject:subject :from:from:received:received:received; s=dkim20160331; t= 1560201194; x=1562015595; bh=ARkpqDw6hh5K+0monDK5QS19Np6XwBxbJQx bed0bnp0=; b=DNscEI5WOdOU5DBDL0y/wOTaHbSZ35U80+dkOcNWgqOc8N5oV+e weGSxcGuvJ1g0S0GiDNMxDmoVtN/WSHgTkoWvhDzfzPLnBDey1CsxJH7h1jl7p+O aMnUrztGihiusjsxMNuh47zI6p/1+/O2+o3yl5TPHns45w6lyVU46PeElDVuLXWF zRVqvI/tHLR4Gkg4pli4+GHg/gkfMQv6LsWwBRV2dbPCGIPkwXlCqG+Idaa+oKoU z7gTrCPRSjF0CTvUs7P2Tm5iPtlp9LVL6gDUKmSVE54pSH22NPuZYUtQcOKrx7Ga LEwHOd7+ZTRnVOKKfK7N6c/982FTmjigQOyvFGt4GSFmTE2NTUBj4zQddDOASoS6 U3JMgL7StJuqdgEwSxb4sg2TySbwgtRi8Rd6rJTXonRXdfKaly05yKKYpp3qKh3r 6ggayiLNtfYY7ygRZZH624JRVeRO5+eULJM5psD1SgLCYAdR3sHO7BDSDH0zKcQf 4grQrVlHzupIxFnoEwFhRrzWUMdsIuSbDeRMMGunW5SyZ+ikMuqyqq8WsGLcOdMs 5Lxa5au4jfSpcO7A0RzMlD0Ehz034xV7/w4ewF4M6ysy0GpiaMi2PybK9M1XsxRG mpjIi4RgMNGAu489QCg37P1XWOdoW3ivw7oniGbgnk8H3i2CzN0RKmGE= X-Virus-Scanned: amavisd-new at mykolab.com X-Spam-Flag: NO X-Spam-Score: -1.9 X-Spam-Level: X-Spam-Status: No, score=-1.9 tagged_above=-10 required=5 tests=[BAYES_00=-1.9] autolearn=ham autolearn_force=no Received: from mx.kolabnow.com ([127.0.0.1]) by localhost (ext-mx-out002.mykolab.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id M5isNbMaxBm5; Mon, 10 Jun 2019 23:13:14 +0200 (CEST) Received: from int-mx003.mykolab.com (unknown [10.9.13.3]) by ext-mx-out002.mykolab.com (Postfix) with ESMTPS id 346D111C; Mon, 10 Jun 2019 23:13:14 +0200 (CEST) Received: from ext-subm003.mykolab.com (unknown [10.9.6.3]) by int-mx003.mykolab.com (Postfix) with ESMTPS id 1A3F82023; Mon, 10 Jun 2019 18:26:39 +0200 (CEST) From: Federico Vaga To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , Peter Zijlstra , Ingo Molnar , Will Deacon , Maarten Lankhorst , Maxime Ripard , Sean Paul , David Airlie , Daniel Vetter , dri-devel@lists.freedesktop.org Subject: Re: [PATCH v3 16/33] docs: locking: convert docs to ReST and rename to *.rst Date: Mon, 10 Jun 2019 18:26:37 +0200 Message-ID: <2479388.eidelHUoWk@harkonnen> In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org In data Sunday, June 9, 2019 4:27:06 AM CEST, Mauro Carvalho Chehab ha scritto: > Convert the locking documents to ReST and add them to the > kernel development book where it belongs. > > Most of the stuff here is just to make Sphinx to properly > parse the text file, as they're already in good shape, > not requiring massive changes in order to be parsed. > > The conversion is actually: > - add blank lines and identation in order to identify paragraphs; > - fix tables markups; > - add some lists markups; > - mark literal blocks; > - adjust title markups. > > At its new index.rst, let's add a :orphan: while this is not linked to > the main index.rst file, in order to avoid build warnings. > > Signed-off-by: Mauro Carvalho Chehab > --- > Documentation/kernel-hacking/locking.rst | 2 +- > Documentation/locking/index.rst | 24 ++ > ...{lockdep-design.txt => lockdep-design.rst} | 51 ++-- > .../locking/{lockstat.txt => lockstat.rst} | 221 ++++++++++-------- > .../{locktorture.txt => locktorture.rst} | 105 +++++---- > .../{mutex-design.txt => mutex-design.rst} | 26 ++- > ...t-mutex-design.txt => rt-mutex-design.rst} | 139 ++++++----- > .../locking/{rt-mutex.txt => rt-mutex.rst} | 30 +-- > .../locking/{spinlocks.txt => spinlocks.rst} | 32 ++- > ...w-mutex-design.txt => ww-mutex-design.rst} | 82 ++++--- > Documentation/pi-futex.txt | 2 +- > .../it_IT/kernel-hacking/locking.rst | 2 +- Limited to translations/it_IT Acked-by: Federico Vaga > drivers/gpu/drm/drm_modeset_lock.c | 2 +- > include/linux/lockdep.h | 2 +- > include/linux/mutex.h | 2 +- > include/linux/rwsem.h | 2 +- > kernel/locking/mutex.c | 2 +- > kernel/locking/rtmutex.c | 2 +- > lib/Kconfig.debug | 4 +- > 19 files changed, 428 insertions(+), 304 deletions(-) > create mode 100644 Documentation/locking/index.rst > rename Documentation/locking/{lockdep-design.txt => lockdep-design.rst} > (93%) rename Documentation/locking/{lockstat.txt => lockstat.rst} (41%) > rename Documentation/locking/{locktorture.txt => locktorture.rst} (57%) > rename Documentation/locking/{mutex-design.txt => mutex-design.rst} (94%) > rename Documentation/locking/{rt-mutex-design.txt => rt-mutex-design.rst} > (91%) rename Documentation/locking/{rt-mutex.txt => rt-mutex.rst} (71%) > rename Documentation/locking/{spinlocks.txt => spinlocks.rst} (89%) rename > Documentation/locking/{ww-mutex-design.txt => ww-mutex-design.rst} (93%) >