apidoc edits and site update

include/solarsystem.h

@@ -173,6 +173,7 @@ typedef short (*novas_planet_provider_hp)(const double jd_tdb[2], enum novas_pla
  * @sa set_ephem_provider()
  * @sa ephemeris()
  * @sa NOVAS_EPHEM_OBJECT
+ * @sa solsys-ephem.c
  *
  * @since 1.0
  * @author Attila Kovacs

src/novas.c

@@ -5636,6 +5636,7 @@ double ira_equinox(double jd_tdb, enum novas_equinox_type equinox, enum novas_ac
  * @sa set_planet_provider()
  * @sa set_planet_provider_hp()
  * @sa ephemeris()
+ * @sa solsys-ephem.c
  *
  */
 int set_ephem_provider(novas_ephem_provider func) {

src/solsys-calceph.c

@@ -18,6 +18,7 @@
  *  <li>CALCEPH source code is at https://gitlab.obspm.fr/imcce_calceph/calceph</li>
  * </ol>
  *
+ * @sa solarsystem.h
  * @sa solsys-cspice.c
  */
 

src/solsys-cspice.c

@@ -22,6 +22,7 @@
  *  <li>the Smithsonian/cspice-sharedlib repository: https://github.com/Smithsonian/cspice-sharedlib</li>
  *  </ol>
  *
+ * @sa solarsystem.h
  * @sa solsys-calceph.c
  */
 

src/solsys-ephem.c

@@ -7,8 +7,9 @@
  * @date Created  on Jan 29, 2024
  * @author Attila Kovacs
  *
- * @sa solsys1.c
- * @sa solsys2.c
+ * @sa solarsystem.h
+ * @sa solsys-calceph.c
+ * @sa solsys-cspice.c
  */
 
 #include <errno.h>

src/solsys1.c

@@ -4,10 +4,13 @@
  * @author G. Kaplan and A. Kovacs
  *
  *  SuperNOVAS major planet ephemeris lookup implementation using JPL 1997 ephemeris data, to be
- *  used together with eph_manager.c. A more generic solution is to implement a
- *  novas_ephem_provider (e.g. relying on the current version of the CSPICE library) and set it as
- *  the default ephemeris handler via set_ephem_provider(), and then use solsys-ephem.c instead to
- *  use the same implementation for major planets.
+ *  used together with eph_manager.c. This is a legacy API, maiunly for supporting older code
+ *  written for NOVAS C.
+ *
+ *  A more generic solution is to implement a novas_ephem_provider (e.g. relying on the current
+ *  version of the CSPICE library) and set it as the default ephemeris handler via
+ *  set_ephem_provider(), and then use solsys-ephem.c instead to use the same implementation for
+ *  major planets.
  *
  *  Based on the NOVAS C Edition, Version 3.1:
  *
@@ -17,8 +20,9 @@
  *  <a href="http://www.usno.navy.mil/USNO/astronomical-applications">
  *  http://www.usno.navy.mil/USNO/astronomical-applications</a>
  *
- * @sa solsys-ephem.c
- * @sa solsys1.c
+ * @sa solarsystem.h
+ * @sa solsys-calceph.c
+ * @sa solsys-cspice.c
  */
 
 #include <errno.h>

src/solsys2.c

@@ -21,8 +21,9 @@
  *  <a href="http://www.usno.navy.mil/USNO/astronomical-applications">
  *  http://www.usno.navy.mil/USNO/astronomical-applications</a>
  *
- * @sa solsys-ephem.c
- * @sa solsys1.c
+ * @sa solarsystem.h
+ * @sa solsys-calceph.c
+ * @sa solsys-cspice.c
  */
 
 #include <errno.h>

src/solsys3.c

@@ -14,6 +14,9 @@
  *  <a href="http://www.usno.navy.mil/USNO/astronomical-applications">
  *  http://www.usno.navy.mil/USNO/astronomical-applications</a>
  *
+ *  @sa solarsystem.h
+ *  @sa solsys-calceph.c
+ *  @sa solsys-cspice.c
  *  @sa solsys-ephem.c
  */