Home Explore Blog CI



nixpkgs

1st chunk of `lib/deprecated/README.md`
ff2d1584e3e991267b06f615b02aadd344f9866723a6149a00000001000001ea

# 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: Deprecated Library Directory
Summary
The 'lib/deprecated' directory is deprecated and should not receive new functions. It contains the 'lib.misc' sublibrary, some parts of which are of dubious utility while others may still be needed. Deprecation of functions within should be handled in place using 'lib.warn' or 'lib.warnIf'.