Revise documentation including usage example re #9997

It was also necessary to initialize a variable within the algorithm for the usage example to work correctly.

Signed-off-by: Karl Palmen <karl.palmen@stfc.ac.uk>
Merge remote-tracking branch 'origin/feature/9997_doc_correct_lifn'