From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <mtk.lists@gmail.com>
Received: from mail-ej1-x643.google.com (mail-ej1-x643.google.com
 [IPv6:2a00:1450:4864:20::643])
 by sourceware.org (Postfix) with ESMTPS id 56DD8386F47D
 for <libc-alpha@sourceware.org>; Tue, 12 May 2020 06:03:04 +0000 (GMT)
DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 56DD8386F47D
Received: by mail-ej1-x643.google.com with SMTP id a2so10013844ejx.5
 for <libc-alpha@sourceware.org>; Mon, 11 May 2020 23:03:04 -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=RMcQvSDWISBqiwZsFbCirGsMBmmnNSQvLQG8MYIa69s=;
 b=sy11t10GTMAEcE/XG06mGrI4EidbEPzyFctYVtOt7txfQZy49Anf/5PRQA5woJLoq2
 dUnRFgpOBzgRDH2MlIgxD/7vo30xxTtpiwudxSS+fXa7v1nWg7rslYyOw8TCio28mjTP
 uSd6lhrHrShLmIBo6YY8WBBOBg8Y45uhBHtUrUC6gpDbdLtH9F/zxmoUFxphNU/sbvQz
 +bWl79UhZL+FC1q+0wXfit/Vb0dpE/nULm7HHWqmZK/Rjujb/+IqzsZ7lDZtCnxUEL9L
 B7aS1sboIySDMnhSmDEIM7/I+4H49fVpL4XAT65emv58m60aSsI2DMszy1Xi1IZskL6H
 v1XA==
X-Gm-Message-State: AGi0PuY8QgbXzMK7KRxXMsLjUPmyRIJxvccIgV2dFYd8Cn1GP5XOJGp7
 nZtUc/MpWko/STGLQfpz882SYiG8ssiE+6GbH7szlQ==
X-Google-Smtp-Source: APiQypLALIeV8CiOaMVsSVwGcvjAQK0sPr5JxTVWFEBrwOOU0fcB6AXmDtcgdvCnNHNARbxmcrj2AoiTuLx3qjVNezo=
X-Received: by 2002:a17:906:4111:: with SMTP id
 j17mr16857103ejk.242.1589263383433; 
 Mon, 11 May 2020 23:03:03 -0700 (PDT)
MIME-Version: 1.0
References: <87d07p9v73.fsf@mid.deneb.enyo.de>
In-Reply-To: <87d07p9v73.fsf@mid.deneb.enyo.de>
From: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Tue, 12 May 2020 08:02:52 +0200
Message-ID: <CALxWeYq5BPUG2XBCCT-gnYEsWnN22S6-zYmH=qUtmmwZNWMNng@mail.gmail.com>
Subject: Re: [PATCH] manual: Add Descriptor-Relative Access section
To: Florian Weimer <fw@deneb.enyo.de>
Cc: libc-alpha <libc-alpha@sourceware.org>, 
 Michael Kerrisk-manpages <mtk.manpages@gmail.com>
Content-Type: text/plain; charset="UTF-8"
X-Spam-Status: No, score=-3.8 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=ham 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: <http://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: <http://sourceware.org/mailman/listinfo/libc-alpha>,
 <mailto:libc-alpha-request@sourceware.org?subject=subscribe>
X-List-Received-Date: Tue, 12 May 2020 06:03:05 -0000

One more thought...

> +@itemize @bullet
> +@item
> +It can be a file descriptor referring to a directory.  Such a descriptor
> +can be created explicitly using the @code{open} function, with or
> +without the @code{O_DIRECTORY} flag.

Is it worth mentioning O_PATH here?

Thanks,

Michael