libmtdac 1.6.2

ac000 · ac000 · commit 32340cb8b1b6 · 2026-05-19T05:28:29.000+01:00
Signed-off-by: Andrew Clayton &lt;ac@sigsegv.uk&gt;
diff --git a/docs/man/man3/libmtdac.3 b/docs/man/man3/libmtdac.3
@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "libmtdac" "3" "May 19, 2026" "Version 1.6.1+" "libmtdac"
+.TH "libmtdac" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]libmtdac\f[R] \- UK HMRC Make Tax Digital API interface
 .SH SYNOPSIS
diff --git a/docs/man/man3/libmtdac_mtd.h.3 b/docs/man/man3/libmtdac_mtd.h.3
@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "libmtdac_mtd.h" "3" "May 19, 2026" "Version 1.6.1+" "libmtdac"
+.TH "libmtdac_mtd.h" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]libmtdac_mtd.h\f[R] \- Core types / macros
 .SH SYNOPSIS
diff --git a/docs/man/man3/mtd_deinit.3 b/docs/man/man3/mtd_deinit.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_deinit" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_deinit" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_deinit\f[R] \- library cleanup
 .SH LIBRARY
diff --git a/docs/man/man3/mtd_ep.3 b/docs/man/man3/mtd_ep.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_ep" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_ep" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_ep\f[R] \- send query to API endpoint
 .SH LIBRARY
