sphinx.addnodesdocument)}( rawsourcechildren](docutils.nodessubstitution_definition)}(h&.. |AArch32| replace:: :term:`AArch32`h]h pending_xref)}(h:term:`AArch32`h]h inline)}(hhh]h TextAArch32}(hhparenthuba attributes}(ids]classes](xrefstdstd-termenames]dupnames]backrefs]utagnamehh!hubah"}(h$]h&]h+]h-]h/]refdocprocess/commit-style refdomainh)reftypeterm refexplicitrefwarn reftargetAArch32uh1hsource lineKh!h ubah"}(h$]h&]h+]AArch32ah-]h/]uh1h hAhBhCKh!hhhubh )}(h&.. |AArch64| replace:: :term:`AArch64`h]h)}(h:term:`AArch64`h]h)}(hhQh]hAArch64}(hhh!hSubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!hOubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainh]reftypeterm refexplicitrefwarnh?AArch64uh1hhAhBhCKh!hKubah"}(h$]h&]h+]AArch64ah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |AMU| replace:: :term:`AMU`h]h)}(h :term:`AMU`h]h)}(hh|h]hAMU}(hhh!h~ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!hzubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainhreftypeterm refexplicitrefwarnh?AMUuh1hhAhBhCKh!hvubah"}(h$]h&]h+]AMUah-]h/]uh1h hAhBhCKh!hhhubh )}(h&.. |AMUs| replace:: :term:`AMUs `h]h)}(h:term:`AMUs `h]h)}(hhh]hAMUs}(hhh!hubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!hubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainhreftypeterm refexplicitrefwarnh?AMUuh1hhAhBhCKh!hubah"}(h$]h&]h+]AMUsah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |API| replace:: :term:`API`h]h)}(h :term:`API`h]h)}(hhh]hAPI}(hhh!hubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!hubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainhތreftypeterm refexplicitrefwarnh?APIuh1hhAhBhCKh!hubah"}(h$]h&]h+]APIah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |BTI| replace:: :term:`BTI`h]h)}(h :term:`BTI`h]h)}(hhh]hBTI}(hhh!hubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!hubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj reftypeterm refexplicitrefwarnh?BTIuh1hhAhBhCKh!hubah"}(h$]h&]h+]BTIah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |CoT| replace:: :term:`CoT`h]h)}(h :term:`CoT`h]h)}(hj(h]hCoT}(hhh!j*ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j&ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj4reftypeterm refexplicitrefwarnh?CoTuh1hhAhBhCKh!j"ubah"}(h$]h&]h+]CoTah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |COT| replace:: :term:`COT`h]h)}(h :term:`COT`h]h)}(hjSh]hCOT}(hhh!jUubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jQubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj_reftypeterm refexplicitrefwarnh?COTuh1hhAhBhCKh!jMubah"}(h$]h&]h+]COTah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |CSS| replace:: :term:`CSS`h]h)}(h :term:`CSS`h]h)}(hj~h]hCSS}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j|ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?CSSuh1hhAhBhCK h!jxubah"}(h$]h&]h+]CSSah-]h/]uh1h hAhBhCK h!hhhubh )}(h.. |CVE| replace:: :term:`CVE`h]h)}(h :term:`CVE`h]h)}(hjh]hCVE}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?CVEuh1hhAhBhCK h!jubah"}(h$]h&]h+]CVEah-]h/]uh1h hAhBhCK h!hhhubh )}(h.. |DTB| replace:: :term:`DTB`h]h)}(h :term:`DTB`h]h)}(hjh]hDTB}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?DTBuh1hhAhBhCK h!jubah"}(h$]h&]h+]DTBah-]h/]uh1h hAhBhCK h!hhhubh )}(h .. |DS-5| replace:: :term:`DS-5`h]h)}(h :term:`DS-5`h]h)}(hjh]hDS-5}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj reftypeterm refexplicitrefwarnh?DS-5uh1hhAhBhCK h!jubah"}(h$]h&]h+]DS-5ah-]h/]uh1h hAhBhCK h!hhhubh )}(h.. |DSU| replace:: :term:`DSU`h]h)}(h :term:`DSU`h]h)}(hj*h]hDSU}(hhh!j,ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j(ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj6reftypeterm refexplicitrefwarnh?DSUuh1hhAhBhCK h!j$ubah"}(h$]h&]h+]DSUah-]h/]uh1h hAhBhCK h!hhhubh )}(h.. |DT| replace:: :term:`DT`h]h)}(h :term:`DT`h]h)}(hjUh]hDT}(hhh!jWubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jSubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjareftypeterm refexplicitrefwarnh?DTuh1hhAhBhCKh!jOubah"}(h$]h&]h+]DTah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |EL| replace:: :term:`EL`h]h)}(h :term:`EL`h]h)}(hjh]hEL}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j~ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?ELuh1hhAhBhCKh!jzubah"}(h$]h&]h+]ELah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |EHF| replace:: :term:`EHF`h]h)}(h :term:`EHF`h]h)}(hjh]hEHF}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?EHFuh1hhAhBhCKh!jubah"}(h$]h&]h+]EHFah-]h/]uh1h hAhBhCKh!hhhubh )}(h".. |FCONF| replace:: :term:`FCONF`h]h)}(h :term:`FCONF`h]h)}(hjh]hFCONF}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?FCONFuh1hhAhBhCKh!jubah"}(h$]h&]h+]FCONFah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |FDT| replace:: :term:`FDT`h]h)}(h :term:`FDT`h]h)}(hjh]hFDT}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj reftypeterm refexplicitrefwarnh?FDTuh1hhAhBhCKh!jubah"}(h$]h&]h+]FDTah-]h/]uh1h hAhBhCKh!hhhubh )}(h .. |FF-A| replace:: :term:`FF-A`h]h)}(h :term:`FF-A`h]h)}(hj,h]hFF-A}(hhh!j.ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j*ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj8reftypeterm refexplicitrefwarnh?FF-Auh1hhAhBhCKh!j&ubah"}(h$]h&]h+]FF-Aah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |FIP| replace:: :term:`FIP`h]h)}(h :term:`FIP`h]h)}(hjWh]hFIP}(hhh!jYubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jUubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjcreftypeterm refexplicitrefwarnh?FIPuh1hhAhBhCKh!jQubah"}(h$]h&]h+]FIPah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |FVP| replace:: :term:`FVP`h]h)}(h :term:`FVP`h]h)}(hjh]hFVP}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?FVPuh1hhAhBhCKh!j|ubah"}(h$]h&]h+]FVPah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |FWU| replace:: :term:`FWU`h]h)}(h :term:`FWU`h]h)}(hjh]hFWU}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?FWUuh1hhAhBhCKh!jubah"}(h$]h&]h+]FWUah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |GIC| replace:: :term:`GIC`h]h)}(h :term:`GIC`h]h)}(hjh]hGIC}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?GICuh1hhAhBhCKh!jubah"}(h$]h&]h+]GICah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |ISA| replace:: :term:`ISA`h]h)}(h :term:`ISA`h]h)}(hjh]hISA}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?ISAuh1hhAhBhCKh!jubah"}(h$]h&]h+]ISAah-]h/]uh1h hAhBhCKh!hhhubh )}(h$.. |Linaro| replace:: :term:`Linaro`h]h)}(h:term:`Linaro`h]h)}(hj.h]hLinaro}(hhh!j0ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j,ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj:reftypeterm refexplicitrefwarnh?Linarouh1hhAhBhCKh!j(ubah"}(h$]h&]h+]Linaroah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |MMU| replace:: :term:`MMU`h]h)}(h :term:`MMU`h]h)}(hjYh]hMMU}(hhh!j[ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jWubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjereftypeterm refexplicitrefwarnh?MMUuh1hhAhBhCKh!jSubah"}(h$]h&]h+]MMUah-]h/]uh1h hAhBhCKh!hhhubh )}(h .. |MPAM| replace:: :term:`MPAM`h]h)}(h :term:`MPAM`h]h)}(hjh]hMPAM}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?MPAMuh1hhAhBhCKh!j~ubah"}(h$]h&]h+]MPAMah-]h/]uh1h hAhBhCKh!hhhubh )}(h .. |MPMM| replace:: :term:`MPMM`h]h)}(h :term:`MPMM`h]h)}(hjh]hMPMM}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?MPMMuh1hhAhBhCKh!jubah"}(h$]h&]h+]MPMMah-]h/]uh1h hAhBhCKh!hhhubh )}(h".. |MPIDR| replace:: :term:`MPIDR`h]h)}(h :term:`MPIDR`h]h)}(hjh]hMPIDR}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?MPIDRuh1hhAhBhCKh!jubah"}(h$]h&]h+]MPIDRah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |MTE| replace:: :term:`MTE`h]h)}(h :term:`MTE`h]h)}(hjh]hMTE}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?MTEuh1hhAhBhCKh!jubah"}(h$]h&]h+]MTEah-]h/]uh1h hAhBhCKh!hhhubh )}(h.. |OEN| replace:: :term:`OEN`h]h)}(h :term:`OEN`h]h)}(hj0h]hOEN}(hhh!j2ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j.ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj<reftypeterm refexplicitrefwarnh?OENuh1hhAhBhCKh!j*ubah"}(h$]h&]h+]OENah-]h/]uh1h hAhBhCKh!hhhubh )}(h$.. |OP-TEE| replace:: :term:`OP-TEE`h]h)}(h:term:`OP-TEE`h]h)}(hj[h]hOP-TEE}(hhh!j]ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jYubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjgreftypeterm refexplicitrefwarnh?OP-TEEuh1hhAhBhCK h!jUubah"}(h$]h&]h+]OP-TEEah-]h/]uh1h hAhBhCK h!hhhubh )}(h.. |OTE| replace:: :term:`OTE`h]h)}(h :term:`OTE`h]h)}(hjh]hOTE}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?OTEuh1hhAhBhCK!h!jubah"}(h$]h&]h+]OTEah-]h/]uh1h hAhBhCK!h!hhhubh )}(h.. |PDD| replace:: :term:`PDD`h]h)}(h :term:`PDD`h]h)}(hjh]hPDD}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?PDDuh1hhAhBhCK"h!jubah"}(h$]h&]h+]PDDah-]h/]uh1h hAhBhCK"h!hhhubh )}(h".. |PAUTH| replace:: :term:`PAUTH`h]h)}(h :term:`PAUTH`h]h)}(hjh]hPAUTH}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?PAUTHuh1hhAhBhCK#h!jubah"}(h$]h&]h+]PAUTHah-]h/]uh1h hAhBhCK#h!hhhubh )}(h.. |PMF| replace:: :term:`PMF`h]h)}(h :term:`PMF`h]h)}(hjh]hPMF}(hhh!j ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?PMFuh1hhAhBhCK$h!jubah"}(h$]h&]h+]PMFah-]h/]uh1h hAhBhCK$h!hhhubh )}(h .. |PSCI| replace:: :term:`PSCI`h]h)}(h :term:`PSCI`h]h)}(hj2h]hPSCI}(hhh!j4ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j0ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj>reftypeterm refexplicitrefwarnh?PSCIuh1hhAhBhCK%h!j,ubah"}(h$]h&]h+]PSCIah-]h/]uh1h hAhBhCK%h!hhhubh )}(h.. |RAS| replace:: :term:`RAS`h]h)}(h :term:`RAS`h]h)}(hj]h]hRAS}(hhh!j_ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j[ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjireftypeterm refexplicitrefwarnh?RASuh1hhAhBhCK&h!jWubah"}(h$]h&]h+]RASah-]h/]uh1h hAhBhCK&h!hhhubh )}(h.. |ROT| replace:: :term:`ROT`h]h)}(h :term:`ROT`h]h)}(hjh]hROT}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?ROTuh1hhAhBhCK'h!jubah"}(h$]h&]h+]ROTah-]h/]uh1h hAhBhCK'h!hhhubh )}(h .. |SCMI| replace:: :term:`SCMI`h]h)}(h :term:`SCMI`h]h)}(hjh]hSCMI}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?SCMIuh1hhAhBhCK(h!jubah"}(h$]h&]h+]SCMIah-]h/]uh1h hAhBhCK(h!hhhubh )}(h.. |SCP| replace:: :term:`SCP`h]h)}(h :term:`SCP`h]h)}(hjh]hSCP}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?SCPuh1hhAhBhCK)h!jubah"}(h$]h&]h+]SCPah-]h/]uh1h hAhBhCK)h!hhhubh )}(h .. |SDEI| replace:: :term:`SDEI`h]h)}(h :term:`SDEI`h]h)}(hj h]hSDEI}(hhh!j ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?SDEIuh1hhAhBhCK*h!jubah"}(h$]h&]h+]SDEIah-]h/]uh1h hAhBhCK*h!hhhubh )}(h.. |SDS| replace:: :term:`SDS`h]h)}(h :term:`SDS`h]h)}(hj4h]hSDS}(hhh!j6ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j2ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj@reftypeterm refexplicitrefwarnh?SDSuh1hhAhBhCK+h!j.ubah"}(h$]h&]h+]SDSah-]h/]uh1h hAhBhCK+h!hhhubh )}(h.. |SEA| replace:: :term:`SEA`h]h)}(h :term:`SEA`h]h)}(hj_h]hSEA}(hhh!jaubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j]ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjkreftypeterm refexplicitrefwarnh?SEAuh1hhAhBhCK,h!jYubah"}(h$]h&]h+]SEAah-]h/]uh1h hAhBhCK,h!hhhubh )}(h.. |SiP| replace:: :term:`SiP`h]h)}(h :term:`SiP`h]h)}(hjh]hSiP}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?SiPuh1hhAhBhCK-h!jubah"}(h$]h&]h+]SiPah-]h/]uh1h hAhBhCK-h!hhhubh )}(h.. |SIP| replace:: :term:`SIP`h]h)}(h :term:`SIP`h]h)}(hjh]hSIP}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?SIPuh1hhAhBhCK.h!jubah"}(h$]h&]h+]SIPah-]h/]uh1h hAhBhCK.h!hhhubh )}(h.. |SMC| replace:: :term:`SMC`h]h)}(h :term:`SMC`h]h)}(hjh]hSMC}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?SMCuh1hhAhBhCK/h!jubah"}(h$]h&]h+]SMCah-]h/]uh1h hAhBhCK/h!hhhubh )}(h".. |SMCCC| replace:: :term:`SMCCC`h]h)}(h :term:`SMCCC`h]h)}(hj h]hSMCCC}(hhh!j ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?SMCCCuh1hhAhBhCK0h!jubah"}(h$]h&]h+]SMCCCah-]h/]uh1h hAhBhCK0h!hhhubh )}(h.. |SoC| replace:: :term:`SoC`h]h)}(h :term:`SoC`h]h)}(hj6h]hSoC}(hhh!j8ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j4ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjBreftypeterm refexplicitrefwarnh?SoCuh1hhAhBhCK1h!j0ubah"}(h$]h&]h+]SoCah-]h/]uh1h hAhBhCK1h!hhhubh )}(h.. |SP| replace:: :term:`SP`h]h)}(h :term:`SP`h]h)}(hjah]hSP}(hhh!jcubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j_ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjmreftypeterm refexplicitrefwarnh?SPuh1hhAhBhCK2h!j[ubah"}(h$]h&]h+]SPah-]h/]uh1h hAhBhCK2h!hhhubh )}(h.. |SPD| replace:: :term:`SPD`h]h)}(h :term:`SPD`h]h)}(hjh]hSPD}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?SPDuh1hhAhBhCK3h!jubah"}(h$]h&]h+]SPDah-]h/]uh1h hAhBhCK3h!hhhubh )}(h.. |SPM| replace:: :term:`SPM`h]h)}(h :term:`SPM`h]h)}(hjh]hSPM}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?SPMuh1hhAhBhCK4h!jubah"}(h$]h&]h+]SPMah-]h/]uh1h hAhBhCK4h!hhhubh )}(h .. |SSBS| replace:: :term:`SSBS`h]h)}(h :term:`SSBS`h]h)}(hjh]hSSBS}(hhh!jubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjreftypeterm refexplicitrefwarnh?SSBSuh1hhAhBhCK5h!jubah"}(h$]h&]h+]SSBSah-]h/]uh1h hAhBhCK5h!hhhubh )}(h.. |SVE| replace:: :term:`SVE`h]h)}(h :term:`SVE`h]h)}(hj h]hSVE}(hhh!j ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj reftypeterm refexplicitrefwarnh?SVEuh1hhAhBhCK6h!j ubah"}(h$]h&]h+]SVEah-]h/]uh1h hAhBhCK6h!hhhubh )}(h.. |TBB| replace:: :term:`TBB`h]h)}(h :term:`TBB`h]h)}(hj8 h]hTBB}(hhh!j: ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j6 ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjD reftypeterm refexplicitrefwarnh?TBBuh1hhAhBhCK7h!j2 ubah"}(h$]h&]h+]TBBah-]h/]uh1h hAhBhCK7h!hhhubh )}(h .. |TBBR| replace:: :term:`TBBR`h]h)}(h :term:`TBBR`h]h)}(hjc h]hTBBR}(hhh!je ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!ja ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjo reftypeterm refexplicitrefwarnh?TBBRuh1hhAhBhCK8h!j] ubah"}(h$]h&]h+]TBBRah-]h/]uh1h hAhBhCK8h!hhhubh )}(h.. |TEE| replace:: :term:`TEE`h]h)}(h :term:`TEE`h]h)}(hj h]hTEE}(hhh!j ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj reftypeterm refexplicitrefwarnh?TEEuh1hhAhBhCK9h!j ubah"}(h$]h&]h+]TEEah-]h/]uh1h hAhBhCK9h!hhhubh )}(h .. |TF-A| replace:: :term:`TF-A`h]h)}(h :term:`TF-A`h]h)}(hj h]hTF-A}(hhh!j ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj reftypeterm refexplicitrefwarnh?TF-Auh1hhAhBhCK:h!j ubah"}(h$]h&]h+]TF-Aah-]h/]uh1h hAhBhCK:h!hhhubh )}(h .. |TF-M| replace:: :term:`TF-M`h]h)}(h :term:`TF-M`h]h)}(hj h]hTF-M}(hhh!j ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj reftypeterm refexplicitrefwarnh?TF-Muh1hhAhBhCK;h!j ubah"}(h$]h&]h+]TF-Mah-]h/]uh1h hAhBhCK;h!hhhubh )}(h.. |TLB| replace:: :term:`TLB`h]h)}(h :term:`TLB`h]h)}(hj h]hTLB}(hhh!j ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj reftypeterm refexplicitrefwarnh?TLBuh1hhAhBhCKh!j_ ubah"}(h$]h&]h+]TRNGah-]h/]uh1h hAhBhCK>h!hhhubh )}(h.. |TSP| replace:: :term:`TSP`h]h)}(h :term:`TSP`h]h)}(hj h]hTSP}(hhh!j ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj reftypeterm refexplicitrefwarnh?TSPuh1hhAhBhCK?h!j ubah"}(h$]h&]h+]TSPah-]h/]uh1h hAhBhCK?h!hhhubh )}(h.. |TZC| replace:: :term:`TZC`h]h)}(h :term:`TZC`h]h)}(hj h]hTZC}(hhh!j ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj reftypeterm refexplicitrefwarnh?TZCuh1hhAhBhCK@h!j ubah"}(h$]h&]h+]TZCah-]h/]uh1h hAhBhCK@h!hhhubh )}(h".. |UBSAN| replace:: :term:`UBSAN`h]h)}(h :term:`UBSAN`h]h)}(hj h]hUBSAN}(hhh!j ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj reftypeterm refexplicitrefwarnh?UBSANuh1hhAhBhCKAh!j ubah"}(h$]h&]h+]UBSANah-]h/]uh1h hAhBhCKAh!hhhubh )}(h .. |UEFI| replace:: :term:`UEFI`h]h)}(h :term:`UEFI`h]h)}(hj h]hUEFI}(hhh!j ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj reftypeterm refexplicitrefwarnh?UEFIuh1hhAhBhCKBh!j ubah"}(h$]h&]h+]UEFIah-]h/]uh1h hAhBhCKBh!hhhubh )}(h .. |WDOG| replace:: :term:`WDOG`h]h)}(h :term:`WDOG`h]h)}(hj< h]hWDOG}(hhh!j> ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!j: ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjH reftypeterm refexplicitrefwarnh?WDOGuh1hhAhBhCKCh!j6 ubah"}(h$]h&]h+]WDOGah-]h/]uh1h hAhBhCKCh!hhhubh )}(h!.. |XLAT| replace:: :term:`XLAT` h]h)}(h :term:`XLAT`h]h)}(hjg h]hXLAT}(hhh!ji ubah"}(h$]h&](h(stdstd-termeh+]h-]h/]uh1hh!je ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjs reftypeterm refexplicitrefwarnh?XLATuh1hhAhBhCKDh!ja ubah"}(h$]h&]h+]XLATah-]h/]uh1h hAhBhCKDh!hhhubh section)}(hhh](h title)}(h Commit Styleh]h Commit Style}(hj h!j hhhANhCNubah"}(h$]h&]h+]h-]h/]uh1j h!j hhhAU/home/test/workspace/code/optee_3.16/trusted-firmware-a/docs/process/commit-style.rsthCKubh paragraph)}(hX{When writing commit messages, please think carefully about the purpose and scope of the change you are making: describe briefly what the change does, and describe in detail why it does it. This helps to ensure that changes to the code-base are transparent and approachable to reviewers, and it allows us to keep a more accurate changelog. You may use Markdown in commit messages.h]hX{When writing commit messages, please think carefully about the purpose and scope of the change you are making: describe briefly what the change does, and describe in detail why it does it. This helps to ensure that changes to the code-base are transparent and approachable to reviewers, and it allows us to keep a more accurate changelog. You may use Markdown in commit messages.}(hj h!j hhhANhCNubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!j hhubj )}(hA good commit message provides all the background information needed for reviewers to understand the intent and rationale of the patch. This information is also useful for future reference.h]hA good commit message provides all the background information needed for reviewers to understand the intent and rationale of the patch. This information is also useful for future reference.}(hj h!j hhhANhCNubah"}(h$]h&]h+]h-]h/]uh1j hAj hCK h!j hhubj )}(h For example:h]h For example:}(hj h!j hhhANhCNubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!j hhubh bullet_list)}(hhh](h list_item)}(hWhat does the patch do?h]j )}(hj h]hWhat does the patch do?}(hj h!j ubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!j ubah"}(h$]h&]h+]h-]h/]uh1j h!j hhhAj hCNubj )}(hWhat motivated it?h]j )}(hj h]hWhat motivated it?}(hj h!j ubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!j ubah"}(h$]h&]h+]h-]h/]uh1j h!j hhhAj hCNubj )}(hWhat impact does it have?h]j )}(hj h]hWhat impact does it have?}(hj h!j ubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!j ubah"}(h$]h&]h+]h-]h/]uh1j h!j hhhAj hCNubj )}(hHow was it tested?h]j )}(hj h]hHow was it tested?}(hj h!j ubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!j ubah"}(h$]h&]h+]h-]h/]uh1j h!j hhhAj hCNubj )}(hUHave alternatives been considered? Why did you choose this approach over another one?h]j )}(hUHave alternatives been considered? Why did you choose this approach over another one?h]hUHave alternatives been considered? Why did you choose this approach over another one?}(hj7 h!j5 ubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!j1 ubah"}(h$]h&]h+]h-]h/]uh1j h!j hhhAj hCNubj )}(h.If it fixes an `issue`_, include a reference. h]j )}(h-If it fixes an `issue`_, include a reference.h](hIf it fixes an }(hIf it fixes an h!jM ubh reference)}(h`issue`_h]hissue}(hissueh!jX ubah"}(h$]h&]h+]h-]h/]namej` refuri6https://developer.trustedfirmware.org/project/board/1/uh1jV h!jM resolvedKubh, include a reference.}(h, include a reference.h!jM ubeh"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!jI ubah"}(h$]h&]h+]h-]h/]uh1j h!j hhhAj hCNubeh"}(h$]h&]h+]h-]h/]bullet-uh1j hAj hCKh!j hhubj )}(h|TF-A| follows the `Conventional Commits`_ specification. All commits to the main repository are expected to adhere to these guidelines, so it is **strongly** recommended that you read at least the `quick summary`_ of the specification.h](h)}(hj h]h)}(hj h]hTF-A}(hhh!j ubah"}(h$]h&](h(j j eh+]h-]h/]uh1hhANhCNh!j ubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj reftypej refexplicitrefwarn reftargetj uh1hhAhBhCK:h!j hhubh follows the }(h follows the h!j hhhANhCNubjW )}(h`Conventional Commits`_h]hConventional Commits}(hConventional Commitsh!j ubah"}(h$]h&]h+]h-]h/]nameConventional Commitsjh -https://www.conventionalcommits.org/en/v1.0.0uh1jV h!j jj Kubhh specification. All commits to the main repository are expected to adhere to these guidelines, so it is }(hh specification. All commits to the main repository are expected to adhere to these guidelines, so it is h!j hhhANhCNubh strong)}(h **strongly**h]hstrongly}(hhh!j ubah"}(h$]h&]h+]h-]h/]uh1j h!j ubh( recommended that you read at least the }(h( recommended that you read at least the h!j hhhANhCNubjW )}(h`quick summary`_h]h quick summary}(h quick summaryh!j ubah"}(h$]h&]h+]h-]h/]name quick summaryjh 6https://www.conventionalcommits.org/en/v1.0.0/#summaryuh1jV h!j jj Kubh of the specification.}(h of the specification.h!j hhhANhCNubeh"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!j hhubj )}(hETo briefly summarize, commit messages are expected to be of the form:h]hETo briefly summarize, commit messages are expected to be of the form:}(hj h!j hhhANhCNubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!j hhubh literal_block)}(hL[optional scope]: [optional body] [optional footer(s)]h]hL[optional scope]: [optional body] [optional footer(s)]}(hhh!j ubah"}(h$]h&]h+]h-]h/]forcehighlight_args} xml:spacepreservelanguagedefaultuh1j hAj hCKh!j hhubj )}(hiThe following example commit message demonstrates the use of the ``refactor`` type and the ``amu`` scope:h](hAThe following example commit message demonstrates the use of the }(hAThe following example commit message demonstrates the use of the h!j hhhANhCNubh literal)}(h ``refactor``h]hrefactor}(hhh!j" ubah"}(h$]h&]h+]h-]h/]uh1j h!j ubh type and the }(h type and the h!j hhhANhCNubj! )}(h``amu``h]hamu}(hhh!j5 ubah"}(h$]h&]h+]h-]h/]uh1j h!j ubh scope:}(h scope:h!j hhhANhCNubeh"}(h$]h&]h+]h-]h/]uh1j hAj hCK'h!j hhubj )}(hXrefactor(amu): factor out register accesses This change introduces a small set of register getters and setters to avoid having to repeatedly mask and shift in complex code. Change-Id: Ia372f60c5efb924cd6eeceb75112e635ad13d942 Signed-off-by: Chris Kay h]hXrefactor(amu): factor out register accesses This change introduces a small set of register getters and setters to avoid having to repeatedly mask and shift in complex code. Change-Id: Ia372f60c5efb924cd6eeceb75112e635ad13d942 Signed-off-by: Chris Kay }(hhh!jN ubah"}(h$]h&]h+]h-]h/]forcehighlight_args}j j j j uh1j hAj hCK*h!j hhubj )}(h@The following `types` are permissible and are strictly enforced:h](hThe following }(hThe following h!j_ hhhANhCNubh title_reference)}(h`types`h]htypes}(hhh!jj ubah"}(h$]h&]h+]h-]h/]uh1jh h!j_ ubh+ are permissible and are strictly enforced:}(h+ are permissible and are strictly enforced:h!j_ hhhANhCNubeh"}(h$]h&]h+]h-]h/]uh1j hAj hCK4h!j hhubh table)}(hhh]h tgroup)}(hhh](h colspec)}(hhh]h"}(h$]h&]h+]h-]h/]colwidthKuh1j h!j ubj )}(hhh]h"}(h$]h&]h+]h-]h/]colwidthK?uh1j h!j ubh thead)}(hhh]h row)}(hhh](h entry)}(hhh]j )}(hScopeh]hScope}(hj h!j ubah"}(h$]h&]h+]h-]h/]uh1j hAj hCK7h!j ubah"}(h$]h&]h+]h-]h/]uh1j h!j ubj )}(hhh]j )}(h Descriptionh]h Description}(hj h!j ubah"}(h$]h&]h+]h-]h/]uh1j hAj hCK7h!j ubah"}(h$]h&]h+]h-]h/]uh1j h!j ubeh"}(h$]h&]h+]h-]h/]uh1j h!j ubah"}(h$]h&]h+]h-]h/]uh1j h!j ubh tbody)}(hhh](j )}(hhh](j )}(hhh]j )}(h``feat``h]j! )}(hj h]hfeat}(hhh!j ubah"}(h$]h&]h+]h-]h/]uh1j h!j ubah"}(h$]h&]h+]h-]h/]uh1j hAj hCK9h!j ubah"}(h$]h&]h+]h-]h/]uh1j h!j ubj )}(hhh]j )}(h A new featureh]h A new feature}(hjh!jubah"}(h$]h&]h+]h-]h/]uh1j hAj hCK9h!jubah"}(h$]h&]h+]h-]h/]uh1j h!j ubeh"}(h$]h&]h+]h-]h/]uh1j h!j ubj )}(hhh](j )}(hhh]j )}(h``fix``h]j! )}(hj6h]hfix}(hhh!j8ubah"}(h$]h&]h+]h-]h/]uh1j h!j4ubah"}(h$]h&]h+]h-]h/]uh1j hAj hCK;h!j1ubah"}(h$]h&]h+]h-]h/]uh1j h!j.ubj )}(hhh]j )}(h A bug fixh]h A bug fix}(hjVh!jTubah"}(h$]h&]h+]h-]h/]uh1j hAj hCK;h!jQubah"}(h$]h&]h+]h-]h/]uh1j h!j.ubeh"}(h$]h&]h+]h-]h/]uh1j h!j ubj )}(hhh](j )}(hhh]j )}(h ``build``h]j! )}(hjvh]hbuild}(hhh!jxubah"}(h$]h&]h+]h-]h/]uh1j h!jtubah"}(h$]h&]h+]h-]h/]uh1j hAj hCK=h!jqubah"}(h$]h&]h+]h-]h/]uh1j h!jnubj )}(hhh]j )}(h=Changes that affect the build system or external dependenciesh]h=Changes that affect the build system or external dependencies}(hjh!jubah"}(h$]h&]h+]h-]h/]uh1j hAj hCK=h!jubah"}(h$]h&]h+]h-]h/]uh1j h!jnubeh"}(h$]h&]h+]h-]h/]uh1j h!j ubj )}(hhh](j )}(hhh]j )}(h``ci``h]j! )}(hjh]hci}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubah"}(h$]h&]h+]h-]h/]uh1j hAj hCK?h!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubj )}(hhh]j )}(h1Changes to our CI configuration files and scriptsh]h1Changes to our CI configuration files and scripts}(hjh!jubah"}(h$]h&]h+]h-]h/]uh1j hAj hCK?h!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubeh"}(h$]h&]h+]h-]h/]uh1j h!j ubj )}(hhh](j )}(hhh]j )}(h``docs``h]j! )}(hjh]hdocs}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKAh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubj )}(hhh]j )}(hDocumentation-only changesh]hDocumentation-only changes}(hjh!jubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKAh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubeh"}(h$]h&]h+]h-]h/]uh1j h!j ubj )}(hhh](j )}(hhh]j )}(h``perf``h]j! )}(hj6h]hperf}(hhh!j8ubah"}(h$]h&]h+]h-]h/]uh1j h!j4ubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKCh!j1ubah"}(h$]h&]h+]h-]h/]uh1j h!j.ubj )}(hhh]j )}(h'A code change that improves performanceh]h'A code change that improves performance}(hjVh!jTubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKCh!jQubah"}(h$]h&]h+]h-]h/]uh1j h!j.ubeh"}(h$]h&]h+]h-]h/]uh1j h!j ubj )}(hhh](j )}(hhh]j )}(h ``refactor``h]j! )}(hjvh]hrefactor}(hhh!jxubah"}(h$]h&]h+]h-]h/]uh1j h!jtubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKEh!jqubah"}(h$]h&]h+]h-]h/]uh1j h!jnubj )}(hhh]j )}(h9A code change that neither fixes a bug nor adds a featureh]h9A code change that neither fixes a bug nor adds a feature}(hjh!jubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKEh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jnubeh"}(h$]h&]h+]h-]h/]uh1j h!j ubj )}(hhh](j )}(hhh]j )}(h ``revert``h]j! )}(hjh]hrevert}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKGh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubj )}(hhh]j )}(h%Changes that revert a previous changeh]h%Changes that revert a previous change}(hjh!jubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKGh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubeh"}(h$]h&]h+]h-]h/]uh1j h!j ubj )}(hhh](j )}(hhh]j )}(h ``style``h]j! )}(hjh]hstyle}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKIh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubj )}(hhh]j )}(hgChanges that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc.)h]hgChanges that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc.)}(hjh!jubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKIh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubeh"}(h$]h&]h+]h-]h/]uh1j h!j ubj )}(hhh](j )}(hhh]j )}(h``test``h]j! )}(hj6h]htest}(hhh!j8ubah"}(h$]h&]h+]h-]h/]uh1j h!j4ubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKLh!j1ubah"}(h$]h&]h+]h-]h/]uh1j h!j.ubj )}(hhh]j )}(h1Adding missing tests or correcting existing testsh]h1Adding missing tests or correcting existing tests}(hjVh!jTubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKLh!jQubah"}(h$]h&]h+]h-]h/]uh1j h!j.ubeh"}(h$]h&]h+]h-]h/]uh1j h!j ubj )}(hhh](j )}(hhh]j )}(h ``chore``h]j! )}(hjvh]hchore}(hhh!jxubah"}(h$]h&]h+]h-]h/]uh1j h!jtubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKNh!jqubah"}(h$]h&]h+]h-]h/]uh1j h!jnubj )}(hhh]j )}(hAny other changeh]hAny other change}(hjh!jubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKNh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jnubeh"}(h$]h&]h+]h-]h/]uh1j h!j ubeh"}(h$]h&]h+]h-]h/]uh1j h!j ubeh"}(h$]h&]h+]h-]h/]colsKuh1j h!j ubah"}(h$]h&]h+]h-]h/]uh1j h!j hhhAj hCNubj )}(hXThe permissible `scopes` are more flexible, and we maintain a list of them in our :download:`Commitizen configuration file <../../.cz.json>`. Scopes in this file are organized by their changelog section, each of which may have one or more accepted scopes, but only the first of which is considered to be "blessed". Scopes that are not blessed exist for changes submitted before scope enforcement came into effect, and are considered deprecated.h](hThe permissible }(hThe permissible h!jhhhANhCNubji )}(h`scopes`h]hscopes}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1jh h!jubh: are more flexible, and we maintain a list of them in our }(h: are more flexible, and we maintain a list of them in our h!jhhhANhCNubhdownload_reference)}(h::download:`Commitizen configuration file <../../.cz.json>`h]j! )}(hjh]hCommitizen configuration file}(hhh!jubah"}(h$]h&](h(downloadeh+]h-]h/]uh1j h!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainhreftypej refexplicitrefwarnh?../../.cz.jsonfilename)43577562904b41946dee11582a0628da/.cz.jsonuh1jhAj hCKQh!jubhX4. Scopes in this file are organized by their changelog section, each of which may have one or more accepted scopes, but only the first of which is considered to be “blessed”. Scopes that are not blessed exist for changes submitted before scope enforcement came into effect, and are considered deprecated.}(hX0. Scopes in this file are organized by their changelog section, each of which may have one or more accepted scopes, but only the first of which is considered to be "blessed". Scopes that are not blessed exist for changes submitted before scope enforcement came into effect, and are considered deprecated.h!jhhhANhCNubeh"}(h$]h&]h+]h-]h/]uh1j hAj hCKQh!j hhubj )}(hWhile we don't enforce scopes strictly, we do ask that commits use these if they can, or add their own if no appropriate one exists (see :ref:`Adding Scopes`).h](hWhile we don’t enforce scopes strictly, we do ask that commits use these if they can, or add their own if no appropriate one exists (see }(hWhile we don't enforce scopes strictly, we do ask that commits use these if they can, or add their own if no appropriate one exists (see h!j hhhANhCNubh)}(h:ref:`Adding Scopes`h]h)}(hjh]h Adding Scopes}(hhh!jubah"}(h$]h&](h(stdstd-refeh+]h-]h/]uh1hh!jubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainj!reftyperef refexplicitrefwarnh? adding scopesuh1hhAj hCKXh!j ubh).}(h).h!j hhhANhCNubeh"}(h$]h&]h+]h-]h/]uh1j hAj hCKXh!j hhubj )}(hIt's highly recommended that you use the tooling installed by the optional steps in the :ref:`prerequisites ` guide to validate commit messages locally, as commitlint reports a live list of the acceptable scopes.h](hZIt’s highly recommended that you use the tooling installed by the optional steps in the }(hXIt's highly recommended that you use the tooling installed by the optional steps in the h!j>hhhANhCNubh)}(h$:ref:`prerequisites `h]h)}(hjIh]h prerequisites}(hhh!jKubah"}(h$]h&](h(stdstd-refeh+]h-]h/]uh1hh!jGubah"}(h$]h&]h+]h-]h/]refdoch9 refdomainjUreftyperef refexplicitrefwarnh? prerequisitesuh1hhAj hCK[h!j>ubhg guide to validate commit messages locally, as commitlint reports a live list of the acceptable scopes.}(hg guide to validate commit messages locally, as commitlint reports a live list of the acceptable scopes.h!j>hhhANhCNubeh"}(h$]h&]h+]h-]h/]uh1j hAj hCK[h!j hhubh target)}(h.. _Adding Scopes:h]h"}(h$]h&]h+]h-]h/]refid adding-scopesuh1jrhCKh!j hhhAj ubj )}(hhh](j )}(h Adding Scopesh]h Adding Scopes}(hjh!jhhhANhCNubah"}(h$]h&]h+]h-]h/]uh1j h!jhhhAj hCKbubj )}(hScopes that are either a) unblessed in the configuration file, or b) do not exist in the configuration file at all are considered to be deprecated. If you are adding a new component that does not yet have a designated scope, please feel free to add one.h]hScopes that are either a) unblessed in the configuration file, or b) do not exist in the configuration file at all are considered to be deprecated. If you are adding a new component that does not yet have a designated scope, please feel free to add one.}(hjh!jhhhANhCNubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKdh!jhhubj )}(hFor example, if you are adding or making modifications to `Foo`'s latest and greatest new platform `Bar`, you would add it to the `Platforms` changelog section, and the hierarchy should look something like this:h](h:For example, if you are adding or making modifications to }(h:For example, if you are adding or making modifications to h!jhhhANhCNubji )}(h`Foo`h]hFoo}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1jh h!jubh&’s latest and greatest new platform }(h$'s latest and greatest new platform h!jhhhANhCNubji )}(h`Bar`h]hBar}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1jh h!jubh, you would add it to the }(h, you would add it to the h!jhhhANhCNubji )}(h `Platforms`h]h Platforms}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1jh h!jubhF changelog section, and the hierarchy should look something like this:}(hF changelog section, and the hierarchy should look something like this:h!jhhhANhCNubeh"}(h$]h&]h+]h-]h/]uh1j hAj hCKih!jhhubj )}(hX{ "sections": [ { "title": "Platforms", "sections": [ { "title": "Foo", "scopes": ["foo"], "sections": [ { "title": "Bar", "scopes": ["bar"] } ] } ] } ] }h]hX{ "sections": [ { "title": "Platforms", "sections": [ { "title": "Foo", "scopes": ["foo"], "sections": [ { "title": "Bar", "scopes": ["bar"] } ] } ] } ] }}(hhh!jubah"}(h$]h&]h+]h-]h/]forcehighlight_args}j j j jsonuh1j hAj hCKmh!jhhubj )}(hXtWhen creating new scopes, try to keep them short and succinct, and use kebab case (``this-is-kebab-case``). Components with a product name (i.e. most platforms and some drivers) should use that name (e.g. ``gic600ae``, ``flexspi``, ``stpmic1``), otherwise use a name that uniquely represents the component (e.g. ``marvell-comphy-3700``, ``rcar3-drivers``, ``a3720-uart``).h](hSWhen creating new scopes, try to keep them short and succinct, and use kebab case (}(hSWhen creating new scopes, try to keep them short and succinct, and use kebab case (h!jhhhANhCNubj! )}(h``this-is-kebab-case``h]hthis-is-kebab-case}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubhd). Components with a product name (i.e. most platforms and some drivers) should use that name (e.g. }(hd). Components with a product name (i.e. most platforms and some drivers) should use that name (e.g. h!jhhhANhCNubj! )}(h ``gic600ae``h]hgic600ae}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubh, }(h, h!jhhhANhCNubj! )}(h ``flexspi``h]hflexspi}(hhh!j(ubah"}(h$]h&]h+]h-]h/]uh1j h!jubh, }(h, h!jhhhANhCNubj! )}(h ``stpmic1``h]hstpmic1}(hhh!j;ubah"}(h$]h&]h+]h-]h/]uh1j h!jubhE), otherwise use a name that uniquely represents the component (e.g. }(hE), otherwise use a name that uniquely represents the component (e.g. h!jhhhANhCNubj! )}(h``marvell-comphy-3700``h]hmarvell-comphy-3700}(hhh!jNubah"}(h$]h&]h+]h-]h/]uh1j h!jubh, }(h, h!jubj! )}(h``rcar3-drivers``h]h rcar3-drivers}(hhh!jaubah"}(h$]h&]h+]h-]h/]uh1j h!jubh, }(hj:h!jubj! )}(h``a3720-uart``h]h a3720-uart}(hhh!jsubah"}(h$]h&]h+]h-]h/]uh1j h!jubh).}(h).h!jhhhANhCNubeh"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!jhhubeh"}(h$](jid1eh&]h+] adding scopesah-] adding scopesah/]uh1j h!j hhhAj hCKb referencedKexpect_referenced_by_name}jjtsexpect_referenced_by_id}jjtsubj )}(hhh](j )}(hMandated Trailersh]hMandated Trailers}(hjh!jhhhANhCNubah"}(h$]h&]h+]h-]h/]uh1j h!jhhhAj hCKubj )}(hCommits are expected to be signed off with the ``Signed-off-by:`` trailer using your real name and email address. You can do this automatically by committing with Git's ``-s`` flag.h](h/Commits are expected to be signed off with the }(h/Commits are expected to be signed off with the h!jhhhANhCNubj! )}(h``Signed-off-by:``h]hSigned-off-by:}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubhj trailer using your real name and email address. You can do this automatically by committing with Git’s }(hh trailer using your real name and email address. You can do this automatically by committing with Git's h!jhhhANhCNubj! )}(h``-s``h]h-s}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubh flag.}(h flag.h!jhhhANhCNubeh"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!jhhubj )}(hThere may be multiple ``Signed-off-by:`` lines depending on the history of the patch, but one **must** be the committer. More details may be found in the `Gerrit Signed-off-by Lines guidelines`_.h](hThere may be multiple }(hThere may be multiple h!jhhhANhCNubj! )}(h``Signed-off-by:``h]hSigned-off-by:}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubh6 lines depending on the history of the patch, but one }(h6 lines depending on the history of the patch, but one h!jhhhANhCNubj )}(h**must**h]hmust}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubh4 be the committer. More details may be found in the }(h4 be the committer. More details may be found in the h!jhhhANhCNubjW )}(h(`Gerrit Signed-off-by Lines guidelines`_h]h%Gerrit Signed-off-by Lines guidelines}(h%Gerrit Signed-off-by Lines guidelinesh!jubah"}(h$]h&]h+]h-]h/]name%Gerrit Signed-off-by Lines guidelinesjh Fhttps://review.trustedfirmware.org/Documentation/user-signedoffby.htmluh1jV h!jjj Kubh.}(h.h!jhhhANhCNubeh"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!jhhubj )}(hXEnsure that each commit also has a unique ``Change-Id:`` line. If you have followed optional steps in the prerequisites to either install the Node.js tools or clone the repository using the "`Clone with commit-msg hook`" clone method, then this should be done automatically for you.h](h*Ensure that each commit also has a unique }(h*Ensure that each commit also has a unique h!j,hhhANhCNubj! )}(h``Change-Id:``h]h Change-Id:}(hhh!j5ubah"}(h$]h&]h+]h-]h/]uh1j h!j,ubh line. If you have followed optional steps in the prerequisites to either install the Node.js tools or clone the repository using the “}(h line. If you have followed optional steps in the prerequisites to either install the Node.js tools or clone the repository using the "h!j,hhhANhCNubji )}(h`Clone with commit-msg hook`h]hClone with commit-msg hook}(hhh!jHubah"}(h$]h&]h+]h-]h/]uh1jh h!j,ubhA” clone method, then this should be done automatically for you.}(h?" clone method, then this should be done automatically for you.h!j,hhhANhCNubeh"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!jhhubj )}(hDMore details may be found in the `Gerrit Change-Ids documentation`_.h](h!More details may be found in the }(h!More details may be found in the h!jahhhANhCNubjW )}(h"`Gerrit Change-Ids documentation`_h]hGerrit Change-Ids documentation}(hGerrit Change-Ids documentationh!jjubah"}(h$]h&]h+]h-]h/]nameGerrit Change-Ids documentationjh Chttps://review.trustedfirmware.org/Documentation/user-changeid.htmluh1jV h!jajj Kubh.}(hj%h!jahhhANhCNubeh"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!jhhubh transition)}(h--------------h]h"}(h$]h&]h+]h-]h/]uh1jhAj hCKh!jhhubj )}(hH*Copyright (c) 2021, Arm Limited and Contributors. All rights reserved.*h]h emphasis)}(hjh]hFCopyright (c) 2021, Arm Limited and Contributors. All rights reserved.}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1jh!jubah"}(h$]h&]h+]h-]h/]uh1j hAj hCKh!jhhubjs)}(hG.. _Conventional Commits: https://www.conventionalcommits.org/en/v1.0.0h]h"}(h$]conventional-commitsah&]h+]conventional commitsah-]h/]jh j uh1jrhCKh!jhhhAj jKubjs)}(hh.. _Gerrit Change-Ids documentation: https://review.trustedfirmware.org/Documentation/user-changeid.htmlh]h"}(h$]gerrit-change-ids-documentationah&]h+]gerrit change-ids documentationah-]h/]jh j{uh1jrhCKh!jhhhAj jKubjs)}(hq.. _Gerrit Signed-off-by Lines guidelines: https://review.trustedfirmware.org/Documentation/user-signedoffby.htmlh]h"}(h$]%gerrit-signed-off-by-lines-guidelinesah&]h+]%gerrit signed-off-by lines guidelinesah-]h/]jh j uh1jrhCKh!jhhhAj jKubjs)}(hA.. _issue: https://developer.trustedfirmware.org/project/board/1/h]h"}(h$]issueah&]h+]issueah-]h/]jh ji uh1jrhCKh!jhhhAj jKubjs)}(hI.. _quick summary: https://www.conventionalcommits.org/en/v1.0.0/#summaryh]h"}(h$] quick-summaryah&]h+] quick summaryah-]h/]jh j uh1jrhCKh!jhhhAj jKubeh"}(h$]mandated-trailersah&]h+]mandated trailersah-]h/]uh1j h!j hhhAj hCKubeh"}(h$] commit-styleah&]h+] commit styleah-]h/]uh1j h!hhhhAj hCKubeh"}(h$]h&]h+]h-]h/]sourcej uh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(j N generatorN datestampN source_linkN source_urlN toc_backlinksj footnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcej _destinationN _config_files]pep_referencesN pep_base_url https://www.python.org/dev/peps/pep_file_url_templatepep-%04drfc_referencesN rfc_base_urlhttps://tools.ietf.org/html/ tab_widthKtrim_footnote_reference_spacefile_insertion_enabled raw_enabledKsyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xformembed_stylesheetcloak_email_addressesenvNubreporterNindirect_targets]substitution_defs}(hHh hshKhhvhhhhjhjJj"jujMjjxjjjjj!jjLj$jwjOjjzjjjjj#jjNj&jyjQjj|jjjjj%jjPj(j{jSjj~jjjjj'jjRj*j}jUjjjjjjj)jjTj,jjWjjjjjjj+jjVj.jjYjjjjjjj-jjXj0jj[jjjjj jj/ j jZ j2 j j] j j j j j j j1 j j\ j4 j j_ j j j j j j j3 j j^ j6 j ja usubstitution_names}(aarch32hHaarch64hsamuhamushɌapihbtijcotjucssjcvejdtbjds-5j!dsujLdtjweljehfjfconfjfdtj#ff-ajNfipjyfvpjfwujgicjisaj%linarojPmmuj{mpamjmpmmjmpidrjmtej'oenjRop-teej}otejpddjpauthjpmfj)pscijTrasjrotjscmijscpjsdeij+sdsjVseajsipjsmcjsmcccj-socjXspjspdjspmjssbsj svej/ tbbjZ tbbrj teej tf-aj tf-mj tlbj1 tlkj\ trngj tspj tzcj ubsanj uefij3 wdogj^ xlatj urefnames}(issue]jX aconventional commits]j a quick summary]j a%gerrit signed-off-by lines guidelines]jagerrit change-ids documentation]jjaurefids}j]jtasnameids}(jjjjjjjjjjjjjjjju nametypes}(jNjjNjjjjjuh$}(jj jjjjjjjjjjjjjjjju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}j'KsRparse_messages]h system_message)}(hhh]j )}(h0Duplicate implicit target name: "adding scopes".h]h4Duplicate implicit target name: “adding scopes”.}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubah"}(h$]h&]h+]h-]h/]jalevelKtypeINFOsourcej lineKbuh1jh!jhhhAj hCKbubatransform_messages]j)}(hhh]j )}(hhh]h3Hyperlink target "adding-scopes" is not referenced.}(hhh!jubah"}(h$]h&]h+]h-]h/]uh1j h!jubah"}(h$]h&]h+]h-]h/]levelKtypejsourcej lineKuh1juba transformerN decorationNhhub.