sfeed

simple feed reader - forked from git.codemadness.org/sfeed
git clone git://src.gearsix.net/sfeed
Log | Files | Refs | Atom | README | LICENSE

commit 4c678a04defbf750d9b902c0477620401f74a86b
parent 2565ba5d80b9ed075bcf2f2f4a6de5d38579bfaf
Author: Hiltjo Posthuma <hiltjo@codemadness.org>
Date:   Fri, 31 Jul 2015 22:29:34 +0200

update some comments

Diffstat:
Msfeed.c | 6+++---
Mutil.c | 13++++++-------
2 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/sfeed.c b/sfeed.c @@ -104,7 +104,7 @@ static void xml_handler_start_element_parsed(XMLParser *, const char *, static FeedContext ctx; static XMLParser parser; /* XML parser state */ -/* unique number for parsed tag (faster comparison) */ +/* Unique id for parsed tag (faster comparison). */ static enum TagId gettag(enum FeedType feedtype, const char *name, size_t namelen) { @@ -164,7 +164,7 @@ gettag(enum FeedType feedtype, const char *name, size_t namelen) return TagUnknown; /* NOTREACHED */ } -/* clear string only; don't free, prevents unnecessary reallocation */ +/* Clear string only; don't free, prevents unnecessary reallocation. */ static void string_clear(String *s) { @@ -210,7 +210,7 @@ string_append(String *s, const char *data, size_t len) s->data[s->len] = '\0'; } -/* get timezone from string, return as formatted string and time offset, +/* Get timezone from string, return as formatted string and time offset, * for the offset it assumes UTC. * NOTE: only parses timezones in RFC-822, other timezones are ambiguous * anyway. If needed you can add ones yourself, like "cest", "cet" etc. */ diff --git a/util.c b/util.c @@ -72,8 +72,8 @@ readpath: return strlcat(u->path, p, sizeof(u->path)) >= sizeof(u->path) ? -1 : 0; } -/* get absolute uri; if `link` is relative use `base` to make it absolute. - * the returned string in `buf` is uri encoded, see: encodeuri(). */ +/* Get absolute uri; if `link` is relative use `base` to make it absolute. + * the returned string in `buf` is uri encoded, see: encodeuri(). */ int absuri(const char *link, const char *base, char *buf, size_t bufsiz) { @@ -153,7 +153,7 @@ encodeuri(const char *s, char *buf, size_t bufsiz) return 0; } -/* read a field-separated line from 'fp', +/* Read a field-separated line from 'fp', * separated by a character 'separator', * 'fields' is a list of pointer with a maximum size of 'maxfields'. * 'maxfields' must be > 0. @@ -185,7 +185,7 @@ parseline(char **line, size_t *size, char **fields, return (int)i; } -/* parse time to time_t, assumes time_t is signed */ +/* Parse time to time_t, assumes time_t is signed. */ int strtotime(const char *s, time_t *t) { @@ -207,7 +207,7 @@ print(const char *s, FILE *fp, int (*fn)(int, FILE *)) fn((int)*s, fp); } -/* Unescape / decode fields printed by string_print_encode() +/* Unescape / decode fields printed by string_print_encoded() * "\\" to "\", "\t", to TAB, "\n" to newline. Unrecognised escape sequences * are ignored: "\z" etc. Call `fn` on each escaped character. */ void @@ -245,8 +245,7 @@ xmlencode(int c, FILE *fp) * internal buffer (OpenBSD). Others modify the contents of `path` (POSIX). * This is a wrapper function that is compatible with both versions. * The program will error out if basename(3) failed, this can only happen - * with the OpenBSD version. - */ + * with the OpenBSD version. */ char * xbasename(const char *path) {