From b0021b1b749db45f35f17fa7c43bcc64c2e47490 Mon Sep 17 00:00:00 2001
From: Andreas Specovius <andreas.specovius@fau.de>
Date: Thu, 19 Nov 2020 09:18:28 +0100
Subject: [PATCH] Minor improvements in code documentation.

---
 include/GSkyRegionRect.hpp | 3 +++
 src/sky/GSkyRegionRect.cpp | 8 +++++---
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/include/GSkyRegionRect.hpp b/include/GSkyRegionRect.hpp
index 332f83c..c55939c 100644
--- a/include/GSkyRegionRect.hpp
+++ b/include/GSkyRegionRect.hpp
@@ -48,6 +48,9 @@
  * The class holds several properties such as solid angle subtended by the
  * region and computed through internal method compute_solid().
  *
+ * The position angle counts counter-clockwise from celestial North and is
+ * aligned with the height axis of the rectangle.
+ *
  ***************************************************************************/
 class GSkyRegionRect : public GSkyRegion {
 
diff --git a/src/sky/GSkyRegionRect.cpp b/src/sky/GSkyRegionRect.cpp
index a969ab8..ebcdac9 100644
--- a/src/sky/GSkyRegionRect.cpp
+++ b/src/sky/GSkyRegionRect.cpp
@@ -258,7 +258,8 @@ GSkyRegionRect* GSkyRegionRect::clone(void) const
  * @param[in] posang Position angle [radians].
  *
  * Sets the position angle of the rectangular sky region. The position angle
- * is counted counterclockwise from North.
+ * is counted counterclockwise from cel. North and is aligned to the rect
+ * height.
  ***************************************************************************/
 void GSkyRegionRect::posang(const double& posang)
 {
@@ -279,7 +280,8 @@ void GSkyRegionRect::posang(const double& posang)
  * @param[in] posang Position angle [degrees].
  *
  * Sets the position angle of the rectangular sky region. The position angle
- * is counted counterclockwise from North.
+ * is counted counterclockwise from cel. North and is aligned to the rect
+ * height.
  ***************************************************************************/
 void GSkyRegionRect::posang_deg(const double& posang)
 {
@@ -333,7 +335,7 @@ void GSkyRegionRect::width(const double& width)
  *            Height value is less than 0.
  *
  * Sets the height of the rectangular sky region. Only non-negative radii are
- * allowed.
+ * allowed. For zero posang, the height axis is pointing to celestial north.
  ***************************************************************************/
 void GSkyRegionRect::height(const double& height)
 {
--
libgit2 0.21.4