comments

Device/Beam/Beam.h

@@ -24,6 +24,8 @@ class SpinMatrix;
 class Beam;
 
 //! Returns Beam with given intensity.
+//! Provided instead of a plain constructor Beam(intensity, wavelength, alpha, phi)
+//! to prevent confusion with a different constructor signature in some pre-1.19 version.
 Beam InBeam(double intensity, double wavelength, double alpha, double phi = 0);
 //! Returns Beam with unit intensity.
 Beam UnitBeam(double wavelength, double alpha, double phi = 0);
@@ -33,6 +35,7 @@ Beam UnitBeam(double wavelength, double alpha, double phi = 0);
 
 class Beam : public INode {
 public:
+    //! Deprecated for direct use; prefer factory functions InBeam or UnitBeam.
     Beam(double intensity, double wavelength, const Direction& direction);
     ~Beam() override;