xproc / 3.0-steps

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

Clarify that some parameters are defined for the p:archive step #562

Closed ndw closed 4 months ago

ndw commented 5 months ago

The description of parameters in p:archive is:

The parameters option can be used to supply parameters to control the archiving. The semantics of the keys and the allowed values for these keys are implementation-defined. It is a dynamic error (err:XC0079) if the map parameters contains an entry whose key is defined by the implementation and whose value is not valid for that key.

Only later, in 2.3.2 Handling of ZIP archives do we mention that for ZIP archives, some parameters are defined by this specification, if the format is ZIP.

Editorially, I think we should forshadow that in the initial description of parameters. Otherwise, it's easy to overlook. I have an existence proof for that, by the way. blush