Subject: Re: [PATCH] ares_parse_txt_reply: add `record_start` field

Re: [PATCH] ares_parse_txt_reply: add `record_start` field

From: Daniel Stenberg <daniel_at_haxx.se>
Date: Mon, 1 Feb 2016 23:29:27 +0100 (CET)

On Mon, 1 Feb 2016, Fedor Indutny wrote:

> I have made fixes to the patch from 2015-03-21, according to your comments.
>
> Please take a look.

Two comments from me:

1. Please don't refer to source code file names in ares.h. That's a public
header file and users of c-ares will read that and have no idea about the
specific source file or what we're talking about. You could of course still
explain that the new struct is a superset of the old one.

2. Regarding the documentation/functionality. The new man page paragraph says:

   "Continuations are linked using next pointer field in the structure"

(I think it should say "*the* next pointer...")

... but it doesn't really explain how it works with any details. Should the
user then consider the 'txt' areas to be joined? I don't think we can presume
users will understand what a continuation is if we don't explain it!

-- 
  / daniel.haxx.se
Received on 2016-02-01