/usr/share/fish/man/man1/alias.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 63 64 65 | .TH "alias" 1 "Sun Dec 11 2016" "Version 2.4.0" "fish" \" -*- nroff -*-
.ad l
.nh
.SH NAME
\fBalias\fP -- create a function
.PP
.SS "Synopsis"
.PP
.nf
\fBalias\fP NAME DEFINITION
\fBalias\fP NAME=DEFINITION
.fi
.PP
.SS "Description"
\fCalias\fP is a simple wrapper for the \fCfunction\fP builtin\&. It exists for backwards compatibility with Posix shells\&. For other uses, it is recommended to define a \fCfunction\fP\&.
.PP
\fCfish\fP does not keep track of which functions have been defined using \fCalias\fP\&. They must be erased using \fCfunctions -e\fP\&.
.PP
.IP "\(bu" 2
\fCNAME\fP is the name of the alias
.IP "\(bu" 2
\fCDEFINITION\fP is the actual command to execute\&. The string \fC$argv\fP will be appended\&.
.PP
.PP
You cannot create an alias to a function with the same name\&.
.PP
Note that spaces need to be escaped in the call to alias just like in the commandline \fIeven inside the quotes\fP\&.
.SS "Example"
The following code will create \fCrmi\fP, which runs \fCrm\fP with additional arguments on every invocation\&.
.PP
.PP
.nf
\fBalias\fP rmi 'rm -i'
.fi
.PP
.PP
.PP
.nf
This is equivalent to entering the following function:
.fi
.PP
.PP
.PP
.nf
\fBfunction\fP rmi
\fBrm\fP -i $argv
\fBend\fP
.fi
.PP
.PP
.PP
.nf
This needs to have the spaces escaped or 'Chrome\&.app\&.\&.\&.' will be seen as an argument to '/Applications/Google':
.fi
.PP
.PP
.PP
.nf
\fBalias\fP chrome='/Applications/Google\\ Chrome\&.app/Contents/MacOS/Google\\ Chrome banana'
.fi
.PP
|