Commit 18fe5081 authored by Per Cederqvist's avatar Per Cederqvist

Use @dots{} instead of "...".

(Simple Data Types): Use "::=" instead of ":" in two places.
	Added missing @example...@end example markup.  Fixed the
	SELECTION example -- the tail is not optional.
parent 9540bec7
......@@ -4,7 +4,7 @@
@c FIXME: @i{Example:} is only used in front of some examples.
@c FIXME: Make all types clickable in HTML (and info?)
@c
@c $Id: Protocol-A.texi,v 1.117 2001/04/29 13:21:41 ceder Exp $
@c $Id: Protocol-A.texi,v 1.118 2001/04/29 20:45:38 ceder Exp $
@c %**start of header
@setfilename protocol-a.info
@settitle LysKOM Protocol A
......@@ -1782,7 +1782,7 @@ Long live FORTRAN!
boolean-valued flags. Bit strings are denoted as
@example
BITSTRING ( name-1; name-2; name-3; ... )
BITSTRING ( name-1; name-2; name-3; @dots{} )
@end example
in this specification. They are transmitted as a sequence of ASCII ones
......@@ -1791,7 +1791,7 @@ and zeroes in the order the fields are listed.
For instance, given the specification
@example
shape-of-world : BITSTRING (
shape-of-world ::= BITSTRING (
is-flat;
is-round;
is-2d;
......@@ -1819,7 +1819,7 @@ An enumeration is specified as
name-1=value-1;
name-2=value-2;
name-3=value-3;
...
@dots{}
)
@end example
......@@ -1829,7 +1829,9 @@ value-3.
An enumeration can also be inherited from a SELECTION datatype:
Info-type : ENUMERATION_OF(Misc-Info)
@example
Info-type ::= ENUMERATION_OF(Misc-Info)
@end example
This means that Info-type is an enumeration, that contains the same keys
and values as the SELECTION Misc-Info.
......@@ -1839,7 +1841,7 @@ transmitted as the integer 2, ciokwe as the integer 3, and hopi as the
integer 5.
@example
language : ENUMERATION ( hakka = 1;
language ::= ENUMERATION ( hakka = 1;
guwal = 2;
ciokwe = 3;
yoruba = 4;
......@@ -1858,7 +1860,7 @@ The specification for an array is @code{ARRAY @var{type}} where
@var{type} is the type of the array elements.
Arrays are transmitted as an @code{@var{n} @{ @var{element}
@var{element} ... @}} where @var{n} is the number of elements and
@var{element} @dots{} @}} where @var{n} is the number of elements and
each @var{element} is an element of the array. A special case is when
the array is empty, in which case the server transmits it as @code{0 *}.
Note that the client must always transmit empty arrays as @code{0 @{
......@@ -1879,27 +1881,28 @@ followed by a tail of an arbitrary type and is specified as
SELECTION (
@var{n}=@var{name} @var{tail} : @var{type};
@var{n}=@var{name} @var{tail} : @var{type};
...
@dots{}
)
@end example
where each @var{n} is the selector value, @var{name} the selector
name and @var{tail} the name of the selector tail and @var{type}
its type.
its type. @var{name} and @var{tail} are often very similar, such
as @samp{sent-by} and @samp{sender}.
When transmitted, the selector is transmitted as an INT32 followed by
the tail belonging to that selector. For instance, given the
specification
@example
phrase : SELECTION (
1=hello name : HOLLERITH;
2=howdy ;
description ::= SELECTION (
1=name the_name : HOLLERITH;
2=age years : INT32;
)
@end example
two legal messages of the type @code{phrase} are @samp{1 4HJohn} and
@samp{2}.
two legal messages of the type @code{description} are @samp{1 4HJohn} and
@samp{2 18}.
@subsection RPC
......@@ -1935,7 +1938,7 @@ they are written as
@example
( @var{name} : @var{type} ;
@var{name} : @var{type} ;
...
@dots{}
)
@end example
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment