[racket] scribbling newbie questions

Thanks Matthew and Danny.

Now my three questions have been answered with clear examples and enough
info to find the appropriate docs of Scribble.

Matthew, I enjoyed your talk very much. As I always have used MsWord for
docs, I was accustomed immediately to see what I get and to make macros in
the MsWord manner (no, I don't program in Java, I just let MsWord make the
macro and afterwards I delete all assignments I don't want or adapt them to
my wishes) In your video I saw you using the 'Scribble HTML' button, which
helps me a lot. After every couple of lines I use the button to see whether
or not I get what I want. I did not see the button before. The conversion to
HTML is extremely fast. I think your message that there is no (or there
should not be an) essential distinction between programs, data and docs (for
the purpose of abstraction) has arrived to me.

THANKS, Jos

-----Original Message-----
From: Matthew Flatt [mailto:mflatt at cs.utah.edu] 
Sent: jueves, 31 de enero de 2013 22:14
To: Jos Koot
Cc: users at racket-lang.org
Subject: Re: [racket] scribbling newbie questions

At Thu, 31 Jan 2013 18:40:06 +0100, "Jos Koot" wrote:
> Q1
> @racket[(string-length ((fmt "I") #e1e100000))]
> is expanded to
> (string-length ((fmt "I") 1000....000))
> with 100000 zeros. How can I make scribble render #e1e100000 as
#e1e100000?

You could use `code' instead of `racket':

  @code{(string-length ((fmt "I") #e1e100000))}

I think `code' is probably better than `racket' most of the time, but
they different strengths and weaknesses.

> Q3
> I try
> @tabular[#:sep @hspace[3] #:style 'top (list (list ....]
> in an attempt to have each element justified at top, but this does no show
> any effect. How can I outline like in:
>  
> item1   this is item-1
>         Not important.
>  
> item2   this is item-2
>         not important either.
>  
> item3   end
>         of this
>         question.

You need to make a style that has a `table-columns' property that has a
style with a 'top property for each column:

 (let ([top (style #f '(top))])
   (style #f (list (table-columns (list top top top)))))

Granted, that's complicated. The `tabular' form should provide simpler
support for constructing the right style.