Re: [racket] design and rationale of ports

2010-11-10 Thread YC
On Wed, Nov 10, 2010 at 10:38 AM, Taylor R Campbell < campbell+rac...@mumble.net > wrote: > > The documentation describes the contract of MAKE-INPUT-PORT and > MAKE-OUTPUT-PORT. That doesn't tell me how the pieces fit together, > though, or say what one can do with them, or give any guidance on h

Re: [racket] design and rationale of ports

2010-11-10 Thread Robby Findler
I know it doesn't replace good guide documentation, but there are a few uses of make-input-port and make-output-port in the standard libraries. One of the most complex ones is the implementation of the IO ports that drracket uses as part of the implementation of the interactions window. Robby On

Re: [racket] design and rationale of ports

2010-11-10 Thread Taylor R Campbell
Date: Wed, 10 Nov 2010 00:12:13 -0800 From: YC On Wed, Nov 10, 2010 at 12:00 AM, Taylor R Campbell > wrote: > I am completely lost in the documentation and implementation of ports. > Is there a document giving a high-level overview of the design of the > port abstraction in Ra

Re: [racket] design and rationale of ports

2010-11-10 Thread namekuseijin
On Wed, Nov 10, 2010 at 6:00 AM, Taylor R Campbell wrote: > I am completely lost in the documentation and implementation of ports. > Is there a document giving a high-level overview of the design of the > port abstraction in Racket http://docs.racket-lang.org/guide/i_o.html the guide is easier o

Re: [racket] design and rationale of ports

2010-11-10 Thread Hendrik Boom
On Wed, Nov 10, 2010 at 05:37:30AM -0700, Jay McCarthy wrote: > Like YC suggests, a better place to start may be: What are you trying > to do with ports that you need these details? > > Jay And when the answers start to appear, write up some of the docs you wish you had had to start with. -- he

Re: [racket] design and rationale of ports

2010-11-10 Thread Jay McCarthy
Like YC suggests, a better place to start may be: What are you trying to do with ports that you need these details? Jay On Wed, Nov 10, 2010 at 1:00 AM, Taylor R Campbell wrote: > I am completely lost in the documentation and implementation of ports. > Is there a document giving a high-level ove

Re: [racket] design and rationale of ports

2010-11-10 Thread YC
On Wed, Nov 10, 2010 at 12:00 AM, Taylor R Campbell < campbell+rac...@mumble.net > wrote: > I am completely lost in the documentation and implementation of ports. > Is there a document giving a high-level overview of the design of the > port abstraction in Racket, and its rationale, ideally with m

[racket] design and rationale of ports

2010-11-10 Thread Taylor R Campbell
I am completely lost in the documentation and implementation of ports. Is there a document giving a high-level overview of the design of the port abstraction in Racket, and its rationale, ideally with motivating examples of tasks requiring all the various bizarre knobs and buttons of the abstractio