Re: XProc Editors Draft 2007-07-19: Section 5.1 Comments

Whew! I fixed this by largely rewriting 5.1. Please read the p:input
section of the 2 August editor's draft and let me know if you think I
got it right.

/ Jeni Tennison <jeni@jenitennison.com> was heard to say:
| Shouldn't this section also talk about <p:input>s that *aren't*
| declarations (ie are used within an atomic step)? We need to say
| somewhere that in these cases, the 'sequence', 'primary' and 'kind'
| attributes aren't allowed.

Yes.

| In 5.1.1 Document Inputs, third paragraph says:
|
|   If sequence is specified with the value “yes”, then a sequence is
|   allowed. If sequence is not specified, or has the value “no”, then it
|   is a dynamic error (err:XD0006) for a sequence of more than one
|   document to appear on the declared port.
|
| I think this should say that if sequence is not specified or has the
| value "no" then the port must be provided with exactly one document,
| or the dynamic error occurs. (At the moment it sounds as if zero
| documents would be acceptable.)

Agreed.

| Also in 5.1.1, it talks about the select expression "matching" nodes.
| But if it's a select expression then it must be *selecting* nodes. It
| would also be good to explicitly say that the elements are selected at
| every level (in other words, the <div>s that are selected in the
| example could occur within another <div>) rather than only at the top
| level (if, indeed, this is the case -- I can't remember).

Right.

| The syntax summaries imply that it's not legal to put kind="document"
| on a document input port. Is that really the case? Should it be?

I think I clarified that.

| Spelling mistake in paragraph four of 5.1.2: s/paramters/parameters

Fixed.

| In 5.1.2.1: I don't think it should be an error if the name attribute
| of c:parameter contains a colon and there's a namespace attribute
| specified: it can just override the normal namespace binding.
|
| Section 5.1.2 is very dense, and could do with an example to help
| illustrate the concepts, particularly to show the defaulting.

Also fixed.

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com> | Limited in his nature, infinite in his
http://nwalsh.com/            | desires, man is a fallen god who
                              | remembers heaven.-- Lamartine

Received on Thursday, 2 August 2007 22:17:00 UTC