From 8fe1e60bea51c5c9b75e41a9602498dd8383dd59 Mon Sep 17 00:00:00 2001
From: Edward Hartnett <edward.hartnett@noaa.gov>
Date: Sat, 4 Nov 2023 08:32:12 -0600
Subject: [PATCH] started documenting what is in the points file

---
 model/src/w3iopomd.F90 | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/model/src/w3iopomd.F90 b/model/src/w3iopomd.F90
index ab1314b71..efd3986e3 100644
--- a/model/src/w3iopomd.F90
+++ b/model/src/w3iopomd.F90
@@ -1455,6 +1455,41 @@ END SUBROUTINE W3IOPON
   !>
   !> @brief Read/write point output.
   !>
+  !> The format of the point output file is:
+  !> Size (bytes) | Type | Variable | Meaning
+  !> -------------|------|----------|--------
+  !> 40 | character*40 | IDTST | ID string
+  !> 4 | integer | VERTST | version of test?
+  !> 4 | integer | NK | ???
+  !> 4 | integer | MTH | ???
+  !> 4 | integer | NOPTS | ???
+  !> 8*NOPTS | integer(2,NOPTS) | PTLOC | Point locations
+  !> 7*NOPTS | character*7 | PTNME | Point names
+  !> 8 | integer(2) | TIME | Time
+  !> reclen*NOPTS | * | * | record
+
+  !> Each record contains:
+  !> Size (bytes) | Type | Variable | Meaning
+  !> -------------|------|----------|--------
+  !> 4 | integer | IW | ???
+  !> 4 | integer | II | ???
+  !> 4 | integer | IL | ???
+  !> 4 | integer | DPO | ???
+  !> 4 | integer | WAO | ???
+  !> 4 | integer | WDO | ???
+  !> 4 | integer | TAUAO | (W3_FLX5 only) ???
+  !> 4 | integer | TAIDO | (W3_FLX5 only) ???
+  !> 4 | integer | DAIRO | (W3_FLX5 only) ???
+  !> 4 | integer | ZET_SETO | (W3_SETUP only) ???
+  !> 4 | integer | ASO | ???
+  !> 4 | integer | CAO | ???
+  !> 4 | integer | CDO | ???
+  !> 4 | integer | ICEO | ???
+  !> 4 | integer | ICEHO  | ???
+  !> 4 | integer | ICEFO | ???
+  !> 4 | integer | GRDID | ???
+  !> 4 | integer | SPCO(J,I),J=1,NSPEC | ???
+  !>
   !> @param[in]  INXOUT  Test string for read/write.
   !> @param[in]  NDSOP   File unit number.
   !> @param[out] IOTST   Test indictor for reading.