diff --git a/src/WaveTrack.cpp b/src/WaveTrack.cpp
index 9e5127295..a064be2df 100644
--- a/src/WaveTrack.cpp
+++ b/src/WaveTrack.cpp
@@ -17,14 +17,13 @@
 \brief Used only by WaveTrack, a special way to hold location that
 can accommodate merged regions.
 
-*//****************************************************************//**
+*//****************************************************************/
 
-\class WaveTrackFactory
-\brief Used to create a WaveTrack, or a LabelTrack..  Implementation
-of the functions of this class are dispersed through the different
-Track classes.
-
-*//*******************************************************************/
+/*!
+@class WaveTrackFactory
+@brief Used to create or clone a WaveTrack, with appropriate context
+from the project that will own the track.
+*/
 
 
 #include "WaveTrack.h"
diff --git a/src/WaveTrack.h b/src/WaveTrack.h
index b5f40961d..a02767c9e 100644
--- a/src/WaveTrack.h
+++ b/src/WaveTrack.h
@@ -673,11 +673,9 @@ class AUDACITY_DLL_API WaveTrackFactory final
  private:
    const ProjectSettings &mSettings;
    SampleBlockFactoryPtr mpFactory;
-   friend class AudacityProject;
  public:
-   // These methods are defined in WaveTrack.cpp, NoteTrack.cpp,
-   // LabelTrack.cpp, and TimeTrack.cpp respectively
    std::shared_ptr<WaveTrack> DuplicateWaveTrack(const WaveTrack &orig);
-   std::shared_ptr<WaveTrack> NewWaveTrack(sampleFormat format = (sampleFormat)0,
-                           double rate = 0);
+   std::shared_ptr<WaveTrack> NewWaveTrack(
+      sampleFormat format = (sampleFormat)0,
+      double rate = 0);
 };