schedutils: better illustrate the usage of cpu-lists with taskset

Provide a few examples of how to use the cpu-list variant of the taskset
command.

diff --git a/schedutils/taskset.1.adoc b/schedutils/taskset.1.adoc
index 9609e0c9c6e3271849f099afd1947566ae90f3e3..56084fd3c53afa7c71cf094fbb6ff536e4615c79 100644 (file)
--- a/schedutils/taskset.1.adoc
+++ b/schedutils/taskset.1.adoc
@@ -93,6 +93,14 @@ You can also retrieve the CPU affinity of an existing task{colon}::
 Or set it{colon}::
 *taskset -p* _mask pid_
 
+//TRANSLATORS: Keep {colon} untranslated.
+When a cpu-list is specified for an existing process, the 'p' and 'c' options must be grouped together{colon}::
+*taskset -pc* _cpu-list pid_
+
+//TRANSLATORS: Keep {colon} untranslated.
+The *--cpu-list* form is applicable only for launching new commands{colon}::
+*taskset --cpu-list* _cpu-list command_
+
 == PERMISSIONS
 
 A user can change the CPU affinity of a process belonging to the same user. A user must possess *CAP_SYS_NICE* to change the CPU affinity of a process belonging to another user. A user can retrieve the affinity mask of any process.