I think we need both. Surely the API is the set of commands, switches,
etc. which the application can use to control the behaviour of the XML
processor and issue requests to it, while the "ESIS" is the well-
understood format in which the XML processor serves up the requested
results to the application?
Is it fair to say that the XML API is functionally equivalent to the
command line arguments in NSGMLS, while the "XML ESIS" is (more
obviously) equivalent to the ESIS output by NSGMLS? That's how I tend
to see it.
The advantage of an API over an NSGMLS-style command line is that you
can have any number of bites at the cherry, retrieving relevant bits of
the XML document each time. For example, a browsing app might start by
requesting the only element structure for the whole document (to fill an
'outline' window), then go back and ask for content for the first few
elements until it had enough to fill a 'data window'.
Richard Light
SGML and Museum Information Consultancy
richard@light.demon.co.uk
3 Midfields Walk
Burgess Hill
West Sussex RH15 8JA
U.K.
tel. (44) 1444 232067