diff options
author | Eugene Syromyatnikov <evgsyr@gmail.com> | 2022-01-12 18:42:24 +0100 |
---|---|---|
committer | Eugene Syromyatnikov <evgsyr@gmail.com> | 2022-01-18 18:39:14 +0100 |
commit | 7b86103ddfc6b513c3d02d6b6fad87c8f68b361f (patch) | |
tree | efdaa778a21debe6e563bcf2f2080e8851a9ed78 | |
parent | 3843ec63bb3ac601db881e55b2c67fd174c1f59c (diff) | |
download | strace-7b86103ddfc6b513c3d02d6b6fad87c8f68b361f.tar.gz |
doc/strace.1: align -e inject/--inject syntax description to the left
That eliminates warnings about inability to fill the line (that has become
rather long over the time):
<standard input>:1287: warning [p 9, 5.8i, div `an-div', 0.0i]: cannot adjust line
<standard input>:1287: warning [p 9, 5.8i, div `an-div', 0.2i]: can't break line
(as there are indeed no spaces in the syntax line to accomodate such filling).
Also, provide additional breakpoints to make it look a bit better.
* doc/strace.1.in (.SS Tampering): Add ".ad b" before "-e inject" option
syntax line and ".ad b" after "--inject" option syntax line; add "\:"
between option parameters for additional breaking points.
Reported-by: Dmitry V. Levin <ldv@strace.io>
-rw-r--r-- | doc/strace.1.in | 6 |
1 files changed, 4 insertions, 2 deletions
diff --git a/doc/strace.1.in b/doc/strace.1.in index 6f66ef3cc..1cd772ff6 100644 --- a/doc/strace.1.in +++ b/doc/strace.1.in @@ -1307,10 +1307,12 @@ field is not supplied explicitly, it is added as the last column. Summarise the time difference between the beginning and end of each system call. The default is to summarise the system time. .SS Tampering +.ad l .TP 12 -\fB\-e\ inject\fR=\,\fIsyscall_set\/\fR[:\fBerror\fR=\,\fIerrno\/\fR|:\fBretval\fR=\,\fIvalue\/\fR][:\fBsignal\fR=\,\fIsig\/\fR][:\fBsyscall\fR=\,\fIsyscall\/\fR][:\fBdelay_enter\fR=\,\fIdelay\/\fR][:\fBdelay_exit\fR=\,\fIdelay\/\fR][:\fBpoke_enter\fR=\,\fI@argN=DATAN,@argM=DATAM...\/\fR][:\fBpoke_exit\fR=\,\fI@argN=DATAN,@argM=DATAM...\/\fR][:\fBwhen\fR=\,\fIexpr\/\fR] +\fB\-e\ inject\fR=\,\fIsyscall_set\/\fR[:\fBerror\fR=\,\fIerrno\/\fR|:\fBretval\fR=\,\fIvalue\/\fR]\:[:\fBsignal\fR=\,\fIsig\/\fR]\:[:\fBsyscall\fR=\,\fIsyscall\/\fR]\:[:\fBdelay_enter\fR=\,\fIdelay\/\fR]\:[:\fBdelay_exit\fR=\,\fIdelay\/\fR]\:[:\fBpoke_enter\fR=\,\fI@argN=DATAN,@argM=DATAM...\/\fR]\:[:\fBpoke_exit\fR=\,\fI@argN=DATAN,@argM=DATAM...\/\fR]\:[:\fBwhen\fR=\,\fIexpr\/\fR] \{ .TQ -\fB\-\-inject\fR=\,\fIsyscall_set\/\fR[:\fBerror\fR=\,\fIerrno\/\fR|:\fBretval\fR=\,\fIvalue\/\fR][:\fBsignal\fR=\,\fIsig\/\fR][:\fBsyscall\fR=\,\fIsyscall\/\fR][:\fBdelay_enter\fR=\,\fIdelay\/\fR][:\fBdelay_exit\fR=\,\fIdelay\/\fR][:\fBpoke_enter\fR=\,\fI@argN=DATAN,@argM=DATAM...\/\fR][:\fBpoke_exit\fR=\,\fI@argN=DATAN,@argM=DATAM...\/\fR][:\fBwhen\fR=\,\fIexpr\/\fR] +\fB\-\-inject\fR=\,\fIsyscall_set\/\fR[:\fBerror\fR=\,\fIerrno\/\fR|:\fBretval\fR=\,\fIvalue\/\fR]\:[:\fBsignal\fR=\,\fIsig\/\fR]\:[:\fBsyscall\fR=\,\fIsyscall\/\fR]\:[:\fBdelay_enter\fR=\,\fIdelay\/\fR]\:[:\fBdelay_exit\fR=\,\fIdelay\/\fR]\:[:\fBpoke_enter\fR=\,\fI@argN=DATAN,@argM=DATAM...\/\fR]\:[:\fBpoke_exit\fR=\,\fI@argN=DATAN,@argM=DATAM...\/\fR]\:[:\fBwhen\fR=\,\fIexpr\/\fR] \{ +.ad b Perform syscall tampering for the specified set of syscalls. The syntax of the .I syscall_set |