Attached find a rewrite of the documentation of buffer display
functions to be applied against the release branch.

Work in progress.  Proofreading and suggestions welcome.

Thanks for the attention, martin