Re: @PageBox troubles

[Valeriy E. Ushakov]

Hello, Lout folk!

On Tue, 12 Sep 1995, Rodrigo Vanegas wrote:

> Why won't the following simple document work?
> 
>   @SysInclude { doc }
>   @Document
>     @PageBoxType { CurveBox }
>   //
>   @Text @Begin
>   blah blah blah
>   @End @Text
> 
> The error is simply this.
> 
>   3,3: symbol @PageBoxType unknown or misspelt
>   2,1 fatal error: missing @Break symbol or option
> 
> It works fine if I instead make my own copy of include/doc and
> uncomment the appropriate line there.  But I am lead to believe that
> the above will work by the beginning of chapter 3 in the user's guide.
> Any ideas?
> 
> Rodrigo Vanegas
> <address@hidden>

This is very simple. I too make such mistakes every now and then. Here
is how it (doesn't) works:

>>>> in include/dl

def @DocumentLayout
    ....
    named @PageBoxType          {  None         } # None Box CurveBox ShadowBox
    ....
@Begin
@End @DocumentLayout


>>>> in include/docf

    def @Document # default values are taken from @DocumentLayout
        named @InitialFont { @InitialFont }
        named @InitialBreak { @InitialBreak } 
        named @InitialLanguage { @InitialLanguage }
        named @PageHeaders { @PageHeaders }
        named @ColumnNumber { @ColumnNumber }
        named @FirstPageNumber { @FirstPageNumber }
    {
        ....
    }

>>>> in include/doc

@Use { @DocumentLayout
  ....
  # @PageBoxType        { None                  } # None Box CurveBox ShadowBox
  ....
}


Now you see, you are trying to pass @PageBoxType to a wrong function.
Since Lout knows there's no such named argument to @Document symbol it
treats it as just another word, but warns about @ sign in it:

        3,3: symbol @PageBoxType unknown or misspelt


The second error message is less evident:

        2,1 fatal error: missing @Break symbol or option

This refers to @Document symbol(?!). But I don't know why :-( I have
no debugging-enabled Lout installed and can't track it down for you.
If you write it the other way round:

        @Document @PageBoxType { CurveBox }

You'll get the message that makes more sense.

        2,11 fatal error: no current font at word @PageBoxType

Both these 2,* messages are from manifestation code (z08.c:Manifest).
Recall that @Document is only a *galley* that is a slot objects will
go into. And @Text targets its contents into this galley. Here
@PageBoxType is a word out of style (@Font, @Break, @Language etc),
that's the reason for these messages.

Also, page 45 of User Guide (sect 3.1) states that there're six options
to @Document and lists them all

Hope it helps.

Best regards!

SY, Uwe.
--------
Valeriy E. Ushakov (aka Uwe)            |       Zu Grunde kommen
address@hidden                         |       Ist zu Grunde gehen