[PATCH v6 1/2] strbuf.h comment: discuss strbuf_addftime() arguments in order
- From
Ævar Arnfjörð Bjarmason <avarab@gmail.com>
- Date
- Jul 1, 2017, 12:55 UTC
- Message-ID
- <20170701125507.27214-1-avarab@gmail.com>
- In-Reply-To
- <xmqqk2419rhg.fsf@gitster.mtv.corp.google.com>
Change the comment documenting the strbuf_addftime() function to discuss the parameters in the order in which they appear, which makes this easier to read than discussing them out of order.
Signed-off-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com> --- strbuf.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/strbuf.h b/strbuf.h index 3646a6291b..6809d7daa8 100644 --- a/strbuf.h +++ b/strbuf.h @@ -334,10 +334,10 @@ extern void strbuf_vaddf(struct strbuf *sb, const char *fmt, va_list ap); /** * Add the time specified by `tm`, as formatted by `strftime`. - * `tz_name` is used to expand %Z internally unless it's NULL. * `tz_offset` is in decimal hhmm format, e.g. -600 means six hours west * of Greenwich, and it's used to expand %z internally. However, tokens * with modifiers (e.g. %Ez) are passed to `strftime`. + * `tz_name` is used to expand %Z internally unless it's NULL. */ extern void strbuf_addftime(struct strbuf *sb, const char *fmt, const struct tm *tm, int tz_offset,
-- 2.13.1.611.g7e3b11ae1