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

Code before:
            '+': file size must be greater than or equal to this\n   \
            '-': file size must be less than or equal to this\n   \
            'NUM':  The numeric size (e.g. 500)\n   \
            'UNIT': The units for NUM. They are not case-sensitive.\n\
            Allowed unit values:\n   \
                'b':  bytes\n   \
                'k':  kilobytes\n   \
                'm':  megabytes\n   \
                'g':  gigabytes\n   \
                't':  terabytes\n   \
                'ki': kibibytes\n   \
                'mi': mebibytes\n   \
                'gi': gibibytes\n   \
                'ti': tebibytes");
    doc!(h, "changed-before"
        , "Limit results based on modification time older than duration or date provided."
        , "Limit results based on modification time older than duration provided:\n    \
             using a duration: <NUM>d <NUM>h <NUM>m <NUM>s (e.g. 10h, 1d, 35min...)\n    \
             or a date and time: YYYY-MM-DD HH:MM:SS");
    doc!(h, "changed-within"
        , "Limit results based on modification time within the duration provided or between date provided and now."
        , "Limit results based on modification time within the duration provided:\n    \
             using a duration: <NUM>d <NUM>h <NUM>m <NUM>s (e.g. 10h, 1d, 35min...)\n    \
             or a date and time: YYYY-MM-DD HH:MM:SS");
    doc!(h, "verbose"
        , "Print errors to stdout"
        , "Print errors to stdout. The error occured when fd has no permission to open file or directory.");
    h
}


Review comment (security):
(this should be `stderr` instead of `stdout`) I would suggest the following alternative help texts:

short:
- "Enable display of filesystem errors"

long:
- "Enable the display of filesystem errors for situations such as insufficient permissions or dead symlinks."

Code after:
    doc!(h, "rg-alias-hidden-ignore"
        , "Alias for no-ignore and/or hidden"
        , "Alias for no-ignore ('u') and no-ignore and hidden ('uu')");
    doc!(h, "size"
        , "Limit results based on the size of files."
        , "Limit results based on the size of files using the format <+-><NUM><UNIT>.\n   \
            '+': file size must be greater than or equal to this\n   \
            '-': file size must be less than or equal to this\n   \
            'NUM':  The numeric size (e.g. 500)\n   \
            'UNIT': The units for NUM. They are not case-sensitive.\n\
            Allowed unit values:\n   \
                'b':  bytes\n   \
                'k':  kilobytes\n   \
                'm':  megabytes\n   \
                'g':  gigabytes\n   \
                't':  terabytes\n   \
                'ki': kibibytes\n   \
                'mi': mebibytes\n   \
                'gi': gibibytes\n   \
                'ti': tebibytes");
    doc!(h, "changed-before"
        , "Limit results based on modification time older than duration or date provided."
        , "Limit results based on modification time older than duration provided:\n    \
             using a duration: <NUM>d <NUM>h <NUM>m <NUM>s (e.g. 10h, 1d, 35min...)\n    \
             or a date and time: YYYY-MM-DD HH:MM:SS");
    doc!(h, "changed-within"
        , "Limit results based on modification time within the duration provided or between date provided and now."
        , "Limit results based on modification time within the duration provided:\n    \
             using a duration: <NUM>d <NUM>h <NUM>m <NUM>s (e.g. 10h, 1d, 35min...)\n    \
             or a date and time: YYYY-MM-DD HH:MM:SS");
    doc!(h, "show-errors"
        , "Enable display of filesystem errors"
        , "Enable the display of filesystem errors for situations such as insufficient permissions \
            or dead symlinks.");
    doc!(h, "search-path"
        , "Provide paths to search as flag arguments rather than positional arguments."
        , "Provide paths to search as flag arguments, preventing the usage of any positional `path` arugments.\n\
           Changes the usage to `fd [FLAGS/OPTIONS] --search-path <path> --search-path <path2> [<pattern>]`");
    h
}