Repository: sharkdp/fd
File: src/app.rs (Rust)

Code before:
            This option disables smart case.");
    doc!(h, "absolute-path"
        , "Show absolute instead of relative paths"
        , "Shows the result of a pattern match as an absolute path instead of relative path.");
    doc!(h, "follow"
        , "Follow symbolic links"
        , "Includes a symbolic links destination in the pattern match.");
    doc!(h, "full-path"
        , "Search full path (default: file-/dirname only)"
        , "Searches the full path of directory. By default, fd only navigates file-/dirname.");
    doc!(h, "null_separator"
        , "Separate results by the null character"
        , "Separates each pattern match result by the null character.");
    doc!(h, "depth"
        , "Set maximum search depth (default: none)"
        , "Set the limit of the maximum search depth in a pattern match query. By default, \
            none is the max-depth.");
    doc!(h, "file-type"
        , "Filter by type: f(ile), d(irectory), s(ymlink)"
        , "Filter the search by type:\n\
            f file          for file\n\
            d directory     for directory\n\
            s symlink       for symbolic links.");
    doc!(h, "extension"
        , "Filter by file extension"
        , "Filter the search to only match for a filetype extension");
    doc!(h, "color"
        , "When to use color in the output:\n\
            never, auto, always (default: auto)"
        , "Declare when to use color for the pattern match output:\n\
            auto (default)\n\
            never\n\
            always");
    doc!(h, "threads"
        , "Set number of threads to use for searching:\n\
            (default: number of available CPU cores)");
    doc!(h, "max-buffer-time"
        , "the time (in ms) to buffer, before streaming to the console"
        , "Amount of time in milliseconds to buffer, before streaming to the console the results");
    doc!(h, "pattern"
        , "the search pattern, a regular expression (optional)"
        , "The search pattern to use for a match. By default, uses string match. Can use a \
            regular expression instead.");
    doc!(h, "path"
        , "the root directory for the filesystem search (optional)"
        , "The root directory where you want to do the filesystem search of the pattern.\
            When not present, the default is to use the current working directory.");

    h
}


Review comment (suggestion):
`--extension` can be used in addition to a normal search (for example: `fd -e png IMG_`). So I would rather say something like "Only show search results with a specific file extension".

Code after:
            This option disables smart case.");
    doc!(h, "absolute-path"
        , "Show absolute instead of relative paths"
        , "Shows the result of a pattern match as an absolute path instead of relative path.");
    doc!(h, "follow"
        , "Follow symbolic links"
        , "By default, fd does not descent into symlinked directories. Using this flag, symbolic \
            links are also traversed.");
    doc!(h, "full-path"
        , "Search full path (default: file-/dirname only)"
        , "Searches the full path of directory. By default, fd only searches the last part of \
            the path (the file name or the directory name).");
    doc!(h, "null_separator"
        , "Separate results by the null character"
        , "Separate search results by the null character (instead of newlines). This is useful \
            for piping results to 'xargs'.");
    doc!(h, "depth"
        , "Set maximum search depth (default: none)"
        , "Set the limit of the maximum search depth in a pattern match query. By default, there\
            is no limit on the search depth.");
    doc!(h, "file-type"
        , "Filter by type: f(ile), d(irectory), s(ymlink)"
        , "Filter the search by type:\n\
            f file          for file\n\
            d directory     for directory\n\
            s symlink       for symbolic links");
    doc!(h, "extension"
        , "Filter by file extension"
        , "Only show search results with a specific file extension.");
    doc!(h, "color"
        , "When to use color in the output:\n\
            never, auto, always (default: auto)"
        , "Declare when to use color for the pattern match output:\n\
            auto (default)\n\
            never\n\
            always");
    doc!(h, "threads"
        , "Set number of threads to use for searching:\n\
            (default: number of available CPU cores)");
    doc!(h, "max-buffer-time"
        , "the time (in ms) to buffer, before streaming to the console"
        , "Amount of time in milliseconds to buffer, before streaming the search results to\
            the console.");
    doc!(h, "pattern"
        , "the search pattern, a regular expression (optional)");
    doc!(h, "path"
        , "the root directory for the filesystem search (optional)"
        , "The root directory where you want to do the filesystem search of the pattern.\
            When not present, the default is to use the current working directory.");

    h