From a7f2d04d75aeef37142ab05dd33430462853c769 Mon Sep 17 00:00:00 2001 From: Terry Burton Date: Sun, 26 May 2024 23:46:16 +0100 Subject: [PATCH] API docs: Fix GS1 DL URI scheme text; mention qualifier AI check for DigSigs --- docs/gs1encoders_8h.html | 3 ++- docs/index.html | 3 ++- src/c-lib/gs1encoders.h | 4 ++-- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/gs1encoders_8h.html b/docs/gs1encoders_8h.html index 938e49d..d629f11 100644 --- a/docs/gs1encoders_8h.html +++ b/docs/gs1encoders_8h.html @@ -853,7 +853,7 @@

  • For GS1 Digital Link URIs:
    • Ensure that the data does not contain illegal URI characters
    • -
    • Ensure that the scheme (http or https), domain and stem are present.
    • +
    • Ensure that the scheme, domain and stem are present.
    • Ensure that the path info structure is correct allowing for AI extraction.
    • For each extracted AI, validate that the data corresponds to a known AI, unless disabled using gs1_encoder_setPermitUnknownAIs(), and that the overall length is within limits.
    • Ensure that the AIs extracted from the path info form a valid primary key to key-qualifier association.
    • @@ -871,6 +871,7 @@

    • Ensure that repeated AIs have the same value.
    • Ensure that mutually-exclusive AIs are not present.
    • Ensure that all requisite AIs are accounted for.
    • +
    • Ensure that serialisation qualifier AIs are present with Digital Signature.
  • diff --git a/docs/index.html b/docs/index.html index 938e49d..d629f11 100644 --- a/docs/index.html +++ b/docs/index.html @@ -853,7 +853,7 @@

  • For GS1 Digital Link URIs:
    • Ensure that the data does not contain illegal URI characters
    • -
    • Ensure that the scheme (http or https), domain and stem are present.
    • +
    • Ensure that the scheme, domain and stem are present.
    • Ensure that the path info structure is correct allowing for AI extraction.
    • For each extracted AI, validate that the data corresponds to a known AI, unless disabled using gs1_encoder_setPermitUnknownAIs(), and that the overall length is within limits.
    • Ensure that the AIs extracted from the path info form a valid primary key to key-qualifier association.
    • @@ -871,6 +871,7 @@

    • Ensure that repeated AIs have the same value.
    • Ensure that mutually-exclusive AIs are not present.
    • Ensure that all requisite AIs are accounted for.
    • +
    • Ensure that serialisation qualifier AIs are present with Digital Signature.
  • diff --git a/src/c-lib/gs1encoders.h b/src/c-lib/gs1encoders.h index 9bf015d..875ed0e 100644 --- a/src/c-lib/gs1encoders.h +++ b/src/c-lib/gs1encoders.h @@ -460,8 +460,7 @@ GS1_ENCODERS_API gs1_encoder* gs1_encoder_init(void *mem); * this is required. * * For GS1 Digital Link URIs: * * Ensure that the data does not contain illegal URI characters - * * Ensure that the scheme (`http` or `https`), domain and stem are - * present. + * * Ensure that the scheme, domain and stem are present. * * Ensure that the path info structure is correct allowing for AI * extraction. * * For each extracted AI, validate that the data corresponds to a known @@ -479,6 +478,7 @@ GS1_ENCODERS_API gs1_encoder* gs1_encoder_init(void *mem); * * Ensure that repeated AIs have the same value. * * Ensure that mutually-exclusive AIs are not present. * * Ensure that all requisite AIs are accounted for. + * * Ensure that serialisation qualifier AIs are present with Digital Signature. * * @param [in,out] ctx ::gs1_encoder context * @return pointer to error message string