Like mentioned by Andrei Pavlenko after merging pullrequest #1206, a wrong

ReST directive was used. Also fixed some other ReST directives that were
not correct and removed some warnings during buildbot checks.

modules/core/doc/basic_structures.rst

@@ -803,9 +803,9 @@ Finally, there are STL-style iterators that are smart enough to skip gaps betwee
 
 The matrix iterators are random-access iterators, so they can be passed to any STL algorithm, including ``std::sort()`` .
 
-.. Sample code::
+.. note::
 
-   * : An example demonstrating the serial out capabilities of cv::Mat can be found at opencv_source_code/samples/cpp/cout_mat.cpp
+   * An example demonstrating the serial out capabilities of cv::Mat can be found at opencv_source_code/samples/cpp/cout_mat.cpp
 
 .. _MatrixExpressions:
 

modules/core/doc/clustering.rst

@@ -66,11 +66,11 @@ Basically, you can use only the core of the function, set the number of
 attempts to 1, initialize labels each time using a custom algorithm, pass them with the
 ( ``flags`` = ``KMEANS_USE_INITIAL_LABELS`` ) flag, and then choose the best (most-compact) clustering.
 
-.. Sample code::
+.. note::
 
-   * : An example on K-means clustering can be found at opencv_source_code/samples/cpp/kmeans.cpp
+   * An example on K-means clustering can be found at opencv_source_code/samples/cpp/kmeans.cpp
 
-   * : PYTHON : An example on K-means clustering can be found at opencv_source_code/samples/python2/kmeans.py
+   * (Python) An example on K-means clustering can be found at opencv_source_code/samples/python2/kmeans.py
 
 partition
 -------------

modules/core/doc/drawing_functions.rst

@@ -26,9 +26,9 @@ If a drawn figure is partially or completely outside the image, the drawing func
 
 .. note:: The functions do not support alpha-transparency when the target image is 4-channel. In this case, the ``color[3]`` is simply copied to the repainted pixels. Thus, if you want to paint semi-transparent shapes, you can paint them in a separate buffer and then blend it with the main image.
 
-.. Sample code::
+.. note::
 
-   * : An example on using variate drawing functions like line, rectangle, ... can be found at opencv_source_code/samples/cpp/drawing.cpp
+   * An example on using variate drawing functions like line, rectangle, ... can be found at opencv_source_code/samples/cpp/drawing.cpp
 
 circle
 ----------

modules/core/doc/operations_on_arrays.rst

@@ -997,12 +997,12 @@ All of the above improvements have been implemented in :ocv:func:`matchTemplate`
 
 .. seealso:: :ocv:func:`dct` , :ocv:func:`getOptimalDFTSize` , :ocv:func:`mulSpectrums`, :ocv:func:`filter2D` , :ocv:func:`matchTemplate` , :ocv:func:`flip` , :ocv:func:`cartToPolar` , :ocv:func:`magnitude` , :ocv:func:`phase`
 
-.. Sample code::
+.. note::
 
-   * : An example using the discrete fourier transform can be found at opencv_source_code/samples/cpp/dft.cpp
+   * An example using the discrete fourier transform can be found at opencv_source_code/samples/cpp/dft.cpp
 
-   * : PYTHON : An example using the dft functionality to perform Wiener deconvolution can be found at opencv_source/samples/python2/deconvolution.py
-   * : PYTHON : An example rearranging the quadrants of a Fourier image can be found at opencv_source/samples/python2/dft.py
+   * (Python) An example using the dft functionality to perform Wiener deconvolution can be found at opencv_source/samples/python2/deconvolution.py
+   * (Python) An example rearranging the quadrants of a Fourier image can be found at opencv_source/samples/python2/dft.py
 
 
 divide
@@ -2268,9 +2268,9 @@ The sample below is the function that takes two matrices. The first function sto
     :ocv:func:`dft`,
     :ocv:func:`dct`
 
-.. Sample code::
+.. note::
 
-   * : An example using PCA for dimensionality reduction while maintaining an amount of variance can be found at opencv_source_code/samples/cpp/pca.cpp
+   * An example using PCA for dimensionality reduction while maintaining an amount of variance can be found at opencv_source_code/samples/cpp/pca.cpp
 
 PCA::PCA
 --------

modules/core/doc/xml_yaml_persistence.rst

@@ -91,9 +91,9 @@ Several things can be noted by looking at the sample code and the output:
  *
    In YAML (but not XML), mappings and sequences can be written in a compact Python-like inline form. In the sample above matrix elements, as well as each feature, including its lbp value, is stored in such inline form. To store a mapping/sequence in a compact form, put ":" after the opening character, e.g. use **"{:"** instead of **"{"** and **"[:"** instead of **"["**. When the data is written to XML, those extra ":" are ignored.
 
-.. Sample code::
+.. note::
 
-   * : A complete example using the FileStorage interface can be found at opencv_source_code/samples/cpp/filestorage.cpp
+   * A complete example using the FileStorage interface can be found at opencv_source_code/samples/cpp/filestorage.cpp
 
 
 Reading data from a file storage.