added doc, algos for display