--- libgig/trunk/src/gig.cpp	2021/06/18 14:56:53	3943
+++ libgig/trunk/src/gig.cpp	2021/06/18 15:28:14	3944
@@ -6546,6 +6546,13 @@
             __notify_progress(pProgress, 1.0); // notify done
     }
 
+    /**
+     * Returns a pointer to the first <i>Instrument</i> object of the file,
+     * <i>NULL</i> otherwise.
+     *
+     * @deprecated  This method is not reentrant-safe, use GetInstrument()
+     *              instead.
+     */
     Instrument* File::GetFirstInstrument() {
         if (!pInstruments) LoadInstruments();
         if (!pInstruments) return NULL;
@@ -6553,6 +6560,13 @@
         return static_cast<gig::Instrument*>( (InstrumentsIterator != pInstruments->end()) ? *InstrumentsIterator : NULL );
     }
 
+    /**
+     * Returns a pointer to the next <i>Instrument</i> object of the file,
+     * <i>NULL</i> otherwise.
+     *
+     * @deprecated  This method is not reentrant-safe, use GetInstrument()
+     *              instead.
+     */
     Instrument* File::GetNextInstrument() {
         if (!pInstruments) return NULL;
         InstrumentsIterator++;