Re: [PATCH 2/4] api docs: document BUG() in api-error-handling.txt

From: Bagas Sanjaya <bagasdotme@gmail.com>
Date: Mar 29, 2021, 05:37 UTC
Message-ID: <7bbcebcd-002b-0c40-2415-d29cb7a6e3ec@gmail.com>
In-Reply-To: <patch-2.5-8c8b1dfd184-20210328T022343Z-avarab@gmail.com>

On 28/03/21 09.26, Ævar Arnfjörð Bjarmason wrote:

Show 11 quoted lines

> -`die`, `usage`, `error`, and `warning` report errors of various
> -kinds.
> +`BUG`, `die`, `usage`, `error`, and `warning` report errors of
> +various kinds.
> +
> +- `BUG` is for failed internal assertions that should never happen,
> +  i.e. a bug in git itself.
>   
>   - `die` is for fatal application errors.  It prints a message to
>     the user and exits with status 128.
>

Documentation looks OK.

-- 
An old man doll... just what I always wanted! - Clara

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.