xproc / 3.0-steps

Repository for change requests to the standard step library and for official extension steps
10 stars 7 forks source link

Document property preservation in the absence of an input port #325

Closed gimsieke closed 4 years ago

gimsieke commented 4 years ago

The following steps state that “no document properties are preserved” despite the fact that there is no input port:

I’d say that the concept of property preservation only applies to steps with a (primary) input port.

Apart from the parenthesized remarks in the list above that might require special wording, a proposal for a general change of the document property sentence for these steps is something like this:

The resulting document only has the content-type property. It does not have a base-uri property.

or

The resulting document has no properties apart from content-type. In particular, it has no base-uri.

ndw commented 4 years ago

That seems reasonable. I considered it briefly the other day when I was going through the steps for something else, but apparently neglected to actually do it.

gimsieke commented 4 years ago

Does anyone have a preference for one of the wording alternatives given above?

xml-project commented 4 years ago

Nope!

ndw commented 4 years ago

I think the latter wording is a little better. But shouldn't the p:directory-list step use the directory as the base-uri? I guess it doesn't really matter since (as I recall!) it will have an xml:base attribute on the document element.

gimsieke commented 4 years ago

Yes, the p:directory-list is supposed to have @xml:base on /c:directory.

I think it is convenient to stipulate that, in addition, the document will have the same directory URI as its base-uri property, instead of having no base-uri property and therefore no base URI.

Without it, base-uri(/*) will report the directory’s base URI while base-uri(/) will give an empty sequence.

ndw commented 4 years ago

Precisely!