Re: [apps-discuss] Applications Directorate Review of draft-desruisseaux-caldav-sched-11

[Eliot Lear <[e-mail]>]

Hi Cyrus,

On 3/8/12 4:51 PM, Cyrus Daboo wrote:
> Hi Eliot,
>
> --On March 8, 2012 2:52:42 PM +0100 Eliot Lear <[e-mail]> wrote:
>
>> Please read my review where I suggest text that references tables.
>
> Just on this one point:
>
> 1) There is only ever one table per section in the draft, so a
> reference to a table can be reasonably provided as "the table in
> Section XXX".
>
> 2) Most the the tables are defined using xml2rfc <texttable> elements.
> However, some tables are too complex for xml2rfc's table layout, and
> hence are implemented as ascii-art in a <figure>. That poses a problem
> when using xml2rfc's built-in references because <texttable>
> references appear as "Table 1", whereas <figure> references appear as
> "Figure 1". That would mean we had a mixture of different reference
> labels. Now, it is possible to change all the current <texttable>
> elements to be ascii art instead, but given point #1 above, I would
> rather not have to do that.

>
> So bottom line, my preference is to use a reference of the form
> described in #1 above whenever needed.
>

Ok.  I feel your pain on this point.

Eliot