On Tue, Jan 09, 2024 at 09:59:45PM +0800, Kent Gibson wrote: > My new year's resolution was to improve the documentation of the > character device API and gpio in general, so here we are. > > > Patch 2 relocates the sysfs API doc to stress its deprecation by > moving it to a new deprecated section, again in userspace-api but > with a similar section in the admin-guide. The deprecated section > also provides a placeholder for subsequent changes. > While preparing the v2 version of this series, I'm now wondering if this should be changed to "obsolete" rather than "deprecated", to better fit with the interface lifecycle, to indicate there is an alternative, and to emphasise that it is scheduled for removal. i.e. from a userspace perspective "obsolete" is the clearer term. Is that a change worth making? Cheers, Kent.
