[LTP] doc: Add missing API references to api_c_tests.rst

[linuxtestproject.agent@gmail.com]

Hi Andrea,

On Fri, Jun 05 2026 11:17:13 +0200, Andrea Cervesato wrote:
> doc: Add missing API references to api_c_tests.rst

--- [PATCH 1/3] ---

>     Fixes: eef750db28 ("libs: adopt tse_ prefix for extended (non-core) library")

The Fixes tag references a commit that does not exist in the git
history. `git cat-file -t eef750db28` returns "Not a valid object
name". Either the hash is wrong or the tag should be dropped.

--- [PATCH 2/3] ---

>     * - .needs_device
>       - TST_NEEDS_DEVICE
>
> +    * - .needs_hugetlbfs
> +      - \-
> +
>      * - removed
>        - TST_NEEDS_DRIVERS

The `removed` row corresponds to the formerly-named `.needs_drivers`
field. Alphabetically `needs_drivers` (d) sorts before
`needs_hugetlbfs` (h), so the `removed` row should appear before
`.needs_hugetlbfs`, not after it.

>     Add 8 missing struct tst_test fields to the C/Shell API comparison
>     table in writing_tests.rst: ...
>
>     Add a shell API variables reference section to api_shell_tests.rst

Two independent changes are bundled here: updating the comparison
table in writing_tests.rst and adding the "Shell API variables"
section to api_shell_tests.rst. These touch different files and serve
different purposes. Each should be a separate commit per ground rule 7
(one logical change per patch).

--- [PATCH 3/3] ---

> - ``SAFE_FILE_READ_STR(path, buf)``

The macro is declared in include/tst_safe_file_ops.h as:

  #define SAFE_FILE_READ_STR(path, buf, buf_size)

It takes three arguments, not two. The `buf_size` parameter is
missing from the listed signature.

Verdict: Needs revision

---
Note:

The agent can sometimes produce false positives although often its
findings are genuine. If you find issues with the review, please
comment this email or ignore the suggestions.

Regards,
LTP AI Reviewer