Re: Alex’s draft for today

By doing what I did, I've almost gotten rid of the need for ordinal
ports ($1, ... and @1, ...).  Many sections reference those and still
need to be adjusted.

What I didn't do was address the declaration of inputs and outputs for
block expressions.  We can discuss that another day once I've gotten
time to think about making that change along the lines of the e-mails.

My changes for today are:

1. Changed example #1 (§3) to match the other changes.

2. A new §4 about documents and ports.

3. Changes to §5 (formerly §4) to use the concept of readable ports.
Renamed "step sequences" to "chain sequences" because not everything
is a step.

4. Changes to §7 (formerly §6) to deal with appending multiple output ports.

I have tried to address the basics of formalizing matching outputs to
inputs.  The idea is that there is a set of readable ports that is
addressable within any particular context.  By default, this set is

The set of readable ports gets populated by various operations (e.g.,
a step invocation causes the output ports to populate the readable
ports for the next expression).  By doing it this way, the square
bracket expression becomes an operation on the readable ports that
changes the set in preparation for whatever comes next (e.g., a step

We just need to have a section about how a step invocation binds its
inputs from the readable ports for this all to work.  There are some
obvious rules (e.g., names match).   But, we'll want the ability for
the right thing to happen for simple filters (i.e., one input and one
output) regardless of the name.

I would be okay with rules that use order when names do not match.

On Wed, Apr 13, 2016 at 7:13 AM, Norman Walsh <> wrote:
> Hi folks,
> Alex has made some spec edits but doesn’t have the automated publishing
> machinery in place. You can find it here:
> I don’t have diffing against a status quo working yet, so we’ll have to
> walk through it with Alex’s help to understand the changes.
>                                         Be seeing you,
>                                           norm
> --
> Norman Walsh
> Lead Engineer
> MarkLogic Corporation
> Phone: +1 512 761 6676

--Alex Miłowski
"The excellence of grammar as a guide is proportional to the paucity of the
inflexions, i.e. to the degree of analysis effected by the language

Bertrand Russell in a footnote of Principles of Mathematics

Received on Wednesday, 13 April 2016 16:50:35 UTC