@@ -31,13 +31,13 @@ You can see more information about each endpoint in
 \f[B]dsctx\f[R]
 is a \f[B]struct mtd_dsrc_ctx\f[R] that defines the source of
 \f[I]POST\f[R]/*PUT* data.
-For endpoints that don\[cq]t take such data, this should be
+For endpoints that don\(cqt take such data, this should be
 \f[B]NULL\f[R].
 .TP
 \f[B]buf\f[R]
 this is the output buffer.
-It will be allocated by libmtdac and should be \f[B]free(3)\f[R]\[cq]d
-by you.
+It will be allocated by libmtdac and should be \f[B]free(3)\f[R]\(cqd by
+you.
 .TP
 \f[B]params\f[R]
 this specifies the parameters required for the endpoint including any
@@ -58,7 +58,7 @@ extras will be ignored.
 There is no need to pass in how many entries is in params (or for it to
 be NULL terminated) as this is dictated by each endpoint.
 .PP
-For any endpoints which don\[cq]t require \f[I]any\f[R] parameters, this
+For any endpoints which don\(cqt require \f[I]any\f[R] parameters, this
 can be \f[B]NULL\f[R].
 If an endpoint \f[I]only\f[R] takes an \f[I]optional\f[R] query stirng,
 then you still need a params with a single entry either containing NULL
@@ -73,7 +73,7 @@ On error, one of the below errors is returned.
 .PP
 \f[I]buf\f[R] will always either be returned as \f[B]NULL\f[R]
 \f[I]or\f[R] a valid result buffer containing JSON which should be
-\f[B]free(3)\f[R]\[cq]d.
+\f[B]free(3)\f[R]\(cqd.
 .SH ERRORS
 .TP
 \f[B]MTD_ERR_OS\f[R]
diff --git a/docs/man/man3/mtd_ep_api_get_info.3 b/docs/man/man3/mtd_ep_api_get_info.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_ep_api_get_info" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_ep_api_get_info" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_ep_api_get_info\f[R] \- query endpoint API information
 .SH LIBRARY
diff --git a/docs/man/man3/mtd_err2enum_str.3 b/docs/man/man3/mtd_err2enum_str.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_err2enum_str" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_err2enum_str" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_err2enum_str\f[R] \- error code enum as a string
 .SH LIBRARY
diff --git a/docs/man/man3/mtd_err2str.3 b/docs/man/man3/mtd_err2str.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_err2str" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_err2str" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_err2str\f[R] \- error code to description
 .SH LIBRARY
diff --git a/docs/man/man3/mtd_global_init.3 b/docs/man/man3/mtd_global_init.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_global_init" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_global_init" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_global_init\f[R] \- global initialisation
 .SH LIBRARY
diff --git a/docs/man/man3/mtd_hmrc_free_error.3 b/docs/man/man3/mtd_hmrc_free_error.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_hmrc_free_error" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_hmrc_free_error" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_hmrc_free_error\f[R] \- free a linked list of struct
 mtd_hmrc_err
diff --git a/docs/man/man3/mtd_hmrc_get_error.3 b/docs/man/man3/mtd_hmrc_get_error.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_hmrc_get_error" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_hmrc_get_error" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_hmrc_get_error\f[R] \- get HMRC endpoint error(s)
 .SH LIBRARY
diff --git a/docs/man/man3/mtd_http_status_code.3 b/docs/man/man3/mtd_http_status_code.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_http_status_code" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_http_status_code" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_http_status_code\f[R] \- http status code of last request
 .SH LIBRARY
diff --git a/docs/man/man3/mtd_http_status_str.3 b/docs/man/man3/mtd_http_status_str.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_http_status_str" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_http_status_str" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_http_status_str\f[R] \- http status string of last request
 .SH LIBRARY
diff --git a/docs/man/man3/mtd_http_status_str_u.3 b/docs/man/man3/mtd_http_status_str_u.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_http_status_str_u" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_http_status_str_u" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_http_status_str_u\f[R] \- http status code as string version of
 the enum
diff --git a/docs/man/man3/mtd_init.3 b/docs/man/man3/mtd_init.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_init" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_init" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_init\f[R] \- per\-instance/thread initialisation
 .SH LIBRARY
@@ -134,20 +134,20 @@ If the \f[I]fph_ops\f[R] structure or any of its members are
 \f[B]NULL\f[R] then the default inbuilt functions are used.
 .PP
 These functions should return a dynamically allocated buffer that will
-be \f[B]free(3)\f[R]\[aq]d by libmtdac.
+be \f[B]free(3)\f[R]\(aqd by libmtdac.
 .PP
 \f[I]extra_hdrs\f[R] can be used to send extra HTTP headers, it should
 point to a NULL terminated array of character pointers.
 .PP
 \f[I]config_dir\f[R] should point to a string containing the path to the
 configuration directory for this application.
 E.g.
-\[dq]/home/foo/.config/my\-app\[dq]
+\(dq/home/foo/.config/my\-app\(dq
 .PP
 \f[I]log_fp\f[R] can \f[I]optionally\f[R] point to a valid file\-pointer
 of an already opened file for writing to have logs sent to.
-This doesn\[aq]t affect \f[I]MTD_LOG_ERROR\f[R] logs which are still
-sent to \f[I]stderr\f[R].
+This doesn\(aqt affect \f[I]MTD_LOG_ERROR\f[R] logs which are still sent
+to \f[I]stderr\f[R].
 .SH RETURN VALUE
 On success, zero (\f[B]MTD_ERR_NONE\f[R]) is returned.
 On error, one of the below errors is returned.
@@ -157,7 +157,7 @@ On error, one of the below errors is returned.
 There was an OS level failure.
 .TP
 \f[B]MTD_ERR_UNKNOWN_FLAGS\f[R]
-One or more of the supplied flags weren\[aq]t recognised.
+One or more of the supplied flags weren\(aqt recognised.
 .TP
 \f[B]MTD_ERR_CONFIG_DIR_UNSPEC\f[R]
 The config directory was unspecified.
diff --git a/docs/man/man3/mtd_init_auth.3 b/docs/man/man3/mtd_init_auth.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_init_auth" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_init_auth" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_init_auth\f[R] \- authorise with HMRC account
 .SH LIBRARY
@@ -20,7 +20,7 @@ It will prompt the user for the fBauthorisation codefP that is shown to
 the user after completing the above step.
 .PP
 Once the user has entered the code it will create a
-\f[B]\[ti]/.config/APP/libmtdac/{prod,test}\-api/oauth.json\f[R] file.
+\f[B]\(ti/.config/APP/libmtdac/{prod,test}\-api/oauth.json\f[R] file.
 .TP
 \f[B]scope\f[R]
 is an enum value specifying which Make Tax Digital API this is adding
@@ -32,10 +32,10 @@ For Income TAX Self\-Assessment
 \f[B]MTD_API_SCOPE_VAT\f[R]
 For VAT
 .PP
-The above can optionally be bitwise \f[B]OR\f[R]\[aq]d with
+The above can optionally be bitwise \f[B]OR\f[R]\(aqd with
 .TP
 \f[B]MTD_API_SCOPE_ADD\f[R]
-Which says don\[aq]t reset the oauth.json file when writing it, instead
+Which says don\(aqt reset the oauth.json file when writing it, instead
 add this OAuth as another entry (or overwrite an existing entry without
 resetting the file).
 .TP
@@ -64,6 +64,6 @@ There was an error with the request.
 \f[B]MTD_ERR_CONFIG_DIR_INVALID\f[R]
 The supplied config directory is invalid.
 .SH FILES
-\[ti]/.config/APP/libmtdac/{prod,test}\-api/oauth.json
+\(ti/.config/APP/libmtdac/{prod,test}\-api/oauth.json
 .SH SEE ALSO
 \f[B]libmtdac(3)\f[R], \f[B]libmtdac_mtd.h(3)\f[R]
diff --git a/docs/man/man3/mtd_init_creds.3 b/docs/man/man3/mtd_init_creds.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_init_creds" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_init_creds" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_init_creds\f[R] \- initialise creds.json
 .SH LIBRARY
@@ -11,7 +11,7 @@ libmtdac, \f[I]\-lmtdac\f[R]
 int mtd_init_creds(enum mtd_api_scope scope);
 .SH DESCRIPTION
 This function is used to create an initial
-\f[B]\[ti]/.config/APP/libmtdac/{prod,test}\-api/creds.json\f[R] file
+\f[B]\(ti/.config/APP/libmtdac/{prod,test}\-api/creds.json\f[R] file
 that contains the users \f[I]client_id\f[R] & \f[I]client_secret\f[R].
 .PP
 This will prompt the user to enter the above tokens after which the file
@@ -29,10 +29,10 @@ For Income TAX Self\-Assessment
 \f[B]MTD_API_SCOPE_VAT\f[R]
 For VAT
 .PP
-The above can optionally be bitwise \f[B]OR\f[R]\[aq]d with
+The above can optionally be bitwise \f[B]OR\f[R]\(aqd with
 .TP
 \f[B]MTD_API_SCOPE_ADD\f[R]
-Which says don\[aq]t reset the oauth.json file when writing it, instead
+Which says don\(aqt reset the oauth.json file when writing it, instead
 add this OAuth as another entry (or overwrite an existing entry without
 resetting the file).
 .SH RETURN VALUE
@@ -49,6 +49,6 @@ Invalid scope was provied.
 \f[B]MTD_ERR_CONFIG_DIR_INVALID\f[R]
 The supplied config directory is invalid.
 .SH FILES
-\[ti]/.config/APP/libmtdac/{prod,test}\-api/creds.json
+\(ti/.config/APP/libmtdac/{prod,test}\-api/creds.json
 .SH SEE ALSO
 \f[B]libmtdac(3)\f[R], \f[B]libmtdac_mtd.h(3)\f[R]
diff --git a/docs/man/man3/mtd_init_nino.3 b/docs/man/man3/mtd_init_nino.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_init_nino" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_init_nino" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_init_nino\f[R] \- initialise national insurance number
 .SH LIBRARY
@@ -11,8 +11,8 @@ libmtdac, \f[I]\-lmtdac\f[R]
 int mtd_init_nino(void);
 .SH DESCRIPTION
 This function is used to create an initial
-\f[B]\[ti]/.config/APP/libmtdac/{prod,test}\-api/nino.json\f[R] file
-that contains the users \f[I]NINO\f[R] (National Insurance Number).
+\f[B]\(ti/.config/APP/libmtdac/{prod,test}\-api/nino.json\f[R] file that
+contains the users \f[I]NINO\f[R] (National Insurance Number).
 .PP
 This will prompt the user to enter their \f[I]NINO\f[R] after which the
 file will be created.
@@ -26,6 +26,6 @@ On error, one of the below errors is returned.
 \f[B]MTD_ERR_OS\f[R]
 There was an OS level failure.
 .SH FILES
-\[ti]/.config/APP/libmtdac/{prod,test}\-api/nino.json
+\(ti/.config/APP/libmtdac/{prod,test}\-api/nino.json
 .SH SEE ALSO
 \f[B]libmtdac(3)\f[R], \f[B]libmtdac_mtd.h(3)\f[R]
diff --git a/docs/man/man3/mtd_is_valid_fmt.3 b/docs/man/man3/mtd_is_valid_fmt.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_is_valid_fmt" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_is_valid_fmt" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_is_valid_fmt\f[R] \- check if given item is in a valid format
 .SH LIBRARY
diff --git a/docs/man/man3/mtd_percent_encode.3 b/docs/man/man3/mtd_percent_encode.3
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.2
 .\"
-.TH "mtd_percent_encode" "3" "Mar 30, 2026" "Version 1.6.1" "libmtdac"
+.TH "mtd_percent_encode" "3" "May 19, 2026" "Version 1.6.2" "libmtdac"
 .SH NAME
 \f[B]mtd_percent_encode\f[R] \- percent encode a string
 .SH LIBRARY
@@ -21,7 +21,7 @@ Use \f[B]\-1\f[R] (SIZE_MAX) for len to be taken as
 \f[I]strlen(str)\f[R].
 .SH RETURN VALUE
 On success, a pointer to a dynamically allocated buffer containing the
-encoded string, which should be \f[B]free(2)\f[R]\[aq]d when finished
+encoded string, which should be \f[B]free(2)\f[R]\(aqd when finished
 with.
 .PP
 On error, \f[B]NULL\f[R] is returned.
diff --git a/docs/man/man3type/mtd_dsrc_ctx.3type b/docs/man/man3type/mtd_dsrc_ctx.3type
diff --git a/docs/man/man3type/mtd_ep_api_info.3type b/docs/man/man3type/mtd_ep_api_info.3type
diff --git a/docs/man/man3type/mtd_hmrc_err.3type b/docs/man/man3type/mtd_hmrc_err.3type
diff --git a/include/libmtdac/mtd.h b/include/libmtdac/mtd.h
diff --git a/libmtdac.spec b/libmtdac.spec
diff --git a/version.mk b/version.mk
