Home Explore Blog Models CI



nixpkgs

1st chunk of `lib/deprecated/README.md`
6a5e13eef396970148d77457522fee97d47b167f040df2b600000001000001ea

# 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.

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.