Assemblies: Effectivity attributes on module and structure?

[Thomas Schraitle <tom_schr@web.de>]

Hi,

Since DocBook 5.1, we can write topic oriented documentation with assemblies.
We use it for some time now in our Smart Docs approach at
https://github.com/SUSE/doc-modular and it works for us.

I'm wondering now about those "effectivity attributes"[1] like os, arch, etc.
in a <structure> or <module>.

For example, consider the following <module>:

  <module resourceref="..." os="linux"/>

If I call the assemble.xsl stylesheet on my assembly file, the "os" attribute
is NOT carried over into the result structure. Was this on purpose or is it a bug?

I assumed, the effectivity attributes on <module> and <structure> can be used
to _overwrite_ attributes from the referenced resource. Is my assumption
correct? If this is not the case, why allow them at all in the schema? :)

We had a similar issue[2] with xml:lang, although this might be a special case.

So how are the effectivity attributes suppose to work in an assembly file when
they are not included in the result?

Many thanks!


----- Reference
[1] https://tdg.docbook.org/tdg/5.2/ref-elements#common.effectivity.attributes
[2] GH docbook/xslt10-stylesheets#254

--
GruÃ/Regards
  Thomas Schraitle