view helpgen/topic.h @ 8:ec2b657edf13

Add explicit lint-comment-style fallthrough annotations. GCC now assumes that if you don't have these you're making a mistake, which is annoying. XXX: This changeset updates the AG output files only (by hand) and is XXX: abusive - rebuilding them will erase the change. However, I need XXX: to get things to build before I can try to get AG to issue the XXX: annotations itself, so this seems like a reasonable expedient.
author David A. Holland
date Mon, 30 May 2022 23:51:43 -0400
parents 13d2b8934445
children
line wrap: on
line source

#ifndef TOPIC_H
#define TOPIC_H

struct topic; // opaque

struct topic *topic_create(void);
void topic_destroy(struct topic *);

void topic_addtitle(struct topic *, const char *);
void topic_addref(struct topic *, const char *);
void topic_setbody(struct topic *, const char *, size_t len);

const char *topic_getbody(struct topic *);
int topic_getnumtitles(struct topic *);
const char *topic_gettitle(struct topic *, int ix);
int topic_getnumrefs(struct topic *);
const char *topic_getref(struct topic *, int ix);

#endif /* TOPIC_H */