Re: date -I now undocumented

[Dan Jacobson]

Well I don't suppose we will ever see the word "deprecated" in any of
your Info or man pages, even though it is part of good software
practices.

Apparently the GNU policy is, first an item silently disappears from a
man or info page, then later the functionality is removed from the
binary.  Or even all at the same time.

Contrast this with python, which even gives "future warnings".

I urge you to mark on your man and info pages today anything that you
know will go away tomorrow.

The impression when something still works but one can't find it in the
documents anymore is that the maintainers have misformatted their
documentation. Therefore say it is deprecated, like everybody else
does.

Users won't look in the source code for what should be in the man
page; and we don't install source distributions anyway.