public inbox for linux-doc@vger.kernel.org
 help / color / mirror / Atom feed
From: Tomas Glozar <tglozar@redhat.com>
To: Steven Rostedt <rostedt@goodmis.org>,
	Masami Hiramatsu <mhiramat@kernel.org>,
	Jonathan Corbet <corbet@lwn.net>
Cc: linux-trace-kernel@vger.kernel.org, linux-doc@vger.kernel.org,
	linux-kernel@vger.kernel.org,
	Mathieu Desnoyers <mathieu.desnoyers@efficios.com>,
	John Kacur <jkacur@redhat.com>,
	Luis Goncalves <lgoncalv@redhat.com>,
	Costa Shulyupin <costa.shul@redhat.com>,
	Crystal Wood <crwood@redhat.com>,
	Attila Fazekas <afazekas@redhat.com>,
	Tomas Glozar <tglozar@redhat.com>
Subject: [PATCH 0/9] Documentation/rtla: Cover default options
Date: Fri, 10 Oct 2025 10:33:29 +0200	[thread overview]
Message-ID: <20251010083338.478961-1-tglozar@redhat.com> (raw)

RTLA has many options that have a default value that is used when
the option is not set associated with them. Those are not covered in
the documentation for the options, which creates confusion among users.

Document the default behavior for all relevant options: -H, -P, -C,
--trace-buffer-size. Some of these are covered in general
descriptions, only missing from the option documentation.

Also, fix a few typos and incorrect naming of tracers.

-----------------------

The patchset contains two parts: fixes (first five commits), and new
additions for default options, which were previously undocumented or
poorly documented (the rest).

The patchset assumes [1] is applied, renaming included files to *.txt
from *.rst, to prevent build error on "make htmldocs".

Note: I am aware that there are more issues with the documentation, just
not everything can (and should) be fixed in one patchset.

[1] https://lore.kernel.org/linux-trace-kernel/20251008184522.13201-1-krishnagopi487@gmail.com/

Tomas Glozar (9):
  Documentation/rtla: Fix typo in common_options.txt
  Documentation/rtla: Fix typo in common_timerlat_options.txt
  Documentation/rtla: Fix typo in rtla-timerlat-top.rst
  Documentation/rtla: Fix typo in common_timerlat_options.txt
  Documentation/rtla: Correct tracer name for common options
  Documentation/rtla: Mention default priority
  Documentation/rtla: Mention default cgroup state
  Documentation/trace: Specify exact priority for timerlat
  Documentation/rtla: Include defaults for tracer options

 Documentation/tools/rtla/common_options.txt      | 16 +++++++++++++---
 .../tools/rtla/common_timerlat_options.txt       |  4 ++--
 Documentation/tools/rtla/rtla-timerlat-top.rst   |  2 +-
 Documentation/trace/timerlat-tracer.rst          | 12 ++++++------
 4 files changed, 22 insertions(+), 12 deletions(-)

-- 
2.51.0


             reply	other threads:[~2025-10-10  8:34 UTC|newest]

Thread overview: 14+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-10-10  8:33 Tomas Glozar [this message]
2025-10-10  8:33 ` [PATCH 1/9] Documentation/rtla: Fix typo in common_options.txt Tomas Glozar
2025-10-10  8:33 ` [PATCH 2/9] Documentation/rtla: Fix typo in common_timerlat_options.txt Tomas Glozar
2025-10-10  8:33 ` [PATCH 3/9] Documentation/rtla: Fix typo in rtla-timerlat-top.rst Tomas Glozar
2025-10-10  8:33 ` [PATCH 4/9] Documentation/rtla: Fix typo in common_timerlat_options.txt Tomas Glozar
2025-10-10  8:33 ` [PATCH 5/9] Documentation/rtla: Correct tracer name for common options Tomas Glozar
2025-10-10  8:33 ` [PATCH 6/9] Documentation/rtla: Mention default priority Tomas Glozar
2025-10-10  8:33 ` [PATCH 7/9] Documentation/rtla: Mention default cgroup state Tomas Glozar
2025-10-10  8:33 ` [PATCH 8/9] Documentation/trace: Specify exact priority for timerlat Tomas Glozar
2025-10-10  8:33 ` [PATCH 9/9] Documentation/rtla: Include defaults for tracer options Tomas Glozar
2025-11-03 23:35 ` [PATCH 0/9] Documentation/rtla: Cover default options Jonathan Corbet
2025-11-04  0:22   ` Steven Rostedt
2025-11-05 18:19     ` Jonathan Corbet
2025-11-04  0:32   ` Bagas Sanjaya

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20251010083338.478961-1-tglozar@redhat.com \
    --to=tglozar@redhat.com \
    --cc=afazekas@redhat.com \
    --cc=corbet@lwn.net \
    --cc=costa.shul@redhat.com \
    --cc=crwood@redhat.com \
    --cc=jkacur@redhat.com \
    --cc=lgoncalv@redhat.com \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-trace-kernel@vger.kernel.org \
    --cc=mathieu.desnoyers@efficios.com \
    --cc=mhiramat@kernel.org \
    --cc=rostedt@goodmis.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox