From 8535b26a754b2daea46627019e3145d7c12d826e Mon Sep 17 00:00:00 2001
From: Timothee Cour <timothee.cour2@gmail.com>
Date: Fri, 25 Jun 2021 07:47:10 -0700
Subject: [PATCH] docs now show nimExperimentalX APIs (#18345)

* docs now show nimExperimentalX APIs

* fix for windows
---
 lib/std/jsfetch.nim                  |  2 +-
 lib/wrappers/linenoise/linenoise.nim | 12 ++++++------
 tests/config.nims                    |  3 +++
 tools/kochdocs.nim                   |  3 ++-
 4 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/lib/std/jsfetch.nim b/lib/std/jsfetch.nim
index 36bc772d5..1e7bb4d29 100644
--- a/lib/std/jsfetch.nim
+++ b/lib/std/jsfetch.nim
@@ -3,7 +3,7 @@
 when not defined(js):
   {.fatal: "Module jsfetch is designed to be used with the JavaScript backend.".}
 
-when defined(nimExperimentalJsfetch) or defined(nimdoc):
+when defined(nimExperimentalJsfetch):
   import std/[asyncjs, jsheaders, jsformdata]
   from std/httpcore import HttpMethod
   from std/jsffi import JsObject
diff --git a/lib/wrappers/linenoise/linenoise.nim b/lib/wrappers/linenoise/linenoise.nim
index 5b1fa7190..186b3b252 100644
--- a/lib/wrappers/linenoise/linenoise.nim
+++ b/lib/wrappers/linenoise/linenoise.nim
@@ -32,17 +32,17 @@ proc printKeyCodes*() {.importc: "linenoisePrintKeyCodes".}
 
 proc free*(s: cstring) {.importc: "free", header: "<stdlib.h>".}
 
-when defined nimExperimentalLinenoiseExtra:
+when defined(nimExperimentalLinenoiseExtra) and not defined(windows):
   # C interface
-  type linenoiseStatus = enum
+  type LinenoiseStatus = enum
     linenoiseStatus_ctrl_unknown
     linenoiseStatus_ctrl_C
     linenoiseStatus_ctrl_D
 
-  type linenoiseData* = object
-    status: linenoiseStatus
+  type LinenoiseData* = object
+    status: LinenoiseStatus
 
-  proc linenoiseExtra(prompt: cstring, data: ptr linenoiseData): cstring {.importc.}
+  proc linenoiseExtra(prompt: cstring, data: ptr LinenoiseData): cstring {.importc.}
 
   # stable nim interface
   type Status* = enum
@@ -65,7 +65,7 @@ when defined nimExperimentalLinenoiseExtra:
         if ret.line.len > 0: echo ret.line
         if ret.status == lnCtrlD: break
       echo "exiting"
-    var data: linenoiseData
+    var data: LinenoiseData
     let buf = linenoiseExtra(prompt, data.addr)
     result.line = $buf
     free(buf)
diff --git a/tests/config.nims b/tests/config.nims
index 578b69e76..539de5e8d 100644
--- a/tests/config.nims
+++ b/tests/config.nims
@@ -30,4 +30,7 @@ hint("Processing", off)
 # switch("hint", "ConvFromXtoItselfNotNeeded")
 
 # experimental API's are enabled in testament, refs https://github.com/timotheecour/Nim/issues/575
+# sync with `kochdocs.docDefines` or refactor.
 switch("define", "nimExperimentalAsyncjsThen")
+switch("define", "nimExperimentalJsfetch")
+switch("define", "nimExperimentalLinenoiseExtra")
diff --git a/tools/kochdocs.nim b/tools/kochdocs.nim
index f25564fad..469059348 100644
--- a/tools/kochdocs.nim
+++ b/tools/kochdocs.nim
@@ -8,7 +8,8 @@ const
   gaCode* = " --doc.googleAnalytics:UA-48159761-1"
   # errormax: subsequent errors are probably consequences of 1st one; a simple
   # bug could cause unlimited number of errors otherwise, hard to debug in CI.
-  nimArgs = "--errormax:3 --hint:Conf:off --hint:Path:off --hint:Processing:off --hint:XDeclaredButNotUsed:off --warning:UnusedImport:off -d:boot --putenv:nimversion=$#" % system.NimVersion
+  docDefines = "-d:nimExperimentalAsyncjsThen -d:nimExperimentalJsfetch -d:nimExperimentalLinenoiseExtra"
+  nimArgs = "--errormax:3 --hint:Conf:off --hint:Path:off --hint:Processing:off --hint:XDeclaredButNotUsed:off --warning:UnusedImport:off -d:boot --putenv:nimversion=$# $#" % [system.NimVersion, docDefines]
   gitUrl = "https://github.com/nim-lang/Nim"
   docHtmlOutput = "doc/html"
   webUploadOutput = "web/upload"