/usr/share/fish/man/man1/block.1 is in fish-common 2.4.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 | .TH "block" 1 "Sun Dec 11 2016" "Version 2.4.0" "fish" \" -*- nroff -*-
.ad l
.nh
.SH NAME
\fBblock\fP -- temporarily block delivery of events
.PP
.SS "Synopsis"
.PP
.nf
\fBblock\fP [OPTIONS\&.\&.\&.]
.fi
.PP
.SS "Description"
\fCblock\fP prevents events triggered by \fCfish\fP or the \fC\fCemit\fP\fP command from being delivered and acted upon while the block is in place\&.
.PP
In functions, \fCblock\fP can be useful while performing work that should not be interrupted by the shell\&.
.PP
The block can be removed\&. Any events which triggered while the block was in place will then be delivered\&.
.PP
Event blocks should not be confused with code blocks, which are created with \fCbegin\fP, \fCif\fP, \fCwhile\fP or \fCfor\fP
.PP
The following parameters are available:
.PP
.IP "\(bu" 2
\fC-l\fP or \fC--local\fP Release the block automatically at the end of the current innermost code block scope
.IP "\(bu" 2
\fC-g\fP or \fC--global\fP Never automatically release the lock
.IP "\(bu" 2
\fC-e\fP or \fC--erase\fP Release global block
.PP
.SS "Example"
.PP
.nf
Create a function that listens for events
\fBfunction\fP --on-event foo foo; \fBecho\fP 'foo fired'; \fBend\fP
.fi
.PP
.PP
.PP
.nf
Block the delivery of events
\fBblock\fP -g
.fi
.PP
.PP
.PP
.nf
\fBemit\fP foo
No output will be produced
.fi
.PP
.PP
.PP
.nf
\fBblock\fP -e
'foo fired' will now be printed
.fi
.PP
|