Re: [PATCH] document string_list_clear

From: Jonathan Nieder <jrnieder@gmail.com>
Date: Dec 10, 2014, 21:51 UTC
Message-ID: <20141210215154.GF16345@google.com>
In-Reply-To: <5488A87C.4030505@alum.mit.edu>

Michael Haggerty wrote:

>                              I would find it a pity for that work to be
> squashed into Documentation/technical/api-*.txt, where in my opinion it
> is less discoverable and more likely to fall into disrepair.

I think we're in violent agreement and keep repeating ourselves.

All I said is that api-strbuf.txt is currently the most readable documentation of the strbuf API I can find. The patch to move the text to strbuf.h looked rough and incomplete. Therefore I don't think it's ready to be applied as is. If you'd like more details about why I say that, feel free to ask.

Jonathan

$ 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.