mirror of
https://github.com/sharkdp/fd
synced 2024-10-04 14:59:15 +00:00
Shorten man page with some fixes
Maybe in the future we need to redirect `--help` to the man pages? Is there a way for cargo to install the man pages?
This commit is contained in:
parent
b6c95a4800
commit
ddfa0873fb
52
doc/fd.1
52
doc/fd.1
|
@ -3,7 +3,7 @@
|
||||||
fd \- find files
|
fd \- find files
|
||||||
.BR find (1)
|
.BR find (1)
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
.B spt
|
.B fd
|
||||||
.RB [ \-HIsaLp0hV ]
|
.RB [ \-HIsaLp0hV ]
|
||||||
.RB [ \- d
|
.RB [ \- d
|
||||||
.IR depth ]
|
.IR depth ]
|
||||||
|
@ -15,6 +15,8 @@ fd \- find files
|
||||||
.IR when ]
|
.IR when ]
|
||||||
.RB [ \-j
|
.RB [ \-j
|
||||||
.IR num ]
|
.IR num ]
|
||||||
|
.RB [ \-x
|
||||||
|
.IR exec ]
|
||||||
.RI [ pattern ]
|
.RI [ pattern ]
|
||||||
.RI [ path ]
|
.RI [ path ]
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
|
@ -26,12 +28,12 @@ is a simple, fast and user-friendly alternative to
|
||||||
.B \-H, \-\-hidden
|
.B \-H, \-\-hidden
|
||||||
Search hidden files and directories.
|
Search hidden files and directories.
|
||||||
.TP
|
.TP
|
||||||
.B \-I, \-\-no\-gitignore
|
.B \-I, \-\-no\-ignore
|
||||||
Do not respect any
|
Do not respect any
|
||||||
.BR gitignore (5)
|
.BR gitignore (5)
|
||||||
files.
|
files.
|
||||||
.TP
|
.TP
|
||||||
.B \-s, \-\-case\-insensitive
|
.B \-s, \-\-case\-sensitive
|
||||||
Perform a case-sensitive search (default: smart case).
|
Perform a case-sensitive search (default: smart case).
|
||||||
.TP
|
.TP
|
||||||
.B \-a, \-\-absolute\-path
|
.B \-a, \-\-absolute\-path
|
||||||
|
@ -43,15 +45,16 @@ Dereference all symbolic links encountered.
|
||||||
.B \-p, \-\-full\-path
|
.B \-p, \-\-full\-path
|
||||||
Match
|
Match
|
||||||
.I pattern
|
.I pattern
|
||||||
against full path.
|
against full
|
||||||
|
.IR path .
|
||||||
.TP
|
.TP
|
||||||
.B \-0, \-\-print0
|
.B \-0, \-\-print0
|
||||||
Print results followed by a null character (instead of newlines).
|
Print results followed by null character instead of newlines.
|
||||||
.TP
|
.TP
|
||||||
.B \-h, \-\-help
|
.B \-h, \-\-help
|
||||||
Prints help information.
|
Prints help information.
|
||||||
.TP
|
.TP
|
||||||
.B \-v, \-\-version
|
.B \-V, \-\-version
|
||||||
Prints version information.
|
Prints version information.
|
||||||
.TP
|
.TP
|
||||||
.BI "\-d, \-\-max\-depth " levels
|
.BI "\-d, \-\-max\-depth " levels
|
||||||
|
@ -77,28 +80,45 @@ Filter search results by file extension
|
||||||
.BI "\-c, \-\-color " when
|
.BI "\-c, \-\-color " when
|
||||||
Declare
|
Declare
|
||||||
.I when
|
.I when
|
||||||
to use color for the pattern match output:
|
to colorize search results:
|
||||||
.RS
|
.RS
|
||||||
.IP auto
|
.IP auto
|
||||||
Show colors only when standard output is connected to a terminal. (default)
|
Colorize output when standard output is connected to terminal. (default)
|
||||||
.IP never
|
.IP never
|
||||||
Do not use colorized output.
|
Do not colorize output.
|
||||||
.IP always
|
.IP always
|
||||||
Always use colorized output.
|
Always colorize output.
|
||||||
.RE
|
.RE
|
||||||
.TP
|
.TP
|
||||||
.BI "\-j, \-\-threads " num
|
.BI "\-j, \-\-threads " num
|
||||||
Specifies number of threads to use for searching. (default: number of available
|
Number of threads to use for searching. (default: number of processing units
|
||||||
CPU cores)
|
available)
|
||||||
|
.TP
|
||||||
|
.BI "\-x, \-\-exec " command
|
||||||
|
Execute
|
||||||
|
.I command
|
||||||
|
on each of the discovered path with the following tokens substituted:
|
||||||
|
.RS
|
||||||
|
.IP {}
|
||||||
|
path
|
||||||
|
.IP {.}
|
||||||
|
path without extension
|
||||||
|
.IP {/}
|
||||||
|
basename of path
|
||||||
|
.IP {//}
|
||||||
|
parent of path
|
||||||
|
.IP {/.}
|
||||||
|
basename of path without extension
|
||||||
|
.RE
|
||||||
.SH ENVIRONMENT
|
.SH ENVIRONMENT
|
||||||
.TP
|
.TP
|
||||||
LS_COLORS
|
.B LS_COLORS
|
||||||
.BR "fd"'s
|
Determines how to colorize search results, see
|
||||||
color codes for search results.
|
.BR dircolors (1) .
|
||||||
.SH EXAMPLES
|
.SH EXAMPLES
|
||||||
.TP
|
.TP
|
||||||
.RI "Find the specific log files in " /var/log .
|
.RI "Find the specific log files in " /var/log .
|
||||||
$ fd nginx.log /var/log
|
$ fd nginx /var/log
|
||||||
.TP
|
.TP
|
||||||
Find all Python files that ends with \(dq.py\(dq in the current directory.
|
Find all Python files that ends with \(dq.py\(dq in the current directory.
|
||||||
$ fd -e py
|
$ fd -e py
|
||||||
|
|
Loading…
Reference in a new issue