2 files changed, 5 insertions, 3 deletions
diff --git a/Documentation/api.rst b/Documentation/api.rst
index 0cc83016..22b7dfd2 100644
--- a/Documentation/api.rst
+++ b/Documentation/api.rst
@@ -26,4 +26,5 @@ Optimization
 ~~~~~~~~~~~~
 
 .. c:autodoc:: optimize.c
+.. c:autodoc:: flow.c
 .. c:autodoc:: simplify.c
diff --git a/flow.c b/flow.c
index ef8d04e5..1c6abdca 100644
--- a/flow.c
+++ b/flow.c
@@ -1,10 +1,11 @@
 /*
- * Flow - walk the linearized flowgraph, simplifying it as we
- * go along.
- *
  * Copyright (C) 2004 Linus Torvalds
  */
 
+///
+// Flow simplification
+// -------------------
+
 #include <string.h>
 #include <stdarg.h>
 #include <stdlib.h>