Received: by 2002:a05:6a10:5bc5:0:0:0:0 with SMTP id os5csp3231511pxb; Mon, 18 Oct 2021 10:46:20 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzCI3bMwupjDfFEJ2I3eVUD+hSaV8Nwo+47f/4W3OYHw9T7l6OblD4EX//PWosxzCscZI5B X-Received: by 2002:a17:90a:9285:: with SMTP id n5mr333949pjo.29.1634579180645; Mon, 18 Oct 2021 10:46:20 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1634579180; cv=none; d=google.com; s=arc-20160816; b=0uIXCID4AjKDkdZYBqBQyIdIu/jF8RFUzj1g7shcoViWjk+c4phTNC1ZHKGdT3hPum I9qQAI+sGdpFkldRxMvMGwrCKVudXWktnR51itR12ZF9zCxL05CSjBCPKDc5B3jDpPLw oeczMDsJPE4p7RNW1bdz7+SNp5i9JKNS4Yot0bUie8WJ2aX9Smv8nejqCcUBR31DZ4eN 1cizlpq9031c3IVPcHsDyg0giQ6JcMqZh6ZNfGgnTZ6FzX3ziiw53drTXUu+gyM9lMRs dglNGtssb6W6JEBIhf22wIlM6Zm1VZndSHyQMrv9luYXRpA64ZpTIrktf8bBdPZKkluR aLbA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:dkim-signature:dkim-filter; bh=On+vvnIjlnwvwqpWycMcn1ROTsL6lLApirxr0LG35Hc=; b=VQLFIo5EnAZTwqiy11fKMBwfAwzhDATPDm2YDI7uZdNx9GB15k1gmkpcLmUUs/qteV Bx7BiBO17ShB+vw1kbCJUGe3RjoGJDMKovbut5pEff4YK2Vh5PyRK4fbZ0WgqSHknxPl Swr3tmdXUeBDrc3jcP+UsFfkYYXODKE3OBQ5RNChdxYHRX1z5NzXHSy0xcFkUkfvbaJH 1ngyuUli6L/rLuu7+vN7d+fyFHv+aNXZWCeSTrR4oPFtKp+oGVc9H4OFL+7gwPRvmWuj yswAFEyRcPGPAZyRdLSWsDRFdLiDJ0p4oGNRbx5x2ds3TLR+pFXAJEubGlaA0e4UnBat 6InQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@lwn.net header.s=20201203 header.b=PCQbilsA; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id p5si13311501pgh.375.2021.10.18.10.46.07; Mon, 18 Oct 2021 10:46:20 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@lwn.net header.s=20201203 header.b=PCQbilsA; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234163AbhJRRpf (ORCPT + 99 others); Mon, 18 Oct 2021 13:45:35 -0400 Received: from ms.lwn.net ([45.79.88.28]:53248 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233885AbhJRRpd (ORCPT ); Mon, 18 Oct 2021 13:45:33 -0400 Received: from localhost (unknown [IPv6:2601:281:8300:104d::5f6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 453EC199E; Mon, 18 Oct 2021 17:43:21 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net 453EC199E DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1634579001; bh=On+vvnIjlnwvwqpWycMcn1ROTsL6lLApirxr0LG35Hc=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=PCQbilsAPBGb9A8Bhld9iPvc9Y3nQkIEdCrRqkBLedLMTJ0Mye+BL1n7CQTI4LV4A +Oo1KC5qp/kW2elZwZQO3uf0th15q8T58ta/EKpKUcAb2z21/pOFkV0k+mEW75syoW 0HMNjHHd8eucsEVKVmiWd7bRXlc+5me7ycXiMCbVJmNdNt35dhqPBtLGVsmPlrQCJa wWkCa1pFgOgFvIcO1pb4uKc2tzzLgDenhRXp/TfVMffrAFcnhT+j2uybjljEKcmxoH XrtuxH1cGK7PKl8rZlzl2dLKNuvkvF6wL5ON/PvAbfkKpzW/urkin0zIaU6BE6l2sF lBo7b8/w+Jopw== From: Jonathan Corbet To: Daniel Bristot de Oliveira , Steven Rostedt Cc: Daniel Bristot de Oliveira , Ingo Molnar , Tom Zanussi , Masami Hiramatsu , Juri Lelli , Clark Williams , John Kacur , Peter Zijlstra , Thomas Gleixner , Sebastian Andrzej Siewior , linux-rt-users@vger.kernel.org, linux-trace-devel@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH V3 13/19] rtla: Add Documentation In-Reply-To: <7e205854656f41afe9a35e6390d3e3cbd724706f.1634574261.git.bristot@kernel.org> References: <7e205854656f41afe9a35e6390d3e3cbd724706f.1634574261.git.bristot@kernel.org> Date: Mon, 18 Oct 2021 11:43:20 -0600 Message-ID: <877deaut3b.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Type: text/plain Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Daniel Bristot de Oliveira writes: > Adds the basis for rtla documentation. It is based on libtracefs > Documentation as suggested by Steven Rostedt. This patch also > includes the rtla(1) man page. > > Cc: Steven Rostedt > Cc: Ingo Molnar > Cc: Tom Zanussi > Cc: Masami Hiramatsu > Cc: Juri Lelli > Cc: Clark Williams > Cc: John Kacur > Cc: Peter Zijlstra > Cc: Thomas Gleixner > Cc: Sebastian Andrzej Siewior > Cc: Daniel Bristot de Oliveira > Cc: linux-rt-users@vger.kernel.org > Cc: linux-trace-devel@vger.kernel.org > Cc: linux-kernel@vger.kernel.org > Suggested-by: Steven Rostedt > Signed-off-by: Daniel Bristot de Oliveira > --- > tools/tracing/rtla/Documentation/Makefile | 223 ++++++++++++++++++ > .../tracing/rtla/Documentation/asciidoc.conf | 118 +++++++++ > .../rtla/Documentation/manpage-base.xsl | 35 +++ > .../rtla/Documentation/manpage-normal.xsl | 13 + > tools/tracing/rtla/Documentation/rtla.txt | 56 +++++ > tools/tracing/rtla/Documentation/utils.mk | 144 +++++++++++ > tools/tracing/rtla/Makefile | 20 +- > 7 files changed, 604 insertions(+), 5 deletions(-) > create mode 100644 tools/tracing/rtla/Documentation/Makefile > create mode 100644 tools/tracing/rtla/Documentation/asciidoc.conf > create mode 100644 tools/tracing/rtla/Documentation/manpage-base.xsl > create mode 100644 tools/tracing/rtla/Documentation/manpage-normal.xsl > create mode 100644 tools/tracing/rtla/Documentation/rtla.txt > create mode 100644 tools/tracing/rtla/Documentation/utils.mk So please forgive me for being obnoxious but I have to ask...do we *really* need to add yet another markup language and docs build infrastructure to the kernel? I'm glad to see documentation, of course, but I would be gladder if it weren't a silo completely separate from the rest of the kernel docs. Is there a reason why this couldn't have been done with Sphinx? Thanks, jon