| Message ID | 20230512171516.2203472-1-calvinwan@google.com (mailing list archive) |
|---|---|
| State | Superseded |
| Commit | d0ca92a7fe205195850f9d4b8cf774c0687c3789 |
| Headers | show |
| Series | strbuf cleanups | expand |
diff --git a/strbuf.h b/strbuf.h index 3dfeadb44c..70778c6e10 100644 --- a/strbuf.h +++ b/strbuf.h @@ -1,6 +1,14 @@ #ifndef STRBUF_H #define STRBUF_H +/* + * NOTE FOR STRBUF DEVELOPERS + * + * strbuf is a low-level primitive; as such it should interact only + * with other low-level primitives. Do not introduce new functions + * which interact with higher-level APIs. + */ + struct string_list; /**
strbuf, as a generic and widely used structure across the codebase, should be limited as a library to only interact with primitives. Add documentation so future functions can appropriately be placed. Older functions that do not follow this boundary should eventually be moved or refactored. Signed-off-by: Calvin Wan <calvinwan@google.com> --- strbuf.h | 8 ++++++++ 1 file changed, 8 insertions(+)