Revision: 70042
          http://sourceforge.net/p/brlcad/code/70042
Author:   starseeker
Date:     2017-08-03 22:07:05 +0000 (Thu, 03 Aug 2017)
Log Message:
-----------
more comment tweakage

Modified Paths:
--------------
    brlcad/trunk/misc/CMake/BRLCAD_Util.cmake

Modified: brlcad/trunk/misc/CMake/BRLCAD_Util.cmake
===================================================================
--- brlcad/trunk/misc/CMake/BRLCAD_Util.cmake   2017-08-03 22:04:06 UTC (rev 
70041)
+++ brlcad/trunk/misc/CMake/BRLCAD_Util.cmake   2017-08-03 22:07:05 UTC (rev 
70042)
@@ -151,25 +151,21 @@
 
 endfunction(IS_SUBPATH)
 
-#---------------------------------------------------------------------
-# Define a macro for building lists of files.  Distcheck needs to know
-# what files are "supposed" to be present in order to make sure the
-# source tree is clean prior to building a distribution tarball, hence
-# this macro stores its results in files and not variables  It's a
-# no-op in a SUBBUILD.
+#-----------------------------------------------------------------------------
+# Distcheck needs to know what files are "supposed" to be present in order to
+# make sure the source tree is clean prior to building a distribution tarball,
 #
-# For this macro to work correctly, it is important that any target
-# definitions or explicit calls to this macro supply relative paths for
-# files present in the source tree.  Generated files fed into
+# For this set of functions to work correctly, it is important that any call
+# (via target definitions or via explicit calls to CMAKEFILES) supply relative
+# paths for files present in the source tree.  Generated files fed into
 # compilation targets are not one of the things that should be in lists
-# generated by this macro, and the only way to reliably recognize them
-# is to reject files specified using their full path.  Such files must
-# use their full path in the build logic in order for out-of-src-dir
-# builds to function, so as long as no full paths are used for files
-# actually IN the source tree this method is reliable.  The macro will
-# try to catch improperly specified files, but if the build directory
-# and the source directory are one and the same this will not be
-# possible.
+# generated by this macro, and the only way to reliably recognize them is to
+# reject files specified using their full path.  Such files must use their full
+# path in the build logic in order for out-of-src-dir builds to function, so as
+# long as no full paths are used for files actually IN the source tree this
+# method is reliable.  The filtering logic will try to catch improperly
+# specified files, but if the build directory and the source directory are one
+# and the same this will not be possible.
 
 define_property(GLOBAL PROPERTY CMAKE_IGNORE_FILES BRIEF_DOCS "distcheck 
ignore files" FULL_DOCS "List of files known to CMake")
 define_property(GLOBAL PROPERTY CMAKE_IGNORE_DIRS BRIEF_DOCS "distcheck ignore 
dirs" FULL_DOCS "List of directories marked as fully known to CMake")

This was sent by the SourceForge.net collaborative development platform, the 
world's largest Open Source development site.


------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
BRL-CAD Source Commits mailing list
brlcad-commits@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/brlcad-commits

Reply via email to