docs: expanded reference section on C compatibility features

- make clear that you can reference foreign entities
  directly in action statements w/o recourse to escape syntax
- explain why and how to avoid #include and other CPP directives
  in multi-line escaped code blocks