src/ceph/src/dmclock/README.before-modifying-files-here-or-below

   1 The dmclock is an EXTERNAL library is not wholly owned by the ceph
   2 repo.  Instead, it is brought into ceph repo via a "git subtree".
   3
   4 If you are unfamiliar with this technique, PLEASE READ
   5 ../../README.git-subtree.
   6
   7 IT'S VERY LIKELY YOU DO *NOT* WANT TO DIRECTLY MODIFY FILES IN OR
   8 BELOW src/dmclock, AND THAT IF YOU DO MODIFY SUCH FILES YOUR
   9 MODIFICATIONS WILL LIKELY BE REJECTED.
  10
  11 You should only modify files below src/dmclock if:
  12
  13     1) you intend to diverge the ceph version of the dmclock library
  14        from the external library, and
  15
  16     2) you intend for ceph developers to maintain those divergences
  17        for the foreseeable future, even as the dmclock library evolves
  18        and those changes are pulled into ceph.
  19
  20 [Note: this file is an example of such a modification; this file is
  21 such a divergence.]
  22
  23 If you would like to submit a PR to the dmclock library itself, then
  24 you'll want to submit a PR to:
  25
  26     https://github.com/ceph/dmclock
  27
  28 After that PR is merged, you would then submit a PR to ceph that does
  29 a "git subtree pull" (see ../../README.git-subtree for details).