Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

perf docs: Fix accidental em-dashes

" -- " is an em dash (—) in asciidoc, so all these examples that were
supposed to be producing a literal two dashes were being misrendered.

Signed-off-by: Alyssa Ross <hi@alyssa.is>
Cc: Alexander Shishkin <alexander.shishkin@linux.intel.com>
Cc: Jiri Olsa <jolsa@redhat.com>
Cc: Mark Rutland <mark.rutland@arm.com>
Cc: Namhyung Kim <namhyung@kernel.org>
Cc: Peter Zijlstra <peterz@infradead.org>
Link: http://lore.kernel.org/lkml/20210809153226.332545-1-hi@alyssa.is
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>

authored by

Alyssa Ross and committed by
Arnaldo Carvalho de Melo
f2c24eba 7c0223e1

+11 -11
+1 -1
tools/perf/Documentation/intel-hybrid.txt
··· 140 140 One example, 'triad_loop' runs on cpu16 (atom core), while we can see the 141 141 scaled value for core cycles is 160,444,092 and the percentage is 0.47%. 142 142 143 - perf stat -e cycles -- taskset -c 16 ./triad_loop 143 + perf stat -e cycles \-- taskset -c 16 ./triad_loop 144 144 145 145 As previous, two events are created. 146 146
+1 -1
tools/perf/Documentation/perf-c2c.txt
··· 9 9 -------- 10 10 [verse] 11 11 'perf c2c record' [<options>] <command> 12 - 'perf c2c record' [<options>] -- [<record command options>] <command> 12 + 'perf c2c record' [<options>] \-- [<record command options>] <command> 13 13 'perf c2c report' [<options>] 14 14 15 15 DESCRIPTION
+1 -1
tools/perf/Documentation/perf-iostat.txt
··· 9 9 -------- 10 10 [verse] 11 11 'perf iostat' list 12 - 'perf iostat' <ports> -- <command> [<options>] 12 + 'perf iostat' <ports> \-- <command> [<options>] 13 13 14 14 DESCRIPTION 15 15 -----------
+1 -1
tools/perf/Documentation/perf-record.txt
··· 9 9 -------- 10 10 [verse] 11 11 'perf record' [-e <EVENT> | --event=EVENT] [-a] <command> 12 - 'perf record' [-e <EVENT> | --event=EVENT] [-a] -- <command> [<options>] 12 + 'perf record' [-e <EVENT> | --event=EVENT] [-a] \-- <command> [<options>] 13 13 14 14 DESCRIPTION 15 15 -----------
+7 -7
tools/perf/Documentation/perf-stat.txt
··· 9 9 -------- 10 10 [verse] 11 11 'perf stat' [-e <EVENT> | --event=EVENT] [-a] <command> 12 - 'perf stat' [-e <EVENT> | --event=EVENT] [-a] -- <command> [<options>] 13 - 'perf stat' [-e <EVENT> | --event=EVENT] [-a] record [-o file] -- <command> [<options>] 12 + 'perf stat' [-e <EVENT> | --event=EVENT] [-a] \-- <command> [<options>] 13 + 'perf stat' [-e <EVENT> | --event=EVENT] [-a] record [-o file] \-- <command> [<options>] 14 14 'perf stat' report [-i file] 15 15 16 16 DESCRIPTION ··· 217 217 218 218 Log output to fd, instead of stderr. Complementary to --output, and mutually exclusive 219 219 with it. --append may be used here. Examples: 220 - 3>results perf stat --log-fd 3 -- $cmd 221 - 3>>results perf stat --log-fd 3 --append -- $cmd 220 + 3>results perf stat --log-fd 3 \-- $cmd 221 + 3>>results perf stat --log-fd 3 --append \-- $cmd 222 222 223 223 --control=fifo:ctl-fifo[,ack-fifo]:: 224 224 --control=fd:ctl-fd[,ack-fd]:: ··· 245 245 246 246 perf stat -D -1 -e cpu-cycles -a -I 1000 \ 247 247 --control fd:${ctl_fd},${ctl_fd_ack} \ 248 - -- sleep 30 & 248 + \-- sleep 30 & 249 249 perf_pid=$! 250 250 251 251 sleep 5 && echo 'enable' >&${ctl_fd} && read -u ${ctl_fd_ack} e1 && echo "enabled(${e1})" ··· 265 265 --post:: 266 266 Pre and post measurement hooks, e.g.: 267 267 268 - perf stat --repeat 10 --null --sync --pre 'make -s O=defconfig-build/clean' -- make -s -j64 O=defconfig-build/ bzImage 268 + perf stat --repeat 10 --null --sync --pre 'make -s O=defconfig-build/clean' \-- make -s -j64 O=defconfig-build/ bzImage 269 269 270 270 -I msecs:: 271 271 --interval-print msecs:: ··· 496 496 EXAMPLES 497 497 -------- 498 498 499 - $ perf stat -- make 499 + $ perf stat \-- make 500 500 501 501 Performance counter stats for 'make': 502 502