Bug#880210: installation-guide: validity errors when building the manual

[Karsten Merker <merker@debian.org>]

On Thu, Nov 02, 2017 at 07:35:27PM +0100, Holger Wansing wrote:
> Samuel Thibault <sthibault@debian.org> wrote:
> > Cyril Brulebois, on lun. 30 oct. 2017 16:57:39 +0100, wrote:
> > > Now we've got those as well (excerpt):
> > > | /home/d-i/trunk/manual/en/preparing/bios-setup/arm.xml:5: element sect2: validity error : ID boot-dev-select already defined
> > > |   <sect2 arch="arm64" id="boot-dev-select"><title>Boot Device Selection</title>
> > 
> > We actually already had these in some situations, I don't remember
> > exactly which.  AIUI this warning is spurious:
> > 
> > $ grep -r boot-dev-select en/
> > ./boot-installer/intro-usb.xml:<xref linkend="boot-dev-select"/> and <xref
> > ./boot-installer/intro-cd.xml:<xref linkend="boot-dev-select"/>,
> > ./using-d-i/components.xml:linkend="boot-dev-select-sun"/>.</phrase>
> > ./preparing/bios-setup/i386.xml:  <sect2 arch="any-x86" id="boot-dev-select"><title>Boot Device Selection</title>
> > ./preparing/bios-setup/sparc.xml:  <sect2 arch="sparc" id="boot-dev-select-sun">
> > ./preparing/bios-setup/arm.xml:  <sect2 arch="arm64" id="boot-dev-select"><title>Boot Device Selection</title>
> > 
> > There's really only one such id at a time.
> > 
> > Of course it'd still be nice to find out how to avoid this warning.
> 
> As can be seen in above grep output, the relevant id exists for two archs.
> The point is, that ids have to be unique for the whole manual now, not only per arch.
> (In the very beginning of the build, merge_xml merges all xml files per chapter into
> one big xml file. And in this file the ids are existing more than once now.)
> 
> I am working on a fix for that, making the ids unique like
> 
> - ./preparing/bios-setup/i386.xml:  <sect2 arch="any-x86" id="boot-dev-select"><title>Boot Device Selection</title>
> - ./preparing/bios-setup/arm.xml:  <sect2 arch="arm64" id="boot-dev-select"><title>Boot Device Selection</title>
> + ./preparing/bios-setup/i386.xml:  <sect2 arch="any-x86" id="boot-dev-select-x86"><title>Boot Device Selection</title>
> + ./preparing/bios-setup/arm.xml:  <sect2 arch="arm64" id="boot-dev-select-arm64"><title>Boot Device Selection</title>
> 
> Performing that on all relevant fixes all those warnings.
> The fix needs to unfuzzy translations as well, so please be patient :-)

Hello,

wouldn't this approach cause problems on the other end of the link relation
when an id gets referred to in platform-agnostic parts of the manual?

Regards,
Karsten
-- 
Gem. Par. 28 Abs. 4 Bundesdatenschutzgesetz widerspreche ich der Nutzung
sowie der Weitergabe meiner personenbezogenen Daten für Zwecke der
Werbung sowie der Markt- oder Meinungsforschung.