Add autodocs for all libraries [only docs]

Author: gdalle

docs/Manifest.toml

@@ -1,9 +1,21 @@
 [deps]
 BenchmarkTools = "6e4b80f9-dd63-53aa-95a3-0cdb28fa8baf"
+CUDA = "052768ef-5323-5732-b1bb-66c8b64840ba"
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
 Literate = "98b081ad-f1c9-55d3-8b20-4c87d4299306"
 Markdown = "d6f4376e-aef5-505a-96c1-9c027394607a"
 Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40"
+cuDNN = "02a925ec-e4fe-4b08-9a7e-0d78e3d38ccd"
+cuStateVec = "92f7fd98-d22e-4c0d-85a8-6ade11b672fb"
+cuTENSOR = "011b41b2-24ef-40a8-b3eb-fa098493e9e1"
+cuTensorNet = "448d79b3-4b49-4e06-a5ea-00c62c0dc3db"
+
+[sources]
+CUDA = {path = ".."}
+cuDNN = {path = "../lib/cudnn"}
+cuStateVec = {path = "../lib/custatevec"}
+cuTENSOR = {path = "../lib/cutensor"}
+cuTensorNet = {path = "../lib/cutensornet"}
 
 [compat]
 Documenter = "1"

docs/Project.toml

@@ -1,5 +1,7 @@
 using Documenter, Literate
 using CUDA
+using CUDA.CUBLAS, CUDA.CUFFT, CUDA.CUPTI, CUDA.CURAND, CUDA.CUSOLVER, CUDA.CUSPARSE, CUDA.NVML, CUDA.APIUtils
+using cuDNN, cuStateVec, cuTENSOR, cuTensorNet
 
 const src = "https://github.com/JuliaGPU/CUDA.jl"
 const dst = "https://cuda.juliagpu.org/stable/"
@@ -9,17 +11,23 @@ function main()
 
     @info "Building Literate.jl documentation"
     cd(@__DIR__) do
-        Literate.markdown("src/tutorials/introduction.jl", "src/tutorials";
-                          repo_root_url="$src/blob/master/docs")
-        Literate.markdown("src/tutorials/custom_structs.jl", "src/tutorials";
-                          repo_root_url="$src/blob/master/docs")
-        Literate.markdown("src/tutorials/performance.jl", "src/tutorials";
-                          repo_root_url="$src/blob/master/docs")
+        Literate.markdown(
+            "src/tutorials/introduction.jl", "src/tutorials";
+            repo_root_url = "$src/blob/master/docs"
+        )
+        Literate.markdown(
+            "src/tutorials/custom_structs.jl", "src/tutorials";
+            repo_root_url = "$src/blob/master/docs"
+        )
+        Literate.markdown(
+            "src/tutorials/performance.jl", "src/tutorials";
+            repo_root_url = "$src/blob/master/docs"
+        )
     end
     println()
 
     @info "Generating Documenter.jl site"
-    DocMeta.setdocmeta!(CUDA, :DocTestSetup, :(using CUDA); recursive=true)
+    DocMeta.setdocmeta!(CUDA, :DocTestSetup, :(using CUDA); recursive = true)
     makedocs(
         sitename = "CUDA.jl",
         authors = "Tim Besard",
@@ -33,13 +41,27 @@ function main()
         ),
         doctest = true,
         warnonly = [:missing_docs],
-        modules = [CUDA],
+        modules = [
+            CUDA,
+            CUBLAS,
+            CUFFT,
+            CUPTI,
+            CURAND,
+            CUSOLVER,
+            CUSPARSE,
+            NVML,
+            APIUtils,
+            cuDNN,
+            cuStateVec,
+            cuTENSOR,
+            cuTensorNet,
+        ],
         pages = Any[
             "Home" => "index.md",
             "Tutorials" => Any[
                 "tutorials/introduction.md",
                 "tutorials/custom_structs.md",
-                "tutorials/performance.md"
+                "tutorials/performance.md",
             ],
             "Installation" => Any[
                 "installation/overview.md",
@@ -67,13 +89,25 @@ function main()
                 "api/compiler.md",
             ],
             "Library reference" => Any[
-                "lib/driver.md",
+                "lib/cublas.md",
+                "lib/cudadrv.md",
+                "lib/cudnn.md",
+                "lib/cufft.md",
+                "lib/cupti.md",
+                "lib/curand.md",
+                "lib/cusolver.md",
+                "lib/cusparse.md",
+                "lib/custatevec.md",
+                "lib/cutensor.md",
+                "lib/cutensornet.md",
+                "lib/nvml.md",
+                "lib/utils.md",
             ],
             "FAQ" => "faq.md",
         ]
     )
 
-    if ci
+    return if ci
         @info "Deploying to GitHub"
         deploydocs(
             repo = "github.com/JuliaGPU/CUDA.jl.git",

docs/make.jl

@@ -0,0 +1,15 @@
+# CUBLAS
+
+## Public
+
+```@autodocs
+Modules = [CUBLAS]
+Private = false
+```
+
+## Private
+
+```@autodocs
+Modules = [CUBLAS]
+Public = false
+```

docs/src/lib/cublas.md

@@ -0,0 +1,15 @@
+# cuDNN
+
+## Public
+
+```@autodocs
+Modules = [cuDNN]
+Private = false
+```
+
+## Private
+
+```@autodocs
+Modules = [cuDNN]
+Public = false
+```

docs/src/lib/driver.md renamed to docs/src/lib/cudadrv.md

@@ -0,0 +1,15 @@
+# CUFFT
+
+## Public
+
+```@autodocs
+Modules = [CUFFT]
+Private = false
+```
+
+## Private
+
+```@autodocs
+Modules = [CUFFT]
+Public = false
+```

docs/src/lib/cudnn.md

@@ -0,0 +1,15 @@
+# CUPTI
+
+## Public
+
+```@autodocs
+Modules = [CUPTI]
+Private = false
+```
+
+## Private
+
+```@autodocs
+Modules = [CUPTI]
+Public = false
+```

docs/src/lib/cufft.md

@@ -0,0 +1,15 @@
+# CURAND
+
+## Public
+
+```@autodocs
+Modules = [CURAND]
+Private = false
+```
+
+## Private
+
+```@autodocs
+Modules = [CURAND]
+Public = false
+```

docs/src/lib/cupti.md

@@ -0,0 +1,15 @@
+# CUSOLVER
+
+## Public
+
+```@autodocs
+Modules = [CUSOLVER]
+Private = false
+```
+
+## Private
+
+```@autodocs
+Modules = [CUSOLVER]
+Public = false
+```