Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

API Reference link redirects circularly #536

Closed
Biarity opened this issue Nov 21, 2016 · 6 comments
Closed

API Reference link redirects circularly #536

Biarity opened this issue Nov 21, 2016 · 6 comments

Comments

@Biarity
Copy link

Biarity commented Nov 21, 2016

If you go to suave.io/Suave.html (by clicking the 'API Reference' button), then click on the API Reference button at the bottom of the page (last word of the paragraph), you will be redirected to the same page.

I didn't make a PR because I don't know what the intended page is. Is there even an API Reference?
@haf
Copy link
Contributor

haf commented Nov 21, 2016

Yes there is, but the doc gen has broken with an indecipherable error (see the Rakefile). Sorry about that...

@haf
Copy link
Contributor

haf commented Mar 25, 2017 •
edited
Loading

https://github.com/polytypic/FsLibTool

mono packages/docs/FsLibTool/tools/FsLibTool.exe src docs/_site
Generating reference for Suave.
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: create
Failed to resolve: path
Failed to resolve: path
Failed to resolve: empty
Failed to resolve: path
Failed to resolve: HttpRuntime
Failed to resolve: create
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: path
Failed to resolve: Http
Failed to resolve: Http.host

Unhandled Exception:
System.Exception: Failed to escape text properly: []
  at RefGen+inCode@356-1.Invoke (System.String message) [0x00001] in <567571a9e56832f5a7450383a9717556>:0
  at Microsoft.FSharp.Core.PrintfImpl+StringPrintfEnv`1[TResult].Finalize () [0x00012] in <5584aad2904cf4daa7450383d2aa8455>:0
  at Microsoft.FSharp.Core.PrintfImpl+Final1@224[TState,TResidue,TResult,A].Invoke (Microsoft.FSharp.Core.FSharpFunc`2[T,TResult] env, A a) [0x00038] in <5584aad2904cf4daa7450383d2aa8455>:0
  at Microsoft.FSharp.Core.OptimizedClosures+Invoke@3253[T2,TResult,T1].Invoke (T2 u) [0x00001] in <5584aad2904cf4daa7450383d2aa8455>:0
  at RefGen.inCode@343 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Char esc, System.Int32 i0, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg4) [0x00158] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.printDescription (System.IO.TextWriter wr, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, RefGen+Item item) [0x000ad] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen+printDescription@414-1.Invoke (RefGen+Item item) [0x00001] in <567571a9e56832f5a7450383a9717556>:0
  at Microsoft.FSharp.Collections.SeqModule.Iterate[T] (Microsoft.FSharp.Core.FSharpFunc`2[T,TResult] action, System.Collections.Generic.IEnumerable`1[T] source) [0x0002d] in <5584aad2904cf4daa7450383d2aa8455>:0
  at RefGen.printDescription (System.IO.TextWriter wr, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, RefGen+Item item) [0x000d8] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen+printDescription@414-1.Invoke (RefGen+Item item) [0x00001] in <567571a9e56832f5a7450383a9717556>:0
  at Microsoft.FSharp.Collections.SeqModule.Iterate[T] (Microsoft.FSharp.Core.FSharpFunc`2[T,TResult] action, System.Collections.Generic.IEnumerable`1[T] source) [0x0002d] in <5584aad2904cf4daa7450383d2aa8455>:0
  at RefGen.printDescription (System.IO.TextWriter wr, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, RefGen+Item item) [0x000d8] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen+printDescription@414-1.Invoke (RefGen+Item item) [0x00001] in <567571a9e56832f5a7450383a9717556>:0
  at Microsoft.FSharp.Collections.SeqModule.Iterate[T] (Microsoft.FSharp.Core.FSharpFunc`2[T,TResult] action, System.Collections.Generic.IEnumerable`1[T] source) [0x0002d] in <5584aad2904cf4daa7450383d2aa8455>:0
  at RefGen.printDescription (System.IO.TextWriter wr, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, RefGen+Item item) [0x000d8] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.generate (System.IO.TextWriter wr, System.String title, System.String path) [0x001c2] in <567571a9e56832f5a7450383a9717556>:0
  at Main.genDocs (Main+LibInfo lib) [0x0002f] in <567571a9e56832f5a7450383a9717556>:0
  at Main.main (System.String[] argv) [0x0006a] in <567571a9e56832f5a7450383a9717556>:0
