fts.3 vs nftw.3: POSIX and legacy

[<tlaronde%kergis.com@localhost>]

The ftw(3) man page states:

These functions are provided for compatibility with legacy code.  New
     code should use the fts(3) functions.

and the fts(3) man page has:

	The fts utility was expected to be included in the IEEE Std
	1003.1-1988 ("POSIX.1") revision.  But twenty years later, it
	still was not included in the IEEE Std 1003.1-2008 ("POSIX.1")
	revision.

(meaning, btw, that the comment is almost 20 years old too!)

But the situation seems to be different:

Issue 8 of POSIX has reworked ftw.h, has marked ftw(3) as obsolescent
(it is still in the header, but the function is not listed in the
interfaces) and kept nftw(3).

And no mention of fts(3).

So shouldn't the caveats on ftw.3 be about ftw(3) (obsolete) with
nftw(3) being "current" function and not "legacy"? And what about fts
vs nftw?

-- 
        Thierry Laronde <tlaronde +AT+ kergis +dot+ com>
                     http://www.kergis.com/
                    http://kertex.kergis.com/
Key fingerprint = 0FF7 E906 FBAF FE95 FD89  250D 52B1 AE95 6006 F40C