Clean and document BlockMaterial and blocks

Signed-off-by: Steven Downer <grinch@outlook.com>
Remove illegal character from @see references

Signed-off-by: Steven Downer <grinch@outlook.com>