implements https://github.com/nim-lang/RFCs/issues/260 (#15505)

* implements https://github.com/nim-lang/RFCs/issues/260

* added a test case

1 files changed, 8 insertions, 0 deletions

diff --git a/doc/manual.rst b/doc/manual.rst
index 494a009cb..7258e7775 100644
--- a/doc/manual.rst
+++ b/doc/manual.rst
@@ -6622,6 +6622,14 @@ with the project:
 has changed. One can use the ``-f`` command line option to force recompilation
 of the file.
 
+Since 1.4 the `compile` pragma is also available with this syntax:
+
+.. code-block:: Nim
+  {.compile("myfile.cpp", "--custom flags here").}
+
+As can be seen in the example, this new variant allows for custom flags
+that are passed to the C compiler when the file is recompiled.
+
 
 Link pragma
 -----------