better names and docs

Author: shashi

page/codegen.md

@@ -33,6 +33,8 @@ These are all exported when you do `using SymbolicUtils.Code`
 
 {{doc Func Func type Code}}
 
+{{doc SpawnFetch SpawnFetch type Code}}
+
 {{doc SetArray SetArray type Code}}
 
 {{doc MakeArray MakeArray type Code}}

src/code.jl

@@ -4,7 +4,7 @@ using StaticArrays, LabelledArrays, SparseArrays
 
 export toexpr, Assignment, (←), Let, Func, DestructuredArgs, LiteralExpr,
        SetArray, MakeArray, MakeSparseArray, MakeTuple, AtIndex,
-       Par, Multithreaded
+       SpawnFetch, Multithreaded
 
 import ..SymbolicUtils
 import SymbolicUtils: @matchable, Sym, Term, istree, operation, arguments
@@ -464,15 +464,21 @@ end
 
 struct Multithreaded end
 """
-    Par(exprs, reduce)
+    SpawnFetch{ParallelType}(exprs, reduce)
 
+Run every expr in `exprs` in its own task, and use the `reduce`
+function to combine the results of executing `exprs`.
+
+`ParallelType` can be used to define more parallelism types
+SymbolicUtils supports `Multithreaded` type. Which spawns
+threaded tasks.
 """
-struct Par{Typ}
+struct SpawnFetch{Typ}
     exprs::Vector
     combine
 end
 
-function toexpr(p::Par{Multithreaded}, st)
+function toexpr(p::SpawnFetch{Multithreaded}, st)
     spawns = map(p.exprs) do thunk
         :(Base.Threads.@spawn $(toexpr(thunk, st)))
     end

test/code.jl

@@ -124,7 +124,7 @@ test_repr(a, b) = @test repr(Base.remove_linenums!(a)) == repr(Base.remove_linen
     test_repr(toexpr(MakeTuple((a, b, a+b))),
               :((a,b,$(+)(a,b))))
 
-    @test Par{Multithreaded}([1,2],vcat)|>toexpr|>eval == [1,2]
-    @test @elapsed(Par{Multithreaded}([:(sleep(.3)),:(sleep(.6))],vcat)|>toexpr|>eval) < 0.8
+    @test SpawnFetch{Multithreaded}([1,2],vcat)|>toexpr|>eval == [1,2]
+    @test @elapsed(SpawnFetch{Multithreaded}([:(sleep(.3)),:(sleep(.6))],vcat)|>toexpr|>eval) < 0.8
 end