From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from us-smtp-delivery-1.mimecast.com (us-smtp-1.mimecast.com [205.139.110.61]) by sourceware.org (Postfix) with ESMTP id 61623395BC09 for ; Wed, 20 May 2020 13:12:32 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 61623395BC09 Received: from mail-qv1-f72.google.com (mail-qv1-f72.google.com [209.85.219.72]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-98-4uiiWgSnMaqrL9Iyk5C17Q-1; Wed, 20 May 2020 09:12:30 -0400 X-MC-Unique: 4uiiWgSnMaqrL9Iyk5C17Q-1 Received: by mail-qv1-f72.google.com with SMTP id g6so3549730qvn.3 for ; Wed, 20 May 2020 06:12:30 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:references:from:organization :message-id:date:user-agent:mime-version:in-reply-to :content-language:content-transfer-encoding; bh=AeTRhNwCtE7771LcuG9maFh568g29cflcBBOCA70KtQ=; b=t5vG9MCSYrYT5hBoGm6cHDVZIkcIdUv1E/VAXZ4ruUErieYCohefHM6eLKdejhjJ+k EDBDlL4VeUms0lCbVnuTr9OG6W6upOu3LrqK3ztEOvOXdK3v/YPbiwEQKpTySAjKizNi 5nLqEDIYZBG3g2iskLU/zFrIWCnPBRnn5L/xN/ELFuVU59Js6ukrl21w/i7G3ZPszkUv 5/eGP4cLN1NSebjMMN0P1vXjaQXfnjfuGdddp+Q7T9mJfdgNOZfRAktNGjw7QORy+BPz uDmWNj8V8Dy5JmeUtE3rgjyCpLFzWoA1aH03cFTugHsdRWBxq0vW1tUr2Ml0WqxAoZRY L4XQ== X-Gm-Message-State: AOAM532/ksHmor08sUNFmeTnwfIuBE30GAlO15PDtmGIhtGm1n6CKBJO 9pPS49ltcePR97GXQJi8vZfUqzDlMn7EQzarzbOoSpTzstTrpZb6YgGAnzvdpXkaDfnrPOdzqY3 pdidBUWDdApQB4L3prJJr X-Received: by 2002:ac8:2c38:: with SMTP id d53mr5228367qta.162.1589980349937; Wed, 20 May 2020 06:12:29 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyVxIHJQj9OjePmrXRcMDxR0Mf5UiwPrINQyn39lGcVacs0Dk5cUuNbcA+1S/zTAVUoPfbrrQ== X-Received: by 2002:ac8:2c38:: with SMTP id d53mr5228343qta.162.1589980349654; Wed, 20 May 2020 06:12:29 -0700 (PDT) Received: from [192.168.1.4] (198-84-170-103.cpe.teksavvy.com. [198.84.170.103]) by smtp.gmail.com with ESMTPSA id h12sm2492252qtb.19.2020.05.20.06.12.28 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 20 May 2020 06:12:28 -0700 (PDT) Subject: Re: [PATCH 01/19] manual: Add missing section and node for clockid_t wait functions To: Florian Weimer , libc-alpha@sourceware.org References: <640e1350db394fb52655c14c0e287c8059e98a18.1589884403.git.fweimer@redhat.com> From: Carlos O'Donell Organization: Red Hat Message-ID: <05e0a154-c403-3df0-1ab7-484a60ba7706@redhat.com> Date: Wed, 20 May 2020 09:12:28 -0400 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.7.0 MIME-Version: 1.0 In-Reply-To: <640e1350db394fb52655c14c0e287c8059e98a18.1589884403.git.fweimer@redhat.com> Content-Language: en-US X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-13.6 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 20 May 2020 13:12:33 -0000 On 5/19/20 6:44 AM, Florian Weimer via Libc-alpha wrote: > Without this, these functions appear under the node Default Thread > Attributes, which is confusing. > > Eventually, the documentation should be merged with the (yet to be > documented) standardized functions. OK for master. Reviewed-by: Carlos O'Donell > --- > manual/threads.texi | 8 ++++++++ > 1 file changed, 8 insertions(+) > > diff --git a/manual/threads.texi b/manual/threads.texi > index 0858ef8f92..a425635179 100644 > --- a/manual/threads.texi > +++ b/manual/threads.texi > @@ -625,6 +625,8 @@ the standard. > @menu > * Default Thread Attributes:: Setting default attributes for > threads in a process. > +* Waiting with Explicit Clocks:: Functions for waiting with an > + explicit clock specification. > @end menu > > @node Default Thread Attributes > @@ -669,6 +671,12 @@ The system does not have sufficient memory. > @end table > @end deftypefun > > +@node Waiting with Explicit Clocks > +@subsubsection Functions for Waiting According to a Specific Clock > + > +@Theglibc{} provides several waiting functions that expect an explicit > +@code{clockid_t} argument. > + > @comment semaphore.h > @comment POSIX-proposed > @deftypefun int sem_clockwait (sem_t *@var{sem}, clockid_t @var{clockid}, > -- Cheers, Carlos.