Skip to content

Commit 963a9a3

Browse files
committed
docs: improve the Reference -> Command Line section
1 parent 59d4e38 commit 963a9a3

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

src/taskgraph/main.py

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -228,30 +228,30 @@ def logfile(spec):
228228

229229
@command(
230230
"tasks",
231-
help="Show all tasks in the taskgraph.",
231+
help="Show the full task set in the taskgraph. The full task set includes all tasks defined by any kind, without edges (dependencies) between them.",
232232
defaults={"graph_attr": "full_task_set"},
233233
)
234234
@command(
235-
"full", help="Show the full taskgraph.", defaults={"graph_attr": "full_task_graph"}
235+
"full", help="Show the full taskgraph. The full taskgraph consists of the full task set, with edges (dependencies) between tasks.", defaults={"graph_attr": "full_task_graph"}
236236
)
237237
@command(
238238
"target",
239-
help="Show the set of target tasks.",
239+
help="Show the target task set in the taskgraph. The target task set includes the tasks which have indicated they should be run, without edges (dependencies) between them.",
240240
defaults={"graph_attr": "target_task_set"},
241241
)
242242
@command(
243243
"target-graph",
244-
help="Show the target graph.",
244+
help="Show the target taskgraph. The target taskgraph consists of the target task set, with edges (dependencies) between tasks.",
245245
defaults={"graph_attr": "target_task_graph"},
246246
)
247247
@command(
248248
"optimized",
249-
help="Show the optimized graph.",
249+
help="Show the optimized taskgraph, which is the target task set with tasks optimized out (filtered, omitted, or replaced) and edges representing dependencies.",
250250
defaults={"graph_attr": "optimized_task_graph"},
251251
)
252252
@command(
253253
"morphed",
254-
help="Show the morphed graph.",
254+
help="Show the morphed graph, which is the optimized taskgraph with additional morphs applied. It retains the same meaning as the optimized taskgraph but in a form more palatable to TaskCluster.",
255255
defaults={"graph_attr": "morphed_task_graph"},
256256
)
257257
@argument("--root", "-r", help="root of the taskgraph definition relative to topsrcdir")

0 commit comments

Comments
 (0)