Update auto/README.md

cmake/BornAgain/Directories.cmake

@@ -41,7 +41,7 @@ set(TEST_OUTPUT_DIR_PY_PERSIST  ${TEST_OUTPUT_DIR}/PyPersist)
 set(TEST_OUTPUT_DIR_PY_STD      ${TEST_OUTPUT_DIR}/PyStd)
 set(TEST_OUTPUT_DIR_STD         ${TEST_OUTPUT_DIR}/Std)
 
-configure_file("${CONFIGURABLES_DIR}/auto_README.in" "${CMAKE_SOURCE_DIR}/auto/README" @ONLY)
+configure_file("${CONFIGURABLES_DIR}/auto_README.in.md" "${CMAKE_SOURCE_DIR}/auto/README.md" @ONLY)
 
 file(MAKE_DIRECTORY ${CMAKE_LIBRARY_OUTPUT_DIRECTORY})
 file(MAKE_DIRECTORY ${CMAKE_LIBRARY_OUTPUT_DIRECTORY}/bornagain)

cmake/configurables/auto_README.in

-This directory, auto, contains files that are automatically
-generated by tools other than CMake, Make, and the compiler.
-
-They are distributed as part of the source archive. A user
-who just wants to compile BornAgain should consider the
-contents of this directory as part of the source.
-
-A developer, on the other hand, will sooner or later need
-to regenerate some or all sources contained in this directory.
-For this, use the command top-level cmake command with option
--DAUTOGENERATE=ON, or with more specific options like
--DBORNAGAIN_GENERATE_BINDINGS=ON.
-
-Contents of this directory:
-
-Doc/man:
-  Unix man page in troff format, generated by pod2man.
-
-Wrap:
-  Python wrapper, generated by Doxygen and Swig.

auto/README.md → cmake/configurables/auto_README.in.md

-This directory, auto, contains files that are automatically
+#### Directory auto/
+
+This directory contains files that are automatically
 generated by tools other than CMake, Make, and the compiler.
 
 They are distributed as part of the source archive. A user
@@ -8,13 +10,13 @@ contents of this directory as part of the source.
 A developer, on the other hand, will sooner or later need
 to regenerate some or all sources contained in this directory.
 For this, use the command top-level cmake command with option
--DAUTOGENERATE=ON, or with more specific options like
--DBORNAGAIN_GENERATE_BINDINGS=ON.
+`-DAUTOGENERATE=ON`, or with more specific options like
+`-DBORNAGAIN_GENERATE_BINDINGS=ON`.
 
 Contents of this directory:
 
-Doc/man:
-  Unix man page in troff format, generated by pod2man.
+`Doc/man`
+: Unix man page in troff format, generated by pod2man.
 
-Wrap:
-  Python wrapper, generated by Doxygen and Swig.
+`Wrap`
+: Python wrapper, generated by Doxygen and Swig.