NeilBrown ce7a7eed77 doc: seq_file: clarify role of *pos in ->next()
There are behavioural requirements on the seq_file next() function in
terms of how it updates *pos at end-of-file, and these are now enforced
by a warning.

I was recently attempting to justify the reason this was needed, and
couldn't remember the details, and didn't find them in the
documentation.

So I re-read the code until I understood it again, and updated the
documentation to match.

I also enhanced the text about SEQ_START_TOKEN as it seemed potentially
misleading.

Cc: Vasily Averin <vvs@virtuozzo.com>
Signed-off-by: NeilBrown <neilb@suse.de>
Link: https://lore.kernel.org/r/87eemqiazh.fsf@notabene.neil.brown.name
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
2020-09-28 15:19:44 -06:00
..
2020-04-08 21:44:05 -07:00
2020-08-10 18:33:22 -07:00
2020-06-08 12:47:09 -07:00
2020-06-04 10:48:19 +02:00
2020-07-09 08:14:01 +02:00
2020-07-27 16:21:04 -06:00
2020-08-07 11:33:24 -07:00