Improved Lookup plugins documentation

Only changes in the *Lookup plugins* chapter.

A couple of reStructuredText improvements and improved description about using lookup plugins as macros/in variables.