diff --git a/doc/Doxyfile.extra.in b/doc/Doxyfile.extra.in
index 22d7f26bdf4896198cc45bf8ef6d677a84ed62d4..bd125c64520dbaa2ee4afae02fa1b352f1f048fd 100644
--- a/doc/Doxyfile.extra.in
+++ b/doc/Doxyfile.extra.in
@@ -293,8 +293,6 @@ WARN_LOGFILE           = @CMAKE_BINARY_DIR@/doc/doxygen.log
 
 INPUT                 = @CMAKE_SOURCE_DIR@/include \
                         @CMAKE_SOURCE_DIR@/doc/additionalDoc
-IMAGE_PATH            = @CMAKE_SOURCE_DIR@/doc/pictures \
-                        @CMAKE_SOURCE_DIR@/doc/figures
                         
 
 # The RECURSIVE tag can be used to turn specify whether or not subdirectories
@@ -413,7 +411,7 @@ COLS_IN_ALPHA_INDEX    = 4
 # Doxygen will copy the logo to the output directory.
 
 PROJECT_LOGO           = @PROJECT_SOURCE_DIR@/doc/pictures/sot.png
-HTML_EXTRA_FILES       += sot.png
+HTML_EXTRA_FILES       += @PROJECT_SOURCE_DIR@/doc/pictures/sot.png
 
 # The HTML_HEADER tag can be used to specify a personal HTML header for
 # each generated HTML page. If it is left blank doxygen will generate a
@@ -427,7 +425,7 @@ HTML_EXTRA_FILES       += sot.png
 # changing the value of configuration settings such as GENERATE_TREEVIEW!
 
 HTML_HEADER            = @PROJECT_SOURCE_DIR@/doc/header.html
-HTML_EXTRA_FILES       += @PROJECT_SOURCE_DIR@/doc/sot.ico
+HTML_EXTRA_FILES       += @PROJECT_SOURCE_DIR@/doc/pictures/sot.ico
 
 # The HTML_FOOTER tag can be used to specify a personal HTML footer for
 # each generated HTML page. If it is left blank doxygen will generate a
diff --git a/doc/additionalDoc/debug-logger.h b/doc/additionalDoc/debug-logger.h
index cbbdc770edd8e82085caf3a8a6c61225d17bb077..0fc64030425c2b95297cfad5a36560d7841e12c3 100644
--- a/doc/additionalDoc/debug-logger.h
+++ b/doc/additionalDoc/debug-logger.h
@@ -26,7 +26,7 @@ It is possible to set the output stream of the messages inside a file:
 \section sec_use_rt_logger Using the rt_logger
 
 
-\newcode
+\code
 // Somewhere in your library
 dgRTLOG() << "your message. Prefer to use \n than std::endl."
 \endcode
diff --git a/doc/additionalDoc/introduction.h b/doc/additionalDoc/introduction.h
index 0d749619f1b0d477c782f4481d099272bc719ad1..e7e4c5e022ce7ac5446a111c3de0f5914559e9be 100644
--- a/doc/additionalDoc/introduction.h
+++ b/doc/additionalDoc/introduction.h
@@ -62,6 +62,6 @@ load classes of entities  and create instances of entities.</p>
 \li Type-safe connection of input and output signals
 \li On-demand signal computation as well as a caching system for signal values
 allow fast computation of signal values, which is a critical point for real-time
-systems\n See \ref scriptingabout
+systems\n 
 
 */
diff --git a/doc/figures/Concept-Software-Fig.png b/doc/pictures/Concept-Software-Fig.png
similarity index 100%
rename from doc/figures/Concept-Software-Fig.png
rename to doc/pictures/Concept-Software-Fig.png
diff --git a/doc/figures/entity.png b/doc/pictures/entity.png
similarity index 100%
rename from doc/figures/entity.png
rename to doc/pictures/entity.png
diff --git a/doc/figures/entity.svg b/doc/pictures/entity.svg
similarity index 100%
rename from doc/figures/entity.svg
rename to doc/pictures/entity.svg
diff --git a/doc/figures/use-case.png b/doc/pictures/use-case.png
similarity index 100%
rename from doc/figures/use-case.png
rename to doc/pictures/use-case.png
diff --git a/include/dynamic-graph/logger.h b/include/dynamic-graph/logger.h
index a4d151cc9affe20eda27e2eb481ee0ff6f47d8bf..a89d321fd059579cae5e03796b805b624de6d493 100644
--- a/include/dynamic-graph/logger.h
+++ b/include/dynamic-graph/logger.h
@@ -206,6 +206,7 @@ public:
    * allows it. The lineId is used to identify the point where sendMsg is
    * called so that streaming messages are printed only every streamPrintPeriod
    * iterations.
+   * \param type specifies the verbosity level, for instance MSG_TYPE_DEBUG
    * \param lineId typically __FILE__ ":" BOOST_PP_STRINGIZE(__LINE__)
    */
   RTLoggerStream stream(MsgType type, const std::string &lineId = "") {
@@ -265,8 +266,8 @@ protected:
 
   inline bool isStreamMsg(MsgType m) { return (m & MSG_TYPE_STREAM_BIT); }
 
-  /** Check whether a message of type \m and from \c lineId should be accepted.
-   *  \note If \c is a stream type, the internal counter associated to \c lineId
+  /** Check whether a message of type \p m and from \p c lineId should be accepted.
+   *  \note If \p m is a stream type, the internal counter associated to \p lineId
    *        is updated.
    */
   bool acceptMsg(MsgType m, const std::string &lineId) {
diff --git a/include/dynamic-graph/real-time-logger-def.h b/include/dynamic-graph/real-time-logger-def.h
index a1f564f894e69e60cfb25c807a3d9c06d0c71018..ea48ebad90a12b087b85fa4968e0bf07911ccad7 100644
--- a/include/dynamic-graph/real-time-logger-def.h
+++ b/include/dynamic-graph/real-time-logger-def.h
@@ -27,7 +27,7 @@ public:
 
 /// Write to an ostream object.
 ///
-/// The easieast is to use the macro \ref dgADD_OSTREAM_TO_RTLOG(ostr) where
+/// The easieast is to use the macro  dgADD_OSTREAM_TO_RTLOG(ostr) where
 /// `ostr` can be `std::cout` or an std::ofstream...
 class LoggerIOStream : public LoggerStream {
 public: