X-Git-Url: https://git.madduck.net/etc/vim.git/blobdiff_plain/2f3fa1f6d0cbc2a3f31c7440c422da173b068e7b:/docs/usage_and_configuration/file_collection_and_discovery.md..dc71922c768e543c9c3bbb1db5ea6d7fa801a814:/.vim/bundle/black/docs/usage_and_configuration/static/gitweb.js diff --git a/docs/usage_and_configuration/file_collection_and_discovery.md b/docs/usage_and_configuration/file_collection_and_discovery.md deleted file mode 100644 index 1f43618..0000000 --- a/docs/usage_and_configuration/file_collection_and_discovery.md +++ /dev/null @@ -1,36 +0,0 @@ -# File collection and discovery - -You can directly pass _Black_ files, but you can also pass directories and _Black_ will -walk them, collecting files to format. It determines what files to format or skip -automatically using the inclusion and exclusion regexes and as well their modification -time. - -## Ignoring unmodified files - -_Black_ remembers files it has already formatted, unless the `--diff` flag is used or -code is passed via standard input. This information is stored per-user. The exact -location of the file depends on the _Black_ version and the system on which _Black_ is -run. The file is non-portable. The standard location on common operating systems is: - -- Windows: - `C:\\Users\\AppData\Local\black\black\Cache\\cache...pickle` -- macOS: - `/Users//Library/Caches/black//cache...pickle` -- Linux: - `/home//.cache/black//cache...pickle` - -`file-mode` is an int flag that determines whether the file was formatted as 3.6+ only, -as .pyi, and whether string normalization was omitted. - -To override the location of these files on macOS or Linux, set the environment variable -`XDG_CACHE_HOME` to your preferred location. For example, if you want to put the cache -in the directory you're running _Black_ from, set `XDG_CACHE_HOME=.cache`. _Black_ will -then write the above files to `.cache/black//`. - -## .gitignore - -If `--exclude` is not set, _Black_ will automatically ignore files and directories in -`.gitignore` file(s), if present. - -If you want _Black_ to continue using `.gitignore` while also configuring the exclusion -rules, please use `--extend-exclude`.