Re-enable doctests in CI

.github/workflows/CI.yml

@@ -107,12 +107,9 @@ jobs:
             using Pkg
             Pkg.develop(PackageSpec(path=pwd()))
             Pkg.instantiate()'
-      #- name: Run doctests
-      #  run: |
-      #    julia --project=docs --color=yes -e '
-      #      using Documenter, GAP
-      #      DocMeta.setdocmeta!(GAP, :DocTestSetup, :(using GAP); recursive = true)
-      #      doctest(GAP)'
+      - name: Run doctests
+        run: |
+          julia --project=docs --color=yes test/doctest.jl
       - name: Deploy documentation
         run: julia --project=docs --color=yes docs/make.jl
         env:

src/constructors.jl

@@ -362,7 +362,7 @@ involves only native Julia objects such as integers and strings.
 Dealing with results containing GAP objects will be inefficient.
 
 # Examples
-```jldoctest
+```
 julia> Set{Int}(GAP.evalstr("[ 1, 2, 1 ]"))
 Set{Int64} with 2 elements:
   2
@@ -373,7 +373,7 @@ Set{Array{Int64,1}} with 2 elements:
   [1]
   [2]
 
-julia> Set{String}(GAP.evalstr("[\"a\", \"b\"]"))
+julia> Set{String}(GAP.evalstr("[\\"a\\", \\"b\\"]"))
 Set{String} with 2 elements:
   "b"
   "a"

src/macros.jl

@@ -30,7 +30,7 @@ not all expressions representing valid GAP code can be processed.
 For example, the GAP syntax of permutations consisting of more than one cycle
 cause problems, as well as the GAP syntax of non-dense lists.
 
-```jldoctest
+```
 julia> @gap (1,2,3)
 GAP: (1,2,3)
 

test/doctest.jl

@@ -0,0 +1,11 @@
+using Documenter, GAP
+
+DocMeta.setdocmeta!(GAP, :DocTestSetup, :(using GAP); recursive = true)
+
+doctest(GAP; doctestfilters = Regex[
+  r"BitVector|BitArray\{1\}",
+  r"Matrix\{Int64\}|Array\{Int64,2\}",
+  r"Vector\{Any\}|Array\{Any,1\}",
+  r"Vector\{Int64\}|Array\{Int64,1\}",
+  r"Vector\{UInt8\}|Array\{UInt8,1\}",
+])

test/runtests.jl

@@ -1,7 +1,5 @@
 using Test, Documenter, GAP
 
-DocMeta.setdocmeta!(GAP, :DocTestSetup, :(using GAP); recursive = true)
-
 include("basics.jl")
 include("adapter.jl")
 include("convenience.jl")
@@ -11,4 +9,6 @@ include("convert.jl")
 include("macros.jl")
 include("packages.jl")
 include("help.jl")
-# include("testmanual.jl")  # skip this for now, difficult to get to work on all Julia versions
+@testset "manual examples" begin
+  include("doctest.jl")
+end