docs: api/grn_ctx: move grn_ctx_at() reference to the header file

GitHub: groongaGH-1817

Prepare to switch to documents automatically generated by Doxygen.

doc/locale/ja/LC_MESSAGES/reference/api/grn_ctx.po

@@ -41,9 +41,3 @@ msgstr ""
 
 msgid "The number of bytes of name. If negative value is specified, name is assumed that NULL-terminated string."
 msgstr "名前のバイト数。負の値が指定された場合は、終端をNULL文字とした文字列として扱われる。"
-
-msgid "ctx、またはctxが使用するdbからidに対応するオブジェクトを検索して返す。idに一致するオブジェクトが存在しなければNULLを返す。"
-msgstr ""
-
-msgid "検索しようとするオブジェクトのidを指定します。"
-msgstr ""

doc/source/reference/api/grn_ctx.rst

@@ -25,8 +25,3 @@ Reference
    :param name: 検索しようとするオブジェクトの名前。
    :param name_size: The number of bytes of name. If negative value is specified, name is assumed that NULL-terminated string.
 
-.. c:function:: grn_obj *grn_ctx_at(grn_ctx *ctx, grn_id id)
-
-   ctx、またはctxが使用するdbからidに対応するオブジェクトを検索して返す。idに一致するオブジェクトが存在しなければNULLを返す。
-
-   :param id: 検索しようとするオブジェクトのidを指定します。

include/groonga/groonga.h

@@ -1005,6 +1005,16 @@ typedef enum {
   GRN_DB_TRIGRAM
 } grn_builtin_tokenizer;
 
+/**
+ * \brief Retrieve the object corresponding to the specified ID from the context
+ *        or the database that the context is using.
+ *
+ * \param ctx The context object.
+ * \param id The object ID to be retrieved.
+ *
+ * \return \ref grn_obj if the object that has the specified ID is found, `NULL`
+ *         otherwise.
+ */
 GRN_API grn_obj *
 grn_ctx_at(grn_ctx *ctx, grn_id id);
 /*