Yes, examples and docs are a bit buried, but there is a huge amount of info to be found.

Example outputs - http://lilypond.org/switch/tour

Example syntax - http://lilypond.org/switch/howto