From 862be54d572c8563a43796d36807f3e4df5a58c2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michal=20Koutn=C3=BD?= <mkoutny@suse.com>
Date: Tue, 29 Nov 2022 13:23:51 +0100
Subject: [PATCH] cgtop: Update code comments

---
 src/cgtop/cgtop.c | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/cgtop/cgtop.c b/src/cgtop/cgtop.c
index cef5b654e7..5d82d656bc 100644
--- a/src/cgtop/cgtop.c
+++ b/src/cgtop/cgtop.c
@@ -56,10 +56,11 @@ typedef struct Group {
         uint64_t io_input_bps, io_output_bps;
 } Group;
 
+/* Counted objects, enum order matters */
 typedef enum PidsCount {
-        COUNT_USERSPACE_PROCESSES,
+        COUNT_USERSPACE_PROCESSES,      /* least */
         COUNT_ALL_PROCESSES,
-        COUNT_PIDS,
+        COUNT_PIDS,                     /* most, requires pids controller */
 } PidsCount;
 
 static unsigned arg_depth = 3;
@@ -932,6 +933,7 @@ static int run(int argc, char *argv[]) {
         if (r < 0)
                 return log_error_errno(r, "Failed to determine supported controllers: %m");
 
+        /* honor user selection unless pids controller is unavailable */
         possible_count = (mask & CGROUP_MASK_PIDS) ? COUNT_PIDS : COUNT_ALL_PROCESSES;
         arg_count = MIN(possible_count, arg_count);