Several fixes and improvements in list_graph.h.

- Fix incorrect or misleading renamings in the code and in the documentation.
- Improve the documentation.

EXTRA_DIST += \

        benchmark/Makefile

if WANT_BENCHMARK

noinst_HEADERS +=

noinst_PROGRAMS +=

endif WANT_BENCHMARK