Assemblies: Effectivity attributes on module and structure?

Thomas Schraitle <[email protected]> Sun, 29 Oct 2023 14:32:26 +0100
Newsgroups gmane.text.docbook.misc
Message-ID <[email protected]>
Hi,

Since DocBook 5.1, we can write topic oriented documentation with assembli=
es.
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, e=
tc.
in a <structure> or <module>.

For example, consider the following <module>:

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

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

I assumed, the effectivity attributes on <module> and <structure> can be u=
sed
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!


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

=2D-
Gru=C3=9F/Regards
   Thomas Schraitle