diff --git a/Event/xAOD/xAODCore/xAODCore/ShallowCopy.h b/Event/xAOD/xAODCore/xAODCore/ShallowCopy.h
index b47ba572c78dbf6f4f89e9049e08ba5f818b6c87..ff9dfa596afe148402f3c3aa20ebdf9497bc05ac 100644
--- a/Event/xAOD/xAODCore/xAODCore/ShallowCopy.h
+++ b/Event/xAOD/xAODCore/xAODCore/ShallowCopy.h
@@ -1,7 +1,7 @@
 // Dear emacs, this is -*- c++ -*-
 
 /*
-  Copyright (C) 2002-2019 CERN for the benefit of the ATLAS collaboration
+  Copyright (C) 2002-2020 CERN for the benefit of the ATLAS collaboration
 */
 
 // $Id: ShallowCopy.h 766390 2016-08-04 11:18:59Z wlampl $
@@ -48,6 +48,10 @@ namespace xAOD {
    /// @returns A pair of pointers to the created objects. The caller takes
    ///          ownership of the created objects
    ///
+   /// Be aware: If CONT has decorations, then the scheduler won't automatically
+   /// known that they are available on the copy.  To make that happen, see
+   /// StoreGate/ShallowCopyDecorDeps.h.
+   ///
    template< class T >
    std::pair< T*, ShallowAuxContainer* > shallowCopyContainer( const T& cont ) {
 
@@ -97,6 +101,10 @@ namespace xAOD {
    /// @returns A pair of pointers to the created objects. The caller takes
    ///          ownership of the created objects
    ///
+   /// Be aware: If CONT has decorations, then the scheduler won't automatically
+   /// known that they are available on the copy.  To make that happen, see
+   /// StoreGate/ShallowCopyDecorDeps.h.
+   ///
    template< class T >
    std::pair< T*, ShallowAuxInfo* > shallowCopyObject( const T& obj ) {