X-Authentication-Warning: delorie.com: mail set sender to djgpp-bounces using -f
X-Recipient: djgpp-workers AT delorie DOT com
X-Recipient: djgpp AT delorie DOT com
X-Original-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=20161025;
        h=mime-version:in-reply-to:references:from:date:message-id:subject:to
         :cc;
        bh=znRfuGUjWhxEKQFT/uN5ZMW766KbfyX1DxpNwjn33j8=;
        b=SFmrySVfm0GOTBC7MjQq6ziJmA9aCjGjpXJUda3R8uAlhdL8blhxNQYf87IhwKQRzJ
         ru97OxV2GVCSDMKQJYWre4QjivJJ7VTxBhNM/LQntvOMN30b29ClAy5+6lGKZad/u+je
         qwAZQNb/nmGZ58Vj/1XQBS5s0BBJ5b1H82GJzouE3VrmPbDp4WVFpd/pUTiwupFgFvrJ
         9kwTgn0ryxn2nOiu3y098OBu/jpmAaSxRy+d4xKtHyVDV7Cr9mNPz0hahDToJIszf08C
         fRfCuzEBEFgOW1twpf60o4fcIBt2wzuWzRodaIL3K1dq0CV+7QRqFSxpuzwVOmaNqB2L
         GCPg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=1e100.net; s=20161025;
        h=x-gm-message-state:mime-version:in-reply-to:references:from:date
         :message-id:subject:to:cc;
        bh=znRfuGUjWhxEKQFT/uN5ZMW766KbfyX1DxpNwjn33j8=;
        b=rXoyefmo3pQyv2GNz98MpeP+Ta9NBDYF8fB6CEMcLpzmyfcnX6csmiRm4jNZB8RAgK
         Pw6BP3fT3+aKv7Pz35R9eFXkJvMreizz19/0mq8WfttDH5mYCyAjQKNuRSTIuqIS6Weg
         rHCI7DjgXc7THxIiXv3Spp3GGBJw7Lkr4r/xwR6BMT8yasSyUyVO6ADiqkHXywa6CitZ
         ocX2YLMGsWwUd74Vs90MsPp3yIZrRdoxy5HRA6E9MXIax3F3SExQMoP29YyY3mKYuPCX
         4PLHY+JT4b2iWdLx83J8TiD4LsOh3nEgBABJWgShYY2i3g6k8sgLnRLB/lLBWUkyhng+
         XP/A==
X-Gm-Message-State: AKwxyteK1/+9fnvK934J160kE0Lo71Whw9AeDtglrUvK74q/+WVuXuJt
	3CDw62uoE4cmXINYxdL9Eh/yfN+m+xmu+HGv3Ak=
X-Google-Smtp-Source: AH8x226EmFWXifycvsF+ku+n2pLW5qF5cnKmcnBT+WUV8Qg73hWSwwg7WlXIRNTJSihxT3jqINUcyyw2AscammJ5c3Y=
X-Received: by 10.55.128.135 with SMTP id b129mr31743564qkd.187.1517508412885;
 Thu, 01 Feb 2018 10:06:52 -0800 (PST)
MIME-Version: 1.0
In-Reply-To: <83vafgelhr.fsf@gnu.org>
References: <CAA2C=vBTYCSoBbHEVOcUBwAv95+Waq9CMF_TTSvoyJut+zLb_A AT mail DOT gmail DOT com>
 <83vafgelhr DOT fsf AT gnu DOT org>
From: "Ozkan Sezer (sezeroz AT gmail DOT com) [via djgpp AT delorie DOT com]" <djgpp AT delorie DOT com>
Date: Thu, 1 Feb 2018 21:06:52 +0300
Message-ID: <CAA2C=vBExda4cz097GVhDS3ttDhkMXqrecKZO+RvDHk3E0iWOg@mail.gmail.com>
Subject: Re: updates to wc206.txi
To: djgpp-workers AT delorie DOT com
Cc: djgpp AT delorie DOT com
Content-Type: text/plain; charset="UTF-8"
Reply-To: djgpp AT delorie DOT com
Errors-To: nobody AT delorie DOT com
X-Mailing-List: djgpp AT delorie DOT com
X-Unsubscribes-To: listserv AT delorie DOT com
Precedence: bulk

On 2/1/18, Eli Zaretskii (eliz AT gnu DOT org) [via
djgpp-workers AT delorie DOT com] <djgpp-workers AT delorie DOT com> wrote:
>> From: "Ozkan Sezer (sezeroz AT gmail DOT com) [via djgpp AT delorie DOT com]"
>> <djgpp AT delorie DOT com>
>> Date: Thu, 1 Feb 2018 10:56:12 +0300
>>
>> The following patch updates the 2.06 changelog. Please review.
>> If no objections, I'll push it tomorrow.
>
> No objections, just some comments about Texinfo usage:
>
>> +@findex fseeko64 fix
>
> @findex renders everything in typewriter face, as appropriate for
> function names.  So if you want to put more than just a function's
> name there, you need to switch explicitly to the "normal" Roman
> typeface:
>
>   @findex fseeko64 AT r{
>
> Also, just saying "fix" is not informative, please tell more.
> Something like
>
>   @findex fseeko64 AT r{, fixed resetting the }_cnt AT r{ field}
>
>> +@findex Compatibility with new gcc versions
>
> This is not about any function, so please use @cindex instead.
>
>> +Compatibility with gcc-6 and newer versions achieved by using proper
>> +@code{-fno-builtin-*} compiler flags where needed in library builds.
>
> Options should have the @option markup, not @code.
>
>> +@findex djtar fix
>
> djtar is a program, so please use @pindex instead.
>
>> +Fixed a bug in djtar/unlzh (bug was introduced by djgpp-v2.05.)
>
> "djtar" should be given the @command markup, as it is a program.
>
> Thanks.
>

Thank you Eli, this is really helpful, because I'm not good with
texinfo stuff.  Is the following good?

Index: wc206.txi
===================================================================
RCS file: /cvs/djgpp/djgpp/src/docs/kb/wc206.txi,v
retrieving revision 1.8
diff -u -r1.8 wc206.txi
--- wc206.txi   1 Feb 2018 06:28:07 -0000       1.8
+++ wc206.txi   1 Feb 2018 18:04:41 -0000
@@ -31,3 +31,22 @@
 @cindex @acronym{C99} compliance, @code{math.h}
 @findex frexpl AT r{, added to the math library}
 The @acronym{C99} function @code{frexpl} was added to comply with the
@acronym{C99} standard.
+
+@findex fseeko64 AT r{, fixed resetting the }_cnt AT r{ field}
+Fixed @code{fseeko64} where it missed resetting the @code{_cnt}
+field of the FILE structure.
+
+@findex termios fix
+Fixed a NULL pointer dereference in termios @code{vbios_write_ch}
+private procedure.
+
+@findex _put_path AT r{, and the @file{/dev/} directory}
+The low-level @code{_put_path} procedure was changed to support
+[/\\]dev[/\\] instead of only /dev/ in file names.
+
+@cindex Compatibility with new gcc versions
+Compatibility with gcc-6 and newer versions achieved by using proper
+@option{-fno-builtin-*} compiler flags where needed in library builds.
+
+@pindex djtar fix
+Fixed a bug in djtar/unlzh (bug was introduced by djgpp-v2.05.)