With the manual a bit out of date, I've found it handy to just type a function name at the interactive prompt to list its methods (or one can use "methods( funcname)"). I've even rummaged around inside the julia source code in search of interesting undocumented functions. Like Miguel I was surprised to find out that readall took a Cmd as an arg:
Methods for generic function readall
readall(IOStream,) at io.jl:241
readall(String,) at io.jl:245
readall(Union(Set{Port},Port),) at process.jl:491
readall(Union(Set{Cmd},Cmd),) at process.jl:492
Note the somewhat curious method listed for readchomp:
Methods for generic function readchomp
readchomp(Any,) at io.jl:247
I imagine that some of these "rough edges" in the library and documentation are just normal signs of a rapidly-developing language and will eventually be cleaned up.
-- Dave Slate