Hi Baptiste and Willy, Le 02/11/2016 à 08:19, Baptiste a écrit :
Thanks, I completely missed this one. I'm slightly worried that documenting the internal values may cause some people to start to fiddle with the file and cause issues if we ever change certain internal values, but at the same time I don't see any reason for changing these values, so that might be fine.Hi, That's the reason why we "designed" the doc like this :) (and dev should now think to update the doc each time they change the flags).
I perfectly understand the goal. But now the values are publicly exposed, I tend to think they should be documented and as stable as possible (I may be wrong but I compare it to /proc, where the documentation shouldn't ask admins to look at the kernel sources to see which value applies). They are kind of an API, now.
Shouldn't we add a reminder in the sources so that the documentation is updated as soon as new values are added ? Maybe it can be a compromise.
-- Cyril Bonté
