[cmake-developers] kwrobot changing documentation

[James Bigler]

I noticed in the git history that the kitware robot changed the
documentation in the source files to something with "::" characters between
paragraphs.

It also seemed to add them between the paragraphs of the same descriptions:

#   CUDA_WRAP_SRCS ( cuda_target format generated_files file0 file1 ...
#                    [STATIC | SHARED | MODULE] [OPTIONS ...] )
#   -- This is where all the magic happens.  CUDA_ADD_EXECUTABLE,
#      CUDA_ADD_LIBRARY, CUDA_COMPILE, and CUDA_COMPILE_PTX all call this
#      function under the hood.
#
#
#
# ::
#
#      Given the list of files (file0 file1 ... fileN) this macro generates
#      custom commands that generate either PTX or linkable objects (use
"PTX" or
#      "OBJ" for the format argument to switch).  Files that don't end with
.cu
#      or have the HEADER_FILE_ONLY property are ignored.
#
#
#
# ::
#
#      The arguments passed in after OPTIONS are extra command line options
to
#      give to nvcc.  You can also specify per configuration options by
#      specifying the name of the configuration followed by the options.
 General
#      options must preceed configuration specific options.  Not all
#      configurations need to be specified, only the ones provided will be
used.

What do these "::" characters do?  I think they should only be between
variables and not within a single variable or macro's documentation.

James
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://public.kitware.com/pipermail/cmake-developers/attachments/20140129/b1c6cee5/attachment.html>