Add comments documenting pipe implementation

[eholk]

This is mostly a tracking bug for FIXMEs. The pipe compiler and runtime system should have enough comments that someone could read over them and understand how the system works and be able to fix bugs in it.

[graydon]

every fixme has a bug now, so closing this.