From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <jwakely.gcc@gmail.com>
Received: from mail-il1-x143.google.com (mail-il1-x143.google.com
 [IPv6:2607:f8b0:4864:20::143])
 by sourceware.org (Postfix) with ESMTPS id A1BFF386F036
 for <libc-alpha@sourceware.org>; Fri,  2 Oct 2020 13:19:48 +0000 (GMT)
DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org A1BFF386F036
Received: by mail-il1-x143.google.com with SMTP id z5so1202924ilq.5
 for <libc-alpha@sourceware.org>; Fri, 02 Oct 2020 06:19:48 -0700 (PDT)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:mime-version:references:in-reply-to:from:date
 :message-id:subject:to:cc;
 bh=c4EMSgKsEa1VfOLgdiXAIx0EYhfFfhqdmTR1iKp1ODA=;
 b=s6WTawJ5DiVkKnkCh4w57byNb1u3Ckz/bdvthpaQI8OIp1K73Q7y+wzgW/7tCZcx5U
 jchqGRsdu+sY+rcd/LnS6DNYXIGfNXKoFuQw7ggMdcsIH+xchxK4SD2e9g6oDb63IUkQ
 Ci8iVFd5gRp/5n/zsiAnWEdsquJKZTWZLvZDAtE0E+35dwma4kvsMV5x2nRDZsyoUYEp
 lDyp/vAYM2oyw9Dqra9l7pWr+MVnuMiJSoIfE2UlLyerhIUL/6KV8Pl37bMdxAG7vWxZ
 0G7ei4JOhBqfZ+oWy1rfQSn7EUWGsViYem2e6U07cJlFJamiTsWHWmhkb1E0BW2v6tUF
 su6w==
X-Gm-Message-State: AOAM530e+uIcG+7mo7Ahd9+DB/km+5iUb1LsgDRebYKECXAeq1UUEIH5
 aCyVB0OFzw30v3cijPbHl5gwhKZtmcrE5lI0SEw=
X-Google-Smtp-Source: ABdhPJwN8vJHXJ26HVLzeGLOIAGOFVTgCb+D8goY8qma9ZOqtznswLaJzjoM5xHeAOfw/XjDTnCPuelYckkrgeMotwc=
X-Received: by 2002:a05:6e02:e87:: with SMTP id
 t7mr1781692ilj.261.1601644788202; 
 Fri, 02 Oct 2020 06:19:48 -0700 (PDT)
MIME-Version: 1.0
References: <20201001150638.102544-1-colomar.6.4.3@gmail.com>
 <71c5f264-38f4-18ee-fe96-39aad08c3369@gmail.com>
 <41affebd-3354-9420-0048-bffd14535e95@gmail.com>
In-Reply-To: <41affebd-3354-9420-0048-bffd14535e95@gmail.com>
From: Jonathan Wakely <jwakely.gcc@gmail.com>
Date: Fri, 2 Oct 2020 14:19:37 +0100
Message-ID: <CAH6eHdQhh46TjVc72meWFTWCi7iouAod0iC1zLRga+c-36G+ig@mail.gmail.com>
Subject: Re: [PATCH 0/2] Document void *
To: Alejandro Colomar <colomar.6.4.3@gmail.com>
Cc: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>,
 linux-man <linux-man@vger.kernel.org>, 
 GNU C Library <libc-alpha@sourceware.org>, "gcc@gcc.gnu.org" <gcc@gcc.gnu.org>
Content-Type: text/plain; charset="UTF-8"
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00, DKIM_SIGNED,
 DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_FROM, RCVD_IN_DNSWL_NONE,
 SPF_HELO_NONE, SPF_PASS,
 TXREP autolearn=unavailable autolearn_force=no version=3.4.2
X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on
 server2.sourceware.org
X-BeenThere: libc-alpha@sourceware.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Libc-alpha mailing list <libc-alpha.sourceware.org>
List-Unsubscribe: <https://sourceware.org/mailman/options/libc-alpha>,
 <mailto:libc-alpha-request@sourceware.org?subject=unsubscribe>
List-Archive: <https://sourceware.org/pipermail/libc-alpha/>
List-Post: <mailto:libc-alpha@sourceware.org>
List-Help: <mailto:libc-alpha-request@sourceware.org?subject=help>
List-Subscribe: <https://sourceware.org/mailman/listinfo/libc-alpha>,
 <mailto:libc-alpha-request@sourceware.org?subject=subscribe>
X-List-Received-Date: Fri, 02 Oct 2020 13:19:49 -0000

On Thu, 1 Oct 2020 at 16:51, Alejandro Colomar via Gcc <gcc@gcc.gnu.org> wrote:
>
> Hi Michael,
>
> On 2020-10-01 17:34, Michael Kerrisk (man-pages) wrote:
> > Hello Alex,
> >
> > On 10/1/20 5:06 PM, Alejandro Colomar wrote:
> >> Hello Michael,
> >>
> >> This type is very special,
> >> so I will probably have missed some details about it.
> >
> > I do wonder if we actually need this in page at all, and given:
>
>
> I think it should be.
> I would also document 'void', even if it's a bit weird...
> They are very useful, so why not document them?

Because the man-pages are not a tutorial for the C language.

"The Linux man-pages project documents the Linux kernel and C library
interfaces that are employed by user-space programs."

void and void* are not APIs.