From d14ab120aa988e8e151d79a0b203d71878c7a8f1 Mon Sep 17 00:00:00 2001
From: David Phillips <david@acz.org>
Date: Wed, 2 Oct 2024 11:41:14 -0700
Subject: [PATCH] Add WASI doc links for flags and enums

---
 wasi/README.md                                              | 6 ++++--
 .../src/main/java/com/dylibso/chicory/wasi/WasiClockId.java | 3 +++
 wasi/src/main/java/com/dylibso/chicory/wasi/WasiErrno.java  | 3 +++
 .../src/main/java/com/dylibso/chicory/wasi/WasiFdFlags.java | 3 +++
 .../main/java/com/dylibso/chicory/wasi/WasiFileType.java    | 3 +++
 .../main/java/com/dylibso/chicory/wasi/WasiFstFlags.java    | 3 +++
 .../main/java/com/dylibso/chicory/wasi/WasiLookupFlags.java | 3 +++
 .../main/java/com/dylibso/chicory/wasi/WasiOpenFlags.java   | 3 +++
 wasi/src/main/java/com/dylibso/chicory/wasi/WasiRights.java | 3 +++
 wasi/src/main/java/com/dylibso/chicory/wasi/WasiWhence.java | 3 +++
 10 files changed, 31 insertions(+), 2 deletions(-)

diff --git a/wasi/README.md b/wasi/README.md
index 09ee1ed63..eadaf29fe 100644
--- a/wasi/README.md
+++ b/wasi/README.md
@@ -6,8 +6,10 @@ by many of the compilers out there.
 
 ## Version Support
 
-There are currently 2 versions of WASI at the moment, [preview1](https://github.com/WebAssembly/WASI/blob/main/legacy/README.md) and [preview2](https://github.com/WebAssembly/WASI/blob/main/preview2/README.md). This library is currently
-aimed at `preview1`.
+There are currently 2 versions of WASI at the moment,
+[preview1](https://github.com/WebAssembly/WASI/blob/v0.2.1/legacy/README.md) and
+[preview2](https://github.com/WebAssembly/WASI/blob/v0.2.1/wasip2/README.md).
+This library is currently aimed at `preview1`.
 
 > **Note**: You might hear the terms `preview1/preview1` or `0.1/0.2` when referring to the versions inside the WASI docs.
 > And you might hear `wasip1` when being used as a flag to a compiler target. We tend to prefer the nomenclature wasip1 / wasip2.
diff --git a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiClockId.java b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiClockId.java
index 90a95391f..1e63cf05e 100644
--- a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiClockId.java
+++ b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiClockId.java
@@ -1,5 +1,8 @@
 package com.dylibso.chicory.wasi;
 
+/**
+ * WASI <a href="https://github.com/WebAssembly/WASI/blob/v0.2.1/legacy/preview1/docs.md#clockid">clockid</a>
+ */
 final class WasiClockId {
     private WasiClockId() {}
 
diff --git a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiErrno.java b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiErrno.java
index f4f8827c3..06f188680 100644
--- a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiErrno.java
+++ b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiErrno.java
@@ -1,5 +1,8 @@
 package com.dylibso.chicory.wasi;
 
+/**
+ * WASI <a href="https://github.com/WebAssembly/WASI/blob/v0.2.1/legacy/preview1/docs.md#errno">errno</a>
+ */
 enum WasiErrno {
     ESUCCESS,
     E2BIG,
diff --git a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiFdFlags.java b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiFdFlags.java
index c53b15581..5f56caf3c 100644
--- a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiFdFlags.java
+++ b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiFdFlags.java
@@ -1,5 +1,8 @@
 package com.dylibso.chicory.wasi;
 
+/**
+ * WASI <a href="https://github.com/WebAssembly/WASI/blob/v0.2.1/legacy/preview1/docs.md#fdflags">fdflags</a>
+ */
 final class WasiFdFlags {
     private WasiFdFlags() {}
 
diff --git a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiFileType.java b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiFileType.java
index 72cc75c3e..4cffa1da9 100644
--- a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiFileType.java
+++ b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiFileType.java
@@ -1,5 +1,8 @@
 package com.dylibso.chicory.wasi;
 
+/**
+ * WASI <a href="https://github.com/WebAssembly/WASI/blob/v0.2.1/legacy/preview1/docs.md#filetype">filetype</a>
+ */
 enum WasiFileType {
     UNKNOWN,
     BLOCK_DEVICE,
diff --git a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiFstFlags.java b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiFstFlags.java
index 34244c2e0..1b9afd0a4 100644
--- a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiFstFlags.java
+++ b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiFstFlags.java
@@ -1,5 +1,8 @@
 package com.dylibso.chicory.wasi;
 
+/**
+ * WASI <a href="https://github.com/WebAssembly/WASI/blob/v0.2.1/legacy/preview1/docs.md#fstflags">fstflags</a>
+ */
 final class WasiFstFlags {
     private WasiFstFlags() {}
 
diff --git a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiLookupFlags.java b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiLookupFlags.java
index 33616a9b5..a9f2dbe4c 100644
--- a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiLookupFlags.java
+++ b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiLookupFlags.java
@@ -1,5 +1,8 @@
 package com.dylibso.chicory.wasi;
 
+/**
+ * WASI <a href="https://github.com/WebAssembly/WASI/blob/v0.2.1/legacy/preview1/docs.md#lookupflags">lookupflags</a> flags
+ */
 final class WasiLookupFlags {
     private WasiLookupFlags() {}
 
diff --git a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiOpenFlags.java b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiOpenFlags.java
index 1d4cb8c42..5938c04af 100644
--- a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiOpenFlags.java
+++ b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiOpenFlags.java
@@ -1,5 +1,8 @@
 package com.dylibso.chicory.wasi;
 
+/**
+ * WASI <a href="https://github.com/WebAssembly/WASI/blob/v0.2.1/legacy/preview1/docs.md#oflags">oflags</a>
+ */
 final class WasiOpenFlags {
     private WasiOpenFlags() {}
 
diff --git a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiRights.java b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiRights.java
index 47972dcdd..edf37a057 100644
--- a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiRights.java
+++ b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiRights.java
@@ -1,5 +1,8 @@
 package com.dylibso.chicory.wasi;
 
+/**
+ * WASI <a href="https://github.com/WebAssembly/WASI/blob/v0.2.1/legacy/preview1/docs.md#rights">rights</a>
+ */
 final class WasiRights {
     private WasiRights() {}
 
diff --git a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiWhence.java b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiWhence.java
index 726c29c4e..4306f1631 100644
--- a/wasi/src/main/java/com/dylibso/chicory/wasi/WasiWhence.java
+++ b/wasi/src/main/java/com/dylibso/chicory/wasi/WasiWhence.java
@@ -1,5 +1,8 @@
 package com.dylibso.chicory.wasi;
 
+/**
+ * WASI <a href="https://github.com/WebAssembly/WASI/blob/v0.2.1/legacy/preview1/docs.md#whence">whence</a>
+ */
 final class WasiWhence {
     private WasiWhence() {}