lkml.org 
[lkml]   [2020]   [Apr]   [7]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [RFC PATCH 2/3] docs: scheduler: Add scheduler overview documentation
On Wed, 1 Apr 2020 13:47:04 +0200
Daniel Bristot de Oliveira <bristot@redhat.com> wrote:

> > And that is a prime example of why I hates RST, it pretty much mandates
> > you view this with something other than a text editor.
>
> The good thing about the dot format is that we can convert it to many other
> formats, including text:
>
> [bristot@x1 ~]$ cat sched_transition.dot | graph-easy
>
> *
>
> |
> | task
> | forks
> v
> +------------------------------------+
> | TASK_NEW |
> | (Ready to run) |
> +------------------------------------+
> |
> |
> v
> + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -+
> ' int '
> ' '
> ' +------------------------------------+ '
> ' | TASK_RUNNING | '
> ' +--------------> | (Ready to run) | <--+ '
> ' | +------------------------------------+ | '
> ' | | | '
> ' | | schedule() calls context_switch() | task is pre-empted '
> ' | v | '
> ' | +------------------------------------+ | '
> ' | | TASK_RUNNING | | '
> ' | | (Running) | ---+ '
> ' | event occurred +------------------------------------+ '
> ' | | '
> ' | | - - - - - - - - - - - -+
> ' | | '
> ' | | task needs to wait for event '
> ' | v '
> ' | +------------------------------------+ '
> ' | | TASK_INTERRUPTIBLE | '
> ' | | TASK_UNINTERRUPTIBLE | '
> ' +--------------- | TASK_WAKEKILL | '
> ' +------------------------------------+ '
> ' '
> + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +
> |
> | task exits via do_exit()
> v
> +------------------------------------+
> | TASK_DEAD |
> | EXIT_ZOMBIE |
> +------------------------------------+
>
>
> Is there a way to also add this representation, while hiding it
> when using a graphical reader?

Better, honestly, to just put the ascii art into the doc as a literal
block. I don't see any real reason to embed Dot stuff unless there's
really no alternative.

Thanks,

jon

\
 
 \ /
  Last update: 2020-04-07 21:41    [W:0.118 / U:10.960 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site