Home Explore Blog Models CI



nixpkgs

lib/deprecated/README.md
b9441b16a4c21555075ee4585e69973b007e7e1466fe7e5a00000003000001ea

# lib/deprecated

Do not add any new functions to this directory.

This directory contains the `lib.misc` sublibrary, which - as a location - is deprecated.
Furthermore, some of the functions inside are of *dubious* utility, and should perhaps be avoided, while some functions *may still be needed*.

This directory does not play a role in the deprecation process for library functions.
They should be deprecated in place, by putting a `lib.warn` or `lib.warnIf` call around the function.

Chunks
6a5e13ee (1st chunk of `lib/deprecated/README.md`)
Title: Guidelines for the Deprecated `lib/deprecated` Directory
Summary
The `lib/deprecated` directory, which houses the deprecated `lib.misc` sublibrary, should not have any new functions added to it. While some functions within are of questionable utility, others may still be necessary. This directory itself does not manage the deprecation process for library functions; instead, functions are deprecated in place using `lib.warn` or `lib.warnIf` calls.