diff --git a/src/modules/Pipe/pipe.c b/src/modules/Pipe/pipe.c
index 19920c5054f22c1e36cb06412c4be5c1ec0ab0b6..e3607c5de963bbacaa9cbcb31b794f7f9d4cd1af 100644
--- a/src/modules/Pipe/pipe.c
+++ b/src/modules/Pipe/pipe.c
@@ -115,6 +115,10 @@
  *!  with no mmap input.
  *!
  *!  Multiple socket output without regular file output illegal.
+ *!
+ *! @note
+ *! It is preferable to use the @[Shuffler] API, it is significantly
+ *! more flexible.
  */
 
 static struct program *pipe_program, *output_program;