solstice

commit 46e6b97015f47ea6537f18ba8ea552a401da6c10
parent ff667b5e2cd9d7aabf8ffec3dfb0e2ba37dcbb33
Author: Christophe Coustet <christophe.coustet@meso-star.com>
Date:   Tue, 28 Jul 2026 16:13:35 +0200

Fix solstice(1) man

Syntax of references to sections was invalid.

Diffstat:
M
doc/solstice-input.5
 | 
39
+++++++++++++++++++++++++--------------

1 file changed, 25 insertions(+), 14 deletions(-)
diff --git a/doc/solstice-input.5 b/doc/solstice-input.5
@@ -27,9 +27,9 @@ format is used by the
 program to represent a solar plant.
 It relies on the YAML 1.1 data serialization standard
 .Po
-see
-.Sx NOTES ,
-reference 1
+see the
+.Sx NOTES
+section, reference 1
 .Pc ;
 assuming that the file is compatible with the
 .Nm
@@ -333,9 +333,9 @@ attribute is not defined,
 .Xr solstice 1
 uses a default spectrum computed with the SMARTS software
 .Po
-see
-.Sx NOTES ,
-reference 2
+see the
+.Sx NOTES
+section, reference 2
 .Pc
 between 0.28 and 4 micrometres.
 The total
@@ -388,8 +388,12 @@ value.
 .It Em buie
 The
 .Em buie
-distribution, as first described in reference 3
-.Pq see Sx NOTES .
+distribution
+.Po
+see the
+.Sx NOTES
+section, reference 3
+.Pc .
 Its single
 .Em csr
 parameter is the ratio between the circumsolar irradiance and the sum
@@ -397,7 +401,10 @@ of the circumsolar and sun's disk irradiance.
 An analysis of typical
 .Em csr
 values can be found in reference 4
-.Pq see Sx NOTES .
+.Po see the
+.Sx NOTES
+section
+.Pc .
 .El
 .Sh ATMOSPHERE
 The
@@ -410,7 +417,7 @@ The extinction along light paths is only computed after the first
 reflector, as the sun description must include all atmospheric effects
 before the first reflector (see
 .Sx SUN
-for more details).
+section for more details).
 .Pp
 If no atmosphere is provided, atmospheric extinction after the first
 reflector is not taken into account.
@@ -548,9 +555,9 @@ provide an optional
 .Em normal-map
 attribute that defines a path to a Portable PixMap image
 .Po
-see
+see the
 .Sx NOTES ,
-reference 5
+section, reference 5
 .Pc
 whose pixels store a normal expressed in the tangent space of the
 interface.
@@ -855,8 +862,12 @@ Four types of target are available:
 .It Em position
 The target is an absolute point in world coordinates.
 .It Em anchor
-The target is a position relative to an entity (see
-.Sx Anchor ) .
+The target is a position relative to an entity
+.Po
+see the
+.Sx ANCHOR
+section
+.Pc .
 .It Em sun
 The target is the center of the sun.
 .It Em direction