[ERROR] FATAL UNHANDLED EXCEPTION: System.Exception: Failed to escape text properly: []
  at RefGen+inCode@356-1.Invoke (System.String message) [0x00001] in <567571a9e56832f5a7450383a9717556>:0
  at Microsoft.FSharp.Core.PrintfImpl+StringPrintfEnv`1[TResult].Finalize () [0x00012] in <5584aad2904cf4daa7450383d2aa8455>:0
  at Microsoft.FSharp.Core.PrintfImpl+Final1@224[TState,TResidue,TResult,A].Invoke (Microsoft.FSharp.Core.FSharpFunc`2[T,TResult] env, A a) [0x00038] in <5584aad2904cf4daa7450383d2aa8455>:0
  at Microsoft.FSharp.Core.OptimizedClosures+Invoke@3253[T2,TResult,T1].Invoke (T2 u) [0x00001] in <5584aad2904cf4daa7450383d2aa8455>:0
  at RefGen.inCode@343 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Char esc, System.Int32 i0, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg4) [0x00158] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.inPara@324 (System.IO.TextWriter wr, RefGen+Item item, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, Microsoft.FSharp.Collections.FSharpList`1[T] path, System.Int32 i, Microsoft.FSharp.Collections.FSharpList`1[T] _arg3) [0x00168] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.printDescription (System.IO.TextWriter wr, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, RefGen+Item item) [0x000ad] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen+printDescription@414-1.Invoke (RefGen+Item item) [0x00001] in <567571a9e56832f5a7450383a9717556>:0
  at Microsoft.FSharp.Collections.SeqModule.Iterate[T] (Microsoft.FSharp.Core.FSharpFunc`2[T,TResult] action, System.Collections.Generic.IEnumerable`1[T] source) [0x0002d] in <5584aad2904cf4daa7450383d2aa8455>:0
  at RefGen.printDescription (System.IO.TextWriter wr, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, RefGen+Item item) [0x000d8] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen+printDescription@414-1.Invoke (RefGen+Item item) [0x00001] in <567571a9e56832f5a7450383a9717556>:0
  at Microsoft.FSharp.Collections.SeqModule.Iterate[T] (Microsoft.FSharp.Core.FSharpFunc`2[T,TResult] action, System.Collections.Generic.IEnumerable`1[T] source) [0x0002d] in <5584aad2904cf4daa7450383d2aa8455>:0
  at RefGen.printDescription (System.IO.TextWriter wr, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, RefGen+Item item) [0x000d8] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen+printDescription@414-1.Invoke (RefGen+Item item) [0x00001] in <567571a9e56832f5a7450383a9717556>:0
  at Microsoft.FSharp.Collections.SeqModule.Iterate[T] (Microsoft.FSharp.Core.FSharpFunc`2[T,TResult] action, System.Collections.Generic.IEnumerable`1[T] source) [0x0002d] in <5584aad2904cf4daa7450383d2aa8455>:0
  at RefGen.printDescription (System.IO.TextWriter wr, Microsoft.FSharp.Collections.FSharpMap`2[TKey,TValue] id2items, RefGen+Item item) [0x000d8] in <567571a9e56832f5a7450383a9717556>:0
  at RefGen.generate (System.IO.TextWriter wr, System.String title, System.String path) [0x001c2] in <567571a9e56832f5a7450383a9717556>:0
  at Main.genDocs (Main+LibInfo lib) [0x0002f] in <567571a9e56832f5a7450383a9717556>:0
  at Main.main (System.String[] argv) [0x0006a] in <567571a9e56832f5a7450383a9717556>:0
rake aborted!
Albacore::CommandFailedError: Command failed with status (1):
  mono packages/docs/FsLibTool/tools/FsLibTool.exe src docs/_site
Generating reference for Suave.
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: create
Failed to resolve: path
Failed to resolve: path
Failed to resolve: empty
Failed to resolve: path
Failed to resolve: HttpRuntime
Failed to resolve: create
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: HttpContext
Failed to resolve: path
Failed to resolve: Http
Failed to resolve: Http.host

@haf haf mentioned this issue Mar 25, 2017
Open
@johanvts
Copy link

I can't find docs/_site, did it move?

@haf
Copy link
Contributor

haf commented Mar 25, 2017

It's generated: bundle exec rake docs:build

@rmunn rmunn mentioned this issue Apr 27, 2017
Merged
@rmunn
Copy link
Contributor

rmunn commented Apr 27, 2017

#615 should fix this: once it's merged in and @haf (or whoever) pushes the built docs up to the website, the API Reference docs should work again.

@haf
Copy link
Contributor

haf commented Apr 27, 2017

Fixed thanks to @rmunn – I've pushed the docs again.

@haf haf closed this as completed Apr 27, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
4 participants
@rmunn @haf @johanvts @Biarity