This is a workaround for #3182, no forward declarations. You can now do
this:
```nim
async:
proc bar(): Future[T]
proc foo() = await bar()
proc bar() {.async.} = echo(123); await foo()
```
Prior to the change, "nim check" would fail on any file besides the
main nim.nim, because the include paths for the documentation were
not set correctly and this produced various compilation errors.
Saw in https://github.com/nim-lang/nimforum/issues/41 that there was an
issue in rendering inline images. Traced back through rstgen and found
that it was not counting something like:
`.. image:: http://i.imgur.com/oCem13Y.png` as valid since it contained
a period, and this wasn't in the set of valid characters, so the empty
string is returned by default.
Added a period to the allowable characters, and now renders correctly.
Test case:
```
import rst, rstgen, strtabs
var docConfig: StringTableRef
docConfig = rstgen.defaultConfig()
docConfig["doc.smiley_format"] = "/images/smilieys/$1.png"
proc rstToHtml(content: string): string =
result = rstgen.rstToHtml(content, {roSupportSmilies,roSupportMarkdown},
docConfig)
var a: string = rstToHtml(".. image:: http://i.imgur.com/oCem13Y.png")
echo a
```
type, then converter, then 3 iterators lowest- to highest-level
(also fastest to slowest) including a new intermediate iterator
lines(MemFile, buffer) that is more like readLine(File) in case
that helps anyone port code.
Add doc comments.
Also have toString just use newString+c_memcpy instead of
currently fragile toNimStr which Araq wants a separate PR for.
Ensure the correct destination hostname is used in the request, otherwise the request will fail in one of a number of interesting ways when using a proxy.
Fixes https://github.com/nim-lang/Nim/issues/3166
