Document Relaton for ETSI

[ronaldtse]

relaton/relaton#137 (comment)

From @petervwyatt:

Yes - it is not documented at https://www.relaton.org/guides/ :-)

[petervwyatt]

The relaton-etsi repo does not provide advice on the format of the reference I need to use in MN...
Is it something like this? [[[ETSI_319_122_1,ETSI EN 319 122-1 V1.1.1 (2016-04)]]]

[ronaldtse]

You can test the syntax locally with relaton fetch:

$ bundle exec relaton fetch "ETSI EN 319 122-1"
<bibdata schema-version="v1.2.9">
  <fetched>2025-05-28</fetched>
  <title format="text/plain" language="en" script="Latn">Electronic Signatures and Infrastructures (ESI); CAdES digital signatures; Part 1: Building blocks and CAdES baseline signatures</title>
  <uri type="src">http://webapp.etsi.org/workprogram/Report_WorkItem.asp?WKI_ID=64294</uri>
  <uri type="pdf">http://www.etsi.org/deliver/etsi_en/319100_319199/31912201/01.03.01_60/en_31912201v010301p.pdf</uri>
  <docidentifier type="ETSI" primary="true">ETSI EN 319 122-1 V1.3.1 (2023-06)</docidentifier>
  <docnumber>ETSI EN 319 122-1 V1.3.1 (2023-06)</docnumber>
  <date type="published">
    <on>2023-06</on>
  </date>
  <contributor>
    <role type="publisher"/>
    <organization>
      <name language="en" script="Latn">European Telecommunications Standards Institute</name>
      <abbreviation>ETSI</abbreviation>
    </organization>
  </contributor>
  <version>
    <draft>1.3.1</draft>
  </version>
  <language>en</language>
  <script>Latn</script>
  <abstract format="text/plain" language="en" script="Latn">Several small points:
1) if not disruptive, update the references to external standards
2) reference TS 119 511 instead of the old preservation document
3) clarify when cms-algorithm-protection attribute is usefule
4) reference TS 119 122-3 in the foreword</abstract>
  <keyword>ASN.1</keyword>
  <keyword>CAdES</keyword>
  <keyword>ELECTRONIC SIGNATURE</keyword>
  <keyword>PROFILE</keyword>
  <keyword>SECURITY</keyword>
  <ext schema-version="v0.0.3">
    <doctype abbreviation="EN">European Standard</doctype>
    <editorialgroup>
      <technical-committee>Electronic Signatures and Infrastructures</technical-committee>
    </editorialgroup>
  </ext>
</bibdata>

However it seems that we don't support the versioning yet... not sure

[ronaldtse]

This works:

$ bundle exec relaton fetch "ETSI EN 319 122-1 V1.3.1 (2023-06)"
$ bundle exec relaton fetch "ETSI EN 319 122-1"

But this doesn't:

bundle exec relaton fetch "ETSI EN 319 122-1 V1.3.1"