From patchwork Tue Oct 20 14:21:26 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40760 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id C0CE339450FD; Tue, 20 Oct 2020 14:23:24 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org C0CE339450FD DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203804; bh=KBmDSg7Kmagr47rya0Pnkx9S4aBnm/Fm6xh1MWNJ6UE=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=NOU7718586jRWpGLn5Mi8UdZ7cj5kjaWYHea0T3UkkvIGkBwu27syuvEtSeGyzrSH ITLVTWOF7CzC9F/rjhDqSEl1Z/nH20bFD+IOjPWSAyY3saVLGqR0S1Gygckxnt1iOf f8OGUGZZ6vP7DDeTprq4JV/zulMbMkUb3XvIWDf0= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x443.google.com (mail-wr1-x443.google.com [IPv6:2a00:1450:4864:20::443]) by sourceware.org (Postfix) with ESMTPS id BB38C3857008 for ; Tue, 20 Oct 2020 14:23:22 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org BB38C3857008 Received: by mail-wr1-x443.google.com with SMTP id n15so2407863wrq.2 for ; Tue, 20 Oct 2020 07:23:22 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=KBmDSg7Kmagr47rya0Pnkx9S4aBnm/Fm6xh1MWNJ6UE=; b=L9NqcbBd5gJ+U4BVQ9HCtNbJ0tBRjiUFMJcj/xKzEPLOv6qe0NJTdufdfQLA+YPZWo CZmwmDjM9ZEes4z9dobJh1WY7NjUgQO75yVHG/tbSlP7JLJvf3sIhHaFj4DwXyaBgR8D 6qwoM4ZCQqjGz2uKbCLgqoVV9xul1xa+wkGqSaP/0CNZ9tC3xfZgiOYgHGVyIrwn9pkh UrETU9UNtId6Ns5xCyX0Lrdp7WFFV4zPFTBq207QT/qcHqbmHyhvkaX2e7M7AGMibwJg HYQh3s4N/gDguQDHstLP15H1whEBCNr2Z2smCncCTBKrc37pMM4Vc+OVmW9xHA0mt6kN /jOQ== X-Gm-Message-State: AOAM530n0zhix91EqRRy8tsWZNK83Jm2hOLYJ52v2QmUtmX+216280OO pXzeA00TP2TfHDkz3yCB0hA= X-Google-Smtp-Source: ABdhPJx8tO8bgaIIyb5YlCu7ADXZcsqf1Jge2lMDiTD3euZCLXiXGYmae7+rAiXy/G/RAcZI5huROA== X-Received: by 2002:adf:8405:: with SMTP id 5mr3994317wrf.143.1603203801680; Tue, 20 Oct 2020 07:23:21 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:21 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 01/22] list.3: New page that will hold the (list) contents of queue.3 Date: Tue, 20 Oct 2020 16:21:26 +0200 Message-Id: <20201020142146.61837-2-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.4 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, KAM_NUMSUBJECT, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 man3/list.3 diff --git a/man3/list.3 b/man3/list.3 new file mode 100644 index 000000000..127c391f1 --- /dev/null +++ b/man3/list.3 @@ -0,0 +1,40 @@ +.\" Copyright (c) 1993 +.\" The Regents of the University of California. All rights reserved. +.\" and Copyright (c) 2020 by Alejandro Colomar +.\" +.\" %%%LICENSE_START(BSD_3_CLAUSE_UCB) +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" %%%LICENSE_END +.\" +.\" +.TH LIST 3 2020-10-19 "GNU" "Linux Programmer's Manual" +.SH NAME +.SH SYNOPSIS +.SH DESCRIPTION +.SH RETURN VALUE +.SH CONFORMING TO +.SH BUGS +.SH EXAMPLES +.SH SEE ALSO From patchwork Tue Oct 20 14:21:27 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40761 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 537FB3945C18; Tue, 20 Oct 2020 14:23:26 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 537FB3945C18 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203806; bh=UG0rXrw3CBsfE3f/zeHuA1mFbFHv3bshR6MacpsGi50=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=qgJgno3h9/LF041bPVSa7cAxKndE4lohbZgDoJ2AqGLdWyxEWU6CXRfF5V6WGxVAg EDGhHW80p687Lbl5wzwW1syvllUy0V9flaX8zdnFJdCDlbiNKVK/tmq0SgLxuDDEmk a/p569EORIlZs8xGP/7mCXzmVG4fr8nfsV2Zyva8= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x435.google.com (mail-wr1-x435.google.com [IPv6:2a00:1450:4864:20::435]) by sourceware.org (Postfix) with ESMTPS id DD67E386EC26 for ; Tue, 20 Oct 2020 14:23:23 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org DD67E386EC26 Received: by mail-wr1-x435.google.com with SMTP id j7so2377821wrt.9 for ; Tue, 20 Oct 2020 07:23:23 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=UG0rXrw3CBsfE3f/zeHuA1mFbFHv3bshR6MacpsGi50=; b=a+FeFfdUkiJyFGLiP2zg38aaRyCzeegt1783S7L6AfD7Ta9GHwuKDvGzBFMCIAt53l ZrybGhTDp9Pmirz3GrwZe3laIlzX7pmsXH+P2aatQiKtt+Xd2ekGTpxXk3z/3mIZ8m02 EUj++eZ+ULY7mkdWpW/B3AWMCnd7sToXsimQEtFXh7B+ELpFLIe4RXmC7OtwQ3Wm7WLV /TkeFfinZvoKXQ8c/BlAoVPiZx4a4U/zG2c/w90EPG8Eq/k1A2xWr3aGDs2UhbjR06y3 Oyg5ufPmPxjnBYIsw7gnk7JErojJqFysyQkxI7L9ouKX31eaCtXPJlhfT4grYNDbrPog GfgQ== X-Gm-Message-State: AOAM533p6rukhcgkVfc8RFmsMP5xQCcWMW0fd3Dum+bl2EyvFx34XQBZ OjetK4jafmNvzyDtdtT93f0= X-Google-Smtp-Source: ABdhPJxO0mpJSq6tekkU5+4USMzItV2/kqKwih9oGOCbWPkHDAdj5ey7z4JKEmUOCxYerTYUVevpew== X-Received: by 2002:a05:6000:1151:: with SMTP id d17mr4082928wrx.363.1603203802854; Tue, 20 Oct 2020 07:23:22 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:22 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 02/22] list.3, queue.3: NAME: Move code from queue.3 to list.3 Date: Tue, 20 Oct 2020 16:21:27 +0200 Message-Id: <20201020142146.61837-3-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, KAM_NUMSUBJECT, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP, UPPERCASE_50_75 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 17 +++++++++++++++++ man3/queue.3 | 17 ----------------- 2 files changed, 17 insertions(+), 17 deletions(-) diff --git a/man3/list.3 b/man3/list.3 index 127c391f1..340b24f7c 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -31,6 +31,23 @@ .\" .TH LIST 3 2020-10-19 "GNU" "Linux Programmer's Manual" .SH NAME +.Nm LIST_EMPTY , +.Nm LIST_ENTRY , +.Nm LIST_FIRST , +.Nm LIST_FOREACH , +.\" .Nm LIST_FOREACH_FROM , +.\" .Nm LIST_FOREACH_SAFE , +.\" .Nm LIST_FOREACH_FROM_SAFE , +.Nm LIST_HEAD , +.Nm LIST_HEAD_INITIALIZER , +.Nm LIST_INIT , +.Nm LIST_INSERT_AFTER , +.Nm LIST_INSERT_BEFORE , +.Nm LIST_INSERT_HEAD , +.Nm LIST_NEXT , +.\" .Nm LIST_PREV , +.Nm LIST_REMOVE , +.\" .Nm LIST_SWAP , .SH SYNOPSIS .SH DESCRIPTION .SH RETURN VALUE diff --git a/man3/queue.3 b/man3/queue.3 index c48b4ba9f..17adfcf3b 100644 --- a/man3/queue.3 +++ b/man3/queue.3 @@ -71,23 +71,6 @@ .Nm STAILQ_REMOVE_HEAD , .Nm STAILQ_REMOVE , .\" .Nm STAILQ_SWAP , -.Nm LIST_EMPTY , -.Nm LIST_ENTRY , -.Nm LIST_FIRST , -.Nm LIST_FOREACH , -.\" .Nm LIST_FOREACH_FROM , -.\" .Nm LIST_FOREACH_SAFE , -.\" .Nm LIST_FOREACH_FROM_SAFE , -.Nm LIST_HEAD , -.Nm LIST_HEAD_INITIALIZER , -.Nm LIST_INIT , -.Nm LIST_INSERT_AFTER , -.Nm LIST_INSERT_BEFORE , -.Nm LIST_INSERT_HEAD , -.Nm LIST_NEXT , -.\" .Nm LIST_PREV , -.Nm LIST_REMOVE , -.\" .Nm LIST_SWAP , .Nm TAILQ_CONCAT , .Nm TAILQ_EMPTY , .Nm TAILQ_ENTRY , From patchwork Tue Oct 20 14:21:28 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40762 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 1CA013945C2F; Tue, 20 Oct 2020 14:23:28 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 1CA013945C2F DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203808; bh=lpSxt1wspAI+xvkHQETbb0va5gJJe4jo9bYuqOZC0t8=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=C8h5/u0yY6g/C8RIs52cjiw7GSUMf+PJyghtGHwGUAvh07cEiM0U8ycc69VsJ7cuZ 5/wu0Uq7DID3Qu0ojA0FmkUpq3faRKs47RiFKX//0369fLAmcIaLLffrnDYLfcGHPT vIdnPZYCRoQG+XbPu1K9iDLM7si6Ly+PDcEFlKH0= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x442.google.com (mail-wr1-x442.google.com [IPv6:2a00:1450:4864:20::442]) by sourceware.org (Postfix) with ESMTPS id C90D239450FF for ; Tue, 20 Oct 2020 14:23:24 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org C90D239450FF Received: by mail-wr1-x442.google.com with SMTP id n18so2398632wrs.5 for ; Tue, 20 Oct 2020 07:23:24 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=lpSxt1wspAI+xvkHQETbb0va5gJJe4jo9bYuqOZC0t8=; b=rPG50d/JxAQPfjZKuLNatUAOd8Nm6TQjZxxYAbrXFTCf0WxSSpaQXHzhuKz7igJJyW uWrMNF/t5i73qgbaQL0mrDZp/bUVnCv4Uoz9ueHeBNgKutPlqBLRNt2qtuWOrRZZjzeg gpwy2JqRC6KFs7q12LwWZT75wC27qtepelbWtHBklhbJ9QW7/TTVUTDSSy5BUo471l81 liQ9RvrnZFya1rBfkvZlZmkVB33e7T1+kzW5mJJnhJrN27L67AfzGMuEvJswbuCKHu44 ChIN7M7YpI7CrKu+BQHABg2hnP8GPRHdbA1LU0sW4XwPaTahNDFJ0fujICLsd93j581A JoWA== X-Gm-Message-State: AOAM532+yFB82E0Ugxubwg8epP/KhSViSFYokGH7kKeGvzcjYmJgh4Kh JWHXvCggTGG/UQeOgFOFD20= X-Google-Smtp-Source: ABdhPJycPvQl2kzyKt93BRnj0o1apTzb3GWB0Ni12+ZVHDNwUxCU0tJqXZ+OekEzThhvJvEdpSISVQ== X-Received: by 2002:adf:9793:: with SMTP id s19mr3914714wrb.139.1603203803908; Tue, 20 Oct 2020 07:23:23 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:23 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 03/22] list.3: NAME: ffix: Use man markup Date: Tue, 20 Oct 2020 16:21:28 +0200 Message-Id: <20201020142146.61837-4-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-11.1 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP, UPPERCASE_50_75 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 34 +++++++++++++++++----------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/man3/list.3 b/man3/list.3 index 340b24f7c..d26ac8971 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -31,23 +31,23 @@ .\" .TH LIST 3 2020-10-19 "GNU" "Linux Programmer's Manual" .SH NAME -.Nm LIST_EMPTY , -.Nm LIST_ENTRY , -.Nm LIST_FIRST , -.Nm LIST_FOREACH , -.\" .Nm LIST_FOREACH_FROM , -.\" .Nm LIST_FOREACH_SAFE , -.\" .Nm LIST_FOREACH_FROM_SAFE , -.Nm LIST_HEAD , -.Nm LIST_HEAD_INITIALIZER , -.Nm LIST_INIT , -.Nm LIST_INSERT_AFTER , -.Nm LIST_INSERT_BEFORE , -.Nm LIST_INSERT_HEAD , -.Nm LIST_NEXT , -.\" .Nm LIST_PREV , -.Nm LIST_REMOVE , -.\" .Nm LIST_SWAP , +LIST_EMPTY, +LIST_ENTRY, +LIST_FIRST, +LIST_FOREACH, +.\"LIST_FOREACH_FROM, +.\"LIST_FOREACH_SAFE, +.\"LIST_FOREACH_FROM_SAFE, +LIST_HEAD, +LIST_HEAD_INITIALIZER, +LIST_INIT, +LIST_INSERT_AFTER, +LIST_INSERT_BEFORE, +LIST_INSERT_HEAD, +LIST_NEXT, +LIST_PREV, +LIST_REMOVE +.\"LIST_SWAP .SH SYNOPSIS .SH DESCRIPTION .SH RETURN VALUE From patchwork Tue Oct 20 14:21:29 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40763 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id A47EB386EC26; Tue, 20 Oct 2020 14:23:28 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org A47EB386EC26 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203808; bh=ViKeHZ1z6gOV2R4Akzx5TO0bFMhi5Kxw19p5nrVj70I=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=I2XJttqZu57jtqxQ//GEYBZclskHD92WbnZ0qbV6ZAzjTXz+Ah4EK4Yeufk6Iblsw XAEbtVqD/+7o8FSCerWJmUt0sZT6JfsNOWWVLAb8AInFICTj695t1a0eBsLZc0io5R gU8bL4kyp/22/irE1f5JsMQhx7WanbuOqBwNPes4= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x42b.google.com (mail-wr1-x42b.google.com [IPv6:2a00:1450:4864:20::42b]) by sourceware.org (Postfix) with ESMTPS id EDC3639450EA for ; Tue, 20 Oct 2020 14:23:25 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org EDC3639450EA Received: by mail-wr1-x42b.google.com with SMTP id n6so2375500wrm.13 for ; Tue, 20 Oct 2020 07:23:25 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=ViKeHZ1z6gOV2R4Akzx5TO0bFMhi5Kxw19p5nrVj70I=; b=RJZ/RD4pnkufDUKRGctHX7w2cYIwXDModFg/j0u+vdmG2zmfanXsvXPsQ2wvB3jKyd 7dNUZPPU6tYAzdCOOKHwl+1CpOs+P78NX3xn1sJ2FbVXzQdZLvd5O0mXLSHxW3BzyB26 v4e59tnng1taDRZv0dHzZXuUy9i0GeUvs7/gJUb4Xcv3gNNp3CUQVboy8TuC/xxmmXhV cugbKFQ9+ao4/qTswRiGpUx0YZcpmQyS5YVu5VB42awHkXqP5b1Ro2HJOHZ2Uc2HAlwa +T9FQ837COCWCU0wo6zhyFoJdUd+385W0ECjctqRf4vtefVHMdpwhjtjQJ7OSTu2gVSw 3eaw== X-Gm-Message-State: AOAM532u7RF7wX15H5CI+AoRyjsNfFS17CPI4moER32Q2uMs1XZHe5ZF sw3CetPcUMSe6g0Rb9h9oCk= X-Google-Smtp-Source: ABdhPJzpdcocURExHnB/uWLNHrI7MfuyqtaZgtr+C96yUWscloYnY9d//LwnMCavkYh8Nh9nkVDQPQ== X-Received: by 2002:adf:eccb:: with SMTP id s11mr3876622wro.135.1603203804929; Tue, 20 Oct 2020 07:23:24 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.23 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:24 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 04/22] list.3: NAME: Add description Date: Tue, 20 Oct 2020 16:21:29 +0200 Message-Id: <20201020142146.61837-5-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.7 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 1 + 1 file changed, 1 insertion(+) diff --git a/man3/list.3 b/man3/list.3 index d26ac8971..21ea42fa4 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -48,6 +48,7 @@ LIST_NEXT, LIST_PREV, LIST_REMOVE .\"LIST_SWAP +\- implementation of a doubly-linked list .SH SYNOPSIS .SH DESCRIPTION .SH RETURN VALUE From patchwork Tue Oct 20 14:21:30 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40764 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 41CFC39450FB; Tue, 20 Oct 2020 14:23:31 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 41CFC39450FB DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203811; bh=wd40YZCEt4buQ3VMGuqHTl2tZ1LDTM8o39I+AlcQ+II=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=lNW7smz1TqgvnszTngsR6y0UUI506ayj5u6MRorY3yRYw/PHugx3zQAadv8i+wxLZ +6fEI9oKPyvDT5zC+49BeGu5g4VA+cggYm2IDim9I7aPGAMKPEDlhnQLG+TBo2fmtX nEBmf/AV1muklqcYD/hyiquS6tz/+JWrZPBUMmng= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x42c.google.com (mail-wr1-x42c.google.com [IPv6:2a00:1450:4864:20::42c]) by sourceware.org (Postfix) with ESMTPS id 22DA3386EC26 for ; Tue, 20 Oct 2020 14:23:27 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 22DA3386EC26 Received: by mail-wr1-x42c.google.com with SMTP id g12so2384129wrp.10 for ; Tue, 20 Oct 2020 07:23:27 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=wd40YZCEt4buQ3VMGuqHTl2tZ1LDTM8o39I+AlcQ+II=; b=m4f01xGkwEc0/8iDKRapIkBmfE+49A868e/Ybogc8yesptPZC3btn2nopMkW4bE+y1 I31mzPYhAEMULAMGDLMMvTixLqk1hIsy6mh5TrkL8gzh0xsBI2AbcN0XZ3V9WO2BTb1u WyEouligQ8IWpJIa7w0tstlqH2pbG2CWxWdxnmPMIvpzUqUdieFr5oTFPhZ09MNIg/eh YjrxmxBMa7VgkDxFVyCojnf+k5836P8GBI/AFDms55Ii7ofixh5OJNfWBPAT6/6h+SKf 9Iphpbb1e1l1H6SseNQXdNmhG5EtzisxL1KH5UVGbvW7+v7p8XYZVrhnZJDV8pOU4rc0 B/Ew== X-Gm-Message-State: AOAM530UhbbQPV87pXJ0WOr1jdvLd04oz5NrEtlIjQ80Lzrf+fu5v/AI 2bwdRx9cq+2nlnc8NNCxGhM= X-Google-Smtp-Source: ABdhPJw2UCPR3jIzHBLcO1tYslBOAZy9COSrDnXFOxVOWD43WcypRYbVkhOUO5HKYeTz8OySoF0zIA== X-Received: by 2002:a5d:66d2:: with SMTP id k18mr4135320wrw.229.1603203806052; Tue, 20 Oct 2020 07:23:26 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:25 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 05/22] list.3, queue.3: SYNOPSIS: Move code from queue.3 to list.3 Date: Tue, 20 Oct 2020 16:21:30 +0200 Message-Id: <20201020142146.61837-6-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, KAM_NUMSUBJECT, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP, UPPERCASE_50_75 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 18 ++++++++++++++++++ man3/queue.3 | 18 ------------------ 2 files changed, 18 insertions(+), 18 deletions(-) diff --git a/man3/list.3 b/man3/list.3 index 21ea42fa4..c43832098 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -50,6 +50,24 @@ LIST_REMOVE .\"LIST_SWAP \- implementation of a doubly-linked list .SH SYNOPSIS +.Fn LIST_EMPTY "LIST_HEAD *head" +.Fn LIST_ENTRY "TYPE" +.Fn LIST_FIRST "LIST_HEAD *head" +.Fn LIST_FOREACH "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" +.\" .Fn LIST_FOREACH_FROM "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" +.\" .Fn LIST_FOREACH_SAFE "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" "TYPE *temp_var" +.\" .Fn LIST_FOREACH_FROM_SAFE "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" "TYPE *temp_var" +.Fn LIST_HEAD "HEADNAME" "TYPE" +.Fn LIST_HEAD_INITIALIZER "LIST_HEAD head" +.Fn LIST_INIT "LIST_HEAD *head" +.Fn LIST_INSERT_AFTER "TYPE *listelm" "TYPE *elm" "LIST_ENTRY NAME" +.Fn LIST_INSERT_BEFORE "TYPE *listelm" "TYPE *elm" "LIST_ENTRY NAME" +.Fn LIST_INSERT_HEAD "LIST_HEAD *head" "TYPE *elm" "LIST_ENTRY NAME" +.Fn LIST_NEXT "TYPE *elm" "LIST_ENTRY NAME" +.\" .Fn LIST_PREV "TYPE *elm" "LIST_HEAD *head" "TYPE" "LIST_ENTRY NAME" +.Fn LIST_REMOVE "TYPE *elm" "LIST_ENTRY NAME" +.\" .Fn LIST_SWAP "LIST_HEAD *head1" "LIST_HEAD *head2" "TYPE" "LIST_ENTRY NAME" +.\" .SH DESCRIPTION .SH RETURN VALUE .SH CONFORMING TO diff --git a/man3/queue.3 b/man3/queue.3 index 17adfcf3b..a3a2eb2b0 100644 --- a/man3/queue.3 +++ b/man3/queue.3 @@ -157,24 +157,6 @@ lists, tail queues, and circular queues .Fn STAILQ_REMOVE "STAILQ_HEAD *head" "TYPE *elm" "TYPE" "STAILQ_ENTRY NAME" .\" .Fn STAILQ_SWAP "STAILQ_HEAD *head1" "STAILQ_HEAD *head2" "STAILQ_ENTRY NAME" .\" -.Fn LIST_EMPTY "LIST_HEAD *head" -.Fn LIST_ENTRY "TYPE" -.Fn LIST_FIRST "LIST_HEAD *head" -.Fn LIST_FOREACH "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" -.\" .Fn LIST_FOREACH_FROM "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" -.\" .Fn LIST_FOREACH_SAFE "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" "TYPE *temp_var" -.\" .Fn LIST_FOREACH_FROM_SAFE "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" "TYPE *temp_var" -.Fn LIST_HEAD "HEADNAME" "TYPE" -.Fn LIST_HEAD_INITIALIZER "LIST_HEAD head" -.Fn LIST_INIT "LIST_HEAD *head" -.Fn LIST_INSERT_AFTER "TYPE *listelm" "TYPE *elm" "LIST_ENTRY NAME" -.Fn LIST_INSERT_BEFORE "TYPE *listelm" "TYPE *elm" "LIST_ENTRY NAME" -.Fn LIST_INSERT_HEAD "LIST_HEAD *head" "TYPE *elm" "LIST_ENTRY NAME" -.Fn LIST_NEXT "TYPE *elm" "LIST_ENTRY NAME" -.\" .Fn LIST_PREV "TYPE *elm" "LIST_HEAD *head" "TYPE" "LIST_ENTRY NAME" -.Fn LIST_REMOVE "TYPE *elm" "LIST_ENTRY NAME" -.\" .Fn LIST_SWAP "LIST_HEAD *head1" "LIST_HEAD *head2" "TYPE" "LIST_ENTRY NAME" -.\" .Fn TAILQ_CONCAT "TAILQ_HEAD *head1" "TAILQ_HEAD *head2" "TAILQ_ENTRY NAME" .Fn TAILQ_EMPTY "TAILQ_HEAD *head" .Fn TAILQ_ENTRY "TYPE" From patchwork Tue Oct 20 14:21:31 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40765 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id CE3073947408; Tue, 20 Oct 2020 14:23:31 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org CE3073947408 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203811; bh=ooWKgXtl7+i0OdUVJrJVNZ0tTjyx5Kvg9se5OmZPWgo=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=UFttHNRvFZMSJbdbOKB/o0k1Hc2OGXj33jParhmY493AN44t+jV3hShRVgEhYOXsu lcjX3f7TU1idB3CIWylHq+xZPmlv9r8JnRlpwP+B4lUTSKtgQnWEylxGizC69OzNeF s5CergNBrVH73BwuOOmOAzeSiDK/wBafjLSsWAA4= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x42f.google.com (mail-wr1-x42f.google.com [IPv6:2a00:1450:4864:20::42f]) by sourceware.org (Postfix) with ESMTPS id 0C22539450FB for ; Tue, 20 Oct 2020 14:23:28 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 0C22539450FB Received: by mail-wr1-x42f.google.com with SMTP id n6so2375655wrm.13 for ; Tue, 20 Oct 2020 07:23:27 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=ooWKgXtl7+i0OdUVJrJVNZ0tTjyx5Kvg9se5OmZPWgo=; b=Z1bRXd7cCqubWdCzfbl6ozOVdac91sqtaEA/MmxXLKfYdR6ZzTVFSQ6ntj4pf5ilGJ z6o2eVoGP4Qit9h9B/tnA2I75s0mB9yIuSzJZgPwPlDYox/ArWZ0No5jYF1KmwfV+CS3 +Ik0qr/EejIesV4PO8KFD25+UxNawtanQiX1z2sxz/P2EHEayqHG3QdDuLknVI1iYQR9 643maG0azz8dIQvUKCxPyMXplVe5PdJI8un2t+MhmTIc1i5fb7tUXYBD8rmYLqJv20AE SYYXFcRw0HBJ/RrrQZpHoJisyLJgN0Wr8kZB5Bym6bxmTbBR6NZ3zksEbNA9aFqZboLl vK0w== X-Gm-Message-State: AOAM532O1bOuKskQgHvW7c82Z+EsbrhTNp6UuGw6k1G+5nBlHNaysRvE AEv43qDfrAnf9yy0aS2wY18= X-Google-Smtp-Source: ABdhPJxfG8Cc/Pn10CRYneMivx9RTxwlkqDxvz5X7+clJZ8WkZhfOWLUJHIYYLIvEuXehWx93SV4QA== X-Received: by 2002:a5d:424e:: with SMTP id s14mr4186223wrr.149.1603203807171; Tue, 20 Oct 2020 07:23:27 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:26 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 06/22] list.3: SYNOPSIS: Copy include from queue.3 Date: Tue, 20 Oct 2020 16:21:31 +0200 Message-Id: <20201020142146.61837-7-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.4 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, KAM_NUMSUBJECT, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 2 ++ 1 file changed, 2 insertions(+) diff --git a/man3/list.3 b/man3/list.3 index c43832098..0ea135900 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -50,6 +50,8 @@ LIST_REMOVE .\"LIST_SWAP \- implementation of a doubly-linked list .SH SYNOPSIS +.In sys/queue.h +.\" .Fn LIST_EMPTY "LIST_HEAD *head" .Fn LIST_ENTRY "TYPE" .Fn LIST_FIRST "LIST_HEAD *head" From patchwork Tue Oct 20 14:21:32 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40766 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 610EB3947412; Tue, 20 Oct 2020 14:23:32 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 610EB3947412 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203812; bh=7MaAczWTr2iQizpJfhE0y5gjIiNjIx/hVgPET9/9ego=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=Mhm19oio4zOcFTTF+BOuxqOyuf9O9en2nP1//xagtwtNYKKw64CloaPc23Y1EJFGP /G/j8OGph3luLBhgaY4UEs/qN6yT/86su2FqWPwxKCIRnq2/ECOGH1F9drVyTmW4/K sTpO5v3wskID+y3qumRhmsfpDQco5/xFihUZcsLg= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x341.google.com (mail-wm1-x341.google.com [IPv6:2a00:1450:4864:20::341]) by sourceware.org (Postfix) with ESMTPS id 1BB2E39450FF for ; Tue, 20 Oct 2020 14:23:29 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 1BB2E39450FF Received: by mail-wm1-x341.google.com with SMTP id d81so1996842wmc.1 for ; Tue, 20 Oct 2020 07:23:29 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=7MaAczWTr2iQizpJfhE0y5gjIiNjIx/hVgPET9/9ego=; b=JBHD4PHNaHmikLo6VvE2AThkp9HhdOsbfmZRaZF5FZ8kZlgbQe6S+I4z+n4siIIk1M bILpkRkwvb5iS2vtiICygXdw7rTchmRtIYOQaIrkk6ihitGuH1VyFPWEANlZarDyz0DU glH9f7orKYi0GdCGyv6rTD3HXYFsR47hzX9NJL0XZH+IdqGwMgIeOv5BbAsI3+cEWU+w oRntp3RHB9RhSFMQg5XJlEyI/EOXwrloUoRvPSdO66lR0EFoNY9F3rpgscudityM3hlO iFINNil6ryICcg6UwKfbOEkM+uebFKFB2bHrWQN3SKTqtzxayq6FagXMiwaSIfp/ZP6M FApQ== X-Gm-Message-State: AOAM530/7x50HMscw+tvnrGosixm+VvsOs4weshmj82++gDehIIuWve7 LEnaiESGHP8iiFkW8TuN72q4BCpEua8= X-Google-Smtp-Source: ABdhPJwsjpGB6iowgIFrUcKkyN3EMiaQxC7FCOuaFUgCof9G0ab86r1aseIWr5LzD/RS154Mt7LWHA== X-Received: by 2002:a1c:9641:: with SMTP id y62mr3316642wmd.145.1603203808191; Tue, 20 Oct 2020 07:23:28 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:27 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 07/22] list.3: SYNOPSIS: ffix: Use man markup Date: Tue, 20 Oct 2020 16:21:32 +0200 Message-Id: <20201020142146.61837-8-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-11.1 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP, UPPERCASE_50_75 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 57 ++++++++++++++++++++++++++++++++++------------------- 1 file changed, 37 insertions(+), 20 deletions(-) diff --git a/man3/list.3 b/man3/list.3 index 0ea135900..8af4ccfd6 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -50,26 +50,43 @@ LIST_REMOVE .\"LIST_SWAP \- implementation of a doubly-linked list .SH SYNOPSIS -.In sys/queue.h -.\" -.Fn LIST_EMPTY "LIST_HEAD *head" -.Fn LIST_ENTRY "TYPE" -.Fn LIST_FIRST "LIST_HEAD *head" -.Fn LIST_FOREACH "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" -.\" .Fn LIST_FOREACH_FROM "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" -.\" .Fn LIST_FOREACH_SAFE "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" "TYPE *temp_var" -.\" .Fn LIST_FOREACH_FROM_SAFE "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" "TYPE *temp_var" -.Fn LIST_HEAD "HEADNAME" "TYPE" -.Fn LIST_HEAD_INITIALIZER "LIST_HEAD head" -.Fn LIST_INIT "LIST_HEAD *head" -.Fn LIST_INSERT_AFTER "TYPE *listelm" "TYPE *elm" "LIST_ENTRY NAME" -.Fn LIST_INSERT_BEFORE "TYPE *listelm" "TYPE *elm" "LIST_ENTRY NAME" -.Fn LIST_INSERT_HEAD "LIST_HEAD *head" "TYPE *elm" "LIST_ENTRY NAME" -.Fn LIST_NEXT "TYPE *elm" "LIST_ENTRY NAME" -.\" .Fn LIST_PREV "TYPE *elm" "LIST_HEAD *head" "TYPE" "LIST_ENTRY NAME" -.Fn LIST_REMOVE "TYPE *elm" "LIST_ENTRY NAME" -.\" .Fn LIST_SWAP "LIST_HEAD *head1" "LIST_HEAD *head2" "TYPE" "LIST_ENTRY NAME" -.\" +.nf +.B #include +.PP +.BI "int LIST_EMPTY(LIST_HEAD *" head ");" +.PP +.B LIST_ENTRY(TYPE); +.PP +.BI "LIST_ENTRY *LIST_FIRST(LIST_HEAD *" head ");" +.PP +.BI "LIST_FOREACH(TYPE *" var ", LIST_HEAD *" head ", LIST_ENTRY " NAME ");" +.\".PP +.\".BI "LIST_FOREACH_FROM(TYPE *" var ", LIST_HEAD *" head ", LIST_ENTRY " NAME ");" +.\".PP +.\".BI "LIST_FOREACH_SAFE(TYPE *" var ", LIST_HEAD *" head ", LIST_ENTRY " NAME ", TYPE *" temp_var ");" +.\".PP +.\".BI "LIST_FOREACH_FROM_SAFE(TYPE *" var ", LIST_HEAD *" head ", LIST_ENTRY " NAME ", TYPE *" temp_var ");" +.PP +.B LIST_HEAD(HEADNAME, TYPE); +.PP +.BI "LIST_HEAD LIST_HEAD_INITIALIZER(LIST_HEAD " head ");" +.PP +.BI "void LIST_INIT(LIST_HEAD *" head ");" +.PP +.BI "void LIST_INSERT_AFTER(TYPE *" listelm ", TYPE *" elm ", LIST_ENTRY " NAME ");" +.PP +.BI "void LIST_INSERT_BEFORE(TYPE *" listelm ", TYPE *" elm ", LIST_ENTRY " NAME ");" +.PP +.BI "void LIST_INSERT_HEAD(LIST_HEAD *" head ", TYPE *" elm ", LIST_ENTRY " NAME ");" +.PP +.BI "LIST_ENTRY *LIST_NEXT(TYPE *" elm ", LIST_ENTRY " NAME ");" +.\".PP +.\".BI "LIST_ENTRY LIST_PREV(TYPE *" elm ", LIST_HEAD *" head ", TYPE, LIST_ENTRY " NAME ");" +.PP +.BI "void LIST_REMOVE(TYPE *" elm ", LIST_ENTRY " NAME ");" +.\".PP +.\".BI "void LIST_SWAP(LIST_HEAD *" head1 ", LIST_HEAD *" head2 ", TYPE, LIST_ENTRY " NAME ");" +.fi .SH DESCRIPTION .SH RETURN VALUE .SH CONFORMING TO From patchwork Tue Oct 20 14:21:33 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40767 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id E60D039450EA; Tue, 20 Oct 2020 14:23:32 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org E60D039450EA DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203813; bh=XfcudiOVnN8tR48m0R1nnMtWFkg7SaQK82NmpgnOFgw=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=XXw2Cq49SoSRirAVNPCISAa1eUqgwWiuEMTBVG9J/ntSRVuPUYQk8FklSP8Yl5Oc9 ygFx0qxjJTxp1tFchqfEVv2iTowNZcyp7Q0r48AHUjdk+0aq2kngX6s/U6pjLblEPe D/x4XZSHc0zQ9oG/+hoDovRfFSGx5dYL3KTZanFg= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x42d.google.com (mail-wr1-x42d.google.com [IPv6:2a00:1450:4864:20::42d]) by sourceware.org (Postfix) with ESMTPS id 20A7539450EA for ; Tue, 20 Oct 2020 14:23:30 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 20A7539450EA Received: by mail-wr1-x42d.google.com with SMTP id g12so2384366wrp.10 for ; Tue, 20 Oct 2020 07:23: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:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=XfcudiOVnN8tR48m0R1nnMtWFkg7SaQK82NmpgnOFgw=; b=Dcb1L9Lx9NZYmtym2RRPGJnOH+1QYkV6m7JEj2rfkFYbxqhe9c951a+t/r8ACYYur8 Q5aEwSdN10aQWddAGSZewD+BKYjNbX6gYz0GNP2zC5u8VEkikNIfVooObdqJYILllmLt +01D0YMzZf+e3NyfuRByiGpaV0erh79B+8cmRe8y72wKDsiPyT8zMbyU+yOH3zliLfBa /Zex93EMxFBFulJ1zIUW89e+oa0QUVqmFtGx0dHfd5Uqr4CfTCoQBsIIB6z5vM+0q76F MoUkfgKtbywTJjz+qq+K5+WTcy1Ozza+RGMdofNc7JARe8tehTN+ZbH0wGcgCFv/TSMD vffQ== X-Gm-Message-State: AOAM533aCOcjkoTPIzdbScR8LuA2OFb1vCQ5WqXK3nh6ewtwSqlrlTnu DeGiLMzEr1F1EATMuVI+MV4= X-Google-Smtp-Source: ABdhPJzoPpZvdU7+AcZfgs8SLpH1SOSxCR9JwTTs9fLOwQynJDRa3iDC5YdegxGQc3eTFWVjtqwtWw== X-Received: by 2002:a5d:6cad:: with SMTP id a13mr4171299wra.347.1603203809258; Tue, 20 Oct 2020 07:23:29 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.28 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:28 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 08/22] list.3: DESCRIPTION: Add short description Date: Tue, 20 Oct 2020 16:21:33 +0200 Message-Id: <20201020142146.61837-9-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.7 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 1 + 1 file changed, 1 insertion(+) diff --git a/man3/list.3 b/man3/list.3 index 8af4ccfd6..ae6590fdb 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -88,6 +88,7 @@ LIST_REMOVE .\".BI "void LIST_SWAP(LIST_HEAD *" head1 ", LIST_HEAD *" head2 ", TYPE, LIST_ENTRY " NAME ");" .fi .SH DESCRIPTION +These macros define and operate on doubly-linked lists. .SH RETURN VALUE .SH CONFORMING TO .SH BUGS From patchwork Tue Oct 20 14:21:34 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40768 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 72D2A3947426; Tue, 20 Oct 2020 14:23:34 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 72D2A3947426 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203814; bh=SKGEEHCRETwd6h9jNsjao2C3LpaBgeXwfnttqzluZKk=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=Fxi0ADqXO7d3Ol84VWpqy/BIRlzrk8D8kIlP5+ic/EhU2Pacdxziirzr94KrkatfU MuVJ86ePfXOLfkcUI8J4teeHvJ0O3Sz8oAcWzxsJXo2fAJ3kXg1xfJ9mzsYjwxyQnW FZ507zIF+mRJsiUV6bTsR0dZcUFl96yg3Nlv5xKk= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x342.google.com (mail-wm1-x342.google.com [IPv6:2a00:1450:4864:20::342]) by sourceware.org (Postfix) with ESMTPS id 545983945C34 for ; Tue, 20 Oct 2020 14:23:31 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 545983945C34 Received: by mail-wm1-x342.google.com with SMTP id c77so1994610wmd.4 for ; Tue, 20 Oct 2020 07:23:31 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=SKGEEHCRETwd6h9jNsjao2C3LpaBgeXwfnttqzluZKk=; b=Y0VVIIJFCR6HTndEWO+Ud6qUbCRsuSpeubrFquSzZwMCJC+B8+DnymAXtN0YX2s/xq 9Tn6025obWHub9SyYgntTqT/yy3coIbQxIc4pB20P8qkf2xdSnicrDhyBOuYzYt9lY6B P9JAkPkxVIL0SHvOnf0UssgwI2lwdAXF6mP6IqNyUoFrqEWeUR3lgcDRD5IoHqg2GRR6 G7KbiDxHT3raWB0UIIz/a8M9zvLXXdaUQShOy6382PsCSslzajiAkTGzvFoFqGPNvTkx yRyIMPh/wAbMI23aV+vn4cuXjKCd6NCnbd6lhbTQdlquwK/jKsUR314kZ9jGPs/LQU1f W3Jg== X-Gm-Message-State: AOAM532uOoFOv9hC/1cUjmJa6GOizfDjgZisCkCYDpgw1NNI6mrfgCSa QBCmawygEB+aNXq5G0yWfKM= X-Google-Smtp-Source: ABdhPJxneIawtY0N8DW/IbZjb4gefRtY91q5cG69/myfRtMsbq46JSxvP6j+C5gvT7zFj/OZb+aoCg== X-Received: by 2002:a1c:b402:: with SMTP id d2mr3397761wmf.128.1603203810287; Tue, 20 Oct 2020 07:23:30 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.29 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:29 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 09/22] list.3: DESCRIPTION: Copy description about naming of macros from queue.3 Date: Tue, 20 Oct 2020 16:21:34 +0200 Message-Id: <20201020142146.61837-10-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.5 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, KAM_NUMSUBJECT, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/man3/list.3 b/man3/list.3 index ae6590fdb..70f32a384 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -89,6 +89,31 @@ LIST_REMOVE .fi .SH DESCRIPTION These macros define and operate on doubly-linked lists. +.Pp +In the macro definitions, +.Fa TYPE +is the name of a user defined structure, +that must contain a field of type +.Li SLIST_ENTRY , +.Li STAILQ_ENTRY , +.Li LIST_ENTRY , +.Li TAILQ_ENTRY , +or +.Li CIRCLEQ_ENTRY , +named +.Fa NAME . +The argument +.Fa HEADNAME +is the name of a user defined structure that must be declared +using the macros +.Li SLIST_HEAD , +.Li STAILQ_HEAD , +.Li LIST_HEAD , +.Li TAILQ_HEAD , +or +.Li CIRCLEQ_HEAD . +See the examples below for further explanation of how these +macros are used. .SH RETURN VALUE .SH CONFORMING TO .SH BUGS From patchwork Tue Oct 20 14:21:35 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40769 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id F23E83947438; Tue, 20 Oct 2020 14:23:34 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org F23E83947438 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203815; bh=lP/FsuDDH96aMTRTyc8ODTQex6+vb7BeI4gGK26Xg24=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=rn8X3NFgifF1IvEak1VCQfxuNNH+uc3EO8pKsKF6VwFLwLvAPvXvYb9uFuatMLm4+ BD2S96f5H6EMBB0cn/2SNCdDuxangvsGw+bFzFgBrBwApoyZKRxV1g6v+dOsxvnWWt VPgORSSXtzCeEalOPeZXgZVbiX72eGzeTxdAl3rw= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x342.google.com (mail-wm1-x342.google.com [IPv6:2a00:1450:4864:20::342]) by sourceware.org (Postfix) with ESMTPS id 68FF33947417 for ; Tue, 20 Oct 2020 14:23:32 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 68FF33947417 Received: by mail-wm1-x342.google.com with SMTP id d81so1997048wmc.1 for ; Tue, 20 Oct 2020 07:23:32 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=lP/FsuDDH96aMTRTyc8ODTQex6+vb7BeI4gGK26Xg24=; b=DM1Wt1SuebS+9T1SIIs5vVWM6EbkGIj/J8w27RjHlzeoOspH6EtNTMJOo5svYRtSEL Rg5E7QR5+pkO7sb80utRIdxAg34clWuifIwcaj5IPwcfVBD8MZ8FiivPCnnRHbtkU2vH ULprQudBAL8WpSLQH/4HanxKgFRfRdbYPwBuNhsyl05i/y4TWvx3tXY2YUxV/cyvu73Y mIklPWiNIGjCB8rdAIjyXTZo7Iae+2srD4rzc8mycty3qFANcioV/SOdES31szA4id3X 0zHopCTZHHg9yPJcL4dfC24zxG7oDI4onmLilgh5KOoIrG4CrUjQ9fBEu+yKB4HLjKP7 fhaQ== X-Gm-Message-State: AOAM532Xgi1Nr5joG/DAxAPsr1dbVBVPX4f1QdZBt5W79NSoZwR8Pi5Z orfG5cgdl36tiImrUm0Qzuaf+ppax6c= X-Google-Smtp-Source: ABdhPJw84VyWAgkE3WZnq7g1I8Y1MrMdQKibYlj/AWrvdBJQbtmw5X2tDxi8TpkaISNAbjFpzUqtjQ== X-Received: by 2002:a1c:7c09:: with SMTP id x9mr3259504wmc.181.1603203811390; Tue, 20 Oct 2020 07:23:31 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.30 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:30 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 10/22] list.3: DESCRIPTION: Remove unrelated code to adapt to this page Date: Tue, 20 Oct 2020 16:21:35 +0200 Message-Id: <20201020142146.61837-11-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.7 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 16 ++-------------- 1 file changed, 2 insertions(+), 14 deletions(-) diff --git a/man3/list.3 b/man3/list.3 index 70f32a384..36d259a63 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -94,26 +94,14 @@ In the macro definitions, .Fa TYPE is the name of a user defined structure, that must contain a field of type -.Li SLIST_ENTRY , -.Li STAILQ_ENTRY , .Li LIST_ENTRY , -.Li TAILQ_ENTRY , -or -.Li CIRCLEQ_ENTRY , named .Fa NAME . The argument .Fa HEADNAME is the name of a user defined structure that must be declared -using the macros -.Li SLIST_HEAD , -.Li STAILQ_HEAD , -.Li LIST_HEAD , -.Li TAILQ_HEAD , -or -.Li CIRCLEQ_HEAD . -See the examples below for further explanation of how these -macros are used. +using the macro +.Fa LIST_HEAD . .SH RETURN VALUE .SH CONFORMING TO .SH BUGS From patchwork Tue Oct 20 14:21:36 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40770 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 04C443947425; Tue, 20 Oct 2020 14:23:38 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 04C443947425 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203818; bh=qBm/ZsIoaiz1dxV2J1/u99PDeY4Rj3aAFqbDCREEpA0=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=EMFz0p1WcERgRTwql5mAro08hRYZHC+RanS16Tiv9OHF4U/TgNHL7xPwmi+UC+Y3n CG0ueHazXElYk5CbAxats38v9gn80iDneruRmy5RgWFHyxV8G5wqVkpIqzatY1iMY8 aY0QWsalAQzuj4+2H0OotSiNNijGovN0+ymTLU/U= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x443.google.com (mail-wr1-x443.google.com [IPv6:2a00:1450:4864:20::443]) by sourceware.org (Postfix) with ESMTPS id 79DD13947425 for ; Tue, 20 Oct 2020 14:23:33 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 79DD13947425 Received: by mail-wr1-x443.google.com with SMTP id n15so2408634wrq.2 for ; Tue, 20 Oct 2020 07:23:33 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=qBm/ZsIoaiz1dxV2J1/u99PDeY4Rj3aAFqbDCREEpA0=; b=K16vnjUDUv89fo585cvEfjkUpEpJxDGJ8AhV2xJUCWZPONvUDm3whdzrnr4LRndhzG uQ9THG7J12jngVTLi5cQzOg1+PClA3fP3bjV/9ck943aeCRKVG948T/LNxUEpJ/jz5ba ATb/aSAW3ONlERz5z1fEw0b89Ppzu7dopfskupB+y9G6BL/8xqYsrbFCuzR0zNNN+fuP KNf4JiSjhaSGZSf/dFbfIUPyzUIZHuhJgS+6W9l0yA5YAidq/x7z8fyS+5U8iLJPNXq8 nYrA6Jsa0g19JhCmmgqAzPhVK2u5qILjyN+TPyyC7nBTlyWbxbR16VX194zGtL0KF9yc Bfuw== X-Gm-Message-State: AOAM532ETyDiGDYGdbQ8z6yYwTXM/oOyTdRz3RA5qhQJtF/Kw23IeIu3 S6LfHKwcin+kzlFUKnpBAQg= X-Google-Smtp-Source: ABdhPJxf/LN8565qmVm8r7109jdbLavnUBOIOXW01oCbjJVMgBUl2Y6lAhcPhiE71GO0Tk6+hwFjyg== X-Received: by 2002:adf:f643:: with SMTP id x3mr4091632wrp.180.1603203812485; Tue, 20 Oct 2020 07:23:32 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.31 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:31 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 11/22] list.3: DESCRIPTION: ffix: Use man markup Date: Tue, 20 Oct 2020 16:21:36 +0200 Message-Id: <20201020142146.61837-12-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.7 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/man3/list.3 b/man3/list.3 index 36d259a63..39c1d4b4d 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -89,19 +89,19 @@ LIST_REMOVE .fi .SH DESCRIPTION These macros define and operate on doubly-linked lists. -.Pp +.PP In the macro definitions, -.Fa TYPE +.I TYPE is the name of a user defined structure, that must contain a field of type -.Li LIST_ENTRY , +.IR LIST_ENTRY , named -.Fa NAME . +.IR NAME . The argument -.Fa HEADNAME +.IR HEADNAME is the name of a user defined structure that must be declared using the macro -.Fa LIST_HEAD . +.BR LIST_HEAD (). .SH RETURN VALUE .SH CONFORMING TO .SH BUGS From patchwork Tue Oct 20 14:21:37 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40771 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 8DFD53947C0B; Tue, 20 Oct 2020 14:23:38 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 8DFD53947C0B DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203818; bh=XXbV8x4rTJVWp7J7xRBWcjUnxSpAt274PYLZDv/yEyM=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=D7/AUGISljyNPZClI7XayKE+nrNekcsCLlk0arSYIMY010MU1WbVOZnfGCQjJmkni +O2FaFNb4NJ1aBtuiMzsPth579eSEGNKKuOf81AsJfLuSwrIK0iHOm5j9284812Hmb U7kP9+oo8Yt0i59dRH4JyEQE6vlnkfTAYimxpHD8= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x433.google.com (mail-wr1-x433.google.com [IPv6:2a00:1450:4864:20::433]) by sourceware.org (Postfix) with ESMTPS id A9E4C3947425 for ; Tue, 20 Oct 2020 14:23:34 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org A9E4C3947425 Received: by mail-wr1-x433.google.com with SMTP id h5so2385860wrv.7 for ; Tue, 20 Oct 2020 07:23:34 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=XXbV8x4rTJVWp7J7xRBWcjUnxSpAt274PYLZDv/yEyM=; b=c/LMSz4FAn6d43AE9spKSwZDosgOX3GBZYbHckGu410HBkcuTf2czKmqYHCK19HypI jTF2Gvaps2B4mX/EYvlXf2wzP7MaOrizedBImcNWJZmNFEkB0QDoZjPvba2tgi1IslgY jKcu40tNKiBswS5+TN4YZJKhIAFOoWBfxMxw/OOePRccrBZqBOxGBIQc/rReMX7p7l9G 7jCjEqnbQ4AGJNL2BATyzu6tnf642ORCsHsKehXMynq+Nda2pp6jIn5fyh5qKzDnAJol pQXdgulbZd/iRzwJWls7lNnC5IPiTJqJ8ftuSyZU1+k8qH0OSlHkPih7VdBE9W9HfFNf 1RaQ== X-Gm-Message-State: AOAM53033TcVHqf9HsTke9HAgb8mlXxZYeAvsiZuC4SEENUwzkSGcSAJ Dg+ENO7+IFfYKaOg/S7chps/W1Ig66I= X-Google-Smtp-Source: ABdhPJydNIk9SfmwODGcUAGdEc1FlWYn+chhnjusXgympVsRi4s89ENUdhzo47eEUQLECGOg/ZlLzg== X-Received: by 2002:adf:ce8a:: with SMTP id r10mr4045455wrn.188.1603203813593; Tue, 20 Oct 2020 07:23:33 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.32 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:33 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 12/22] list.3, queue.3: DESCRIPTION: Move list specific code from queue.3 to list.3 Date: Tue, 20 Oct 2020 16:21:37 +0200 Message-Id: <20201020142146.61837-13-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.5 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, KAM_NUMSUBJECT, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 149 +++++++++++++++++++++++++++++++++++++++++++++++++++ man3/queue.3 | 149 --------------------------------------------------- 2 files changed, 149 insertions(+), 149 deletions(-) diff --git a/man3/list.3 b/man3/list.3 index 39c1d4b4d..3c25b3e55 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -102,6 +102,155 @@ The argument is the name of a user defined structure that must be declared using the macro .BR LIST_HEAD (). +.Ss Lists +A list is headed by a structure defined by the +.Nm LIST_HEAD +macro. +This structure contains a single pointer to the first element +on the list. +The elements are doubly linked so that an arbitrary element can be +removed without traversing the list. +New elements can be added to the list after an existing element, +before an existing element, or at the head of the list. +A +.Fa LIST_HEAD +structure is declared as follows: +.Bd -literal -offset indent +LIST_HEAD(HEADNAME, TYPE) head; +.Ed +.Pp +where +.Fa HEADNAME +is the name of the structure to be defined, and +.Fa TYPE +is the type of the elements to be linked into the list. +A pointer to the head of the list can later be declared as: +.Bd -literal -offset indent +struct HEADNAME *headp; +.Ed +.Pp +(The names +.Li head +and +.Li headp +are user selectable.) +.Pp +The macro +.Nm LIST_HEAD_INITIALIZER +evaluates to an initializer for the list +.Fa head . +.Pp +The macro +.Nm LIST_EMPTY +evaluates to true if there are no elements in the list. +.Pp +The macro +.Nm LIST_ENTRY +declares a structure that connects the elements in +the list. +.Pp +The macro +.Nm LIST_FIRST +returns the first element in the list or NULL if the list +is empty. +.Pp +The macro +.Nm LIST_FOREACH +traverses the list referenced by +.Fa head +in the forward direction, assigning each element in turn to +.Fa var . +.\" .Pp +.\" The macro +.\" .Nm LIST_FOREACH_FROM +.\" behaves identically to +.\" .Nm LIST_FOREACH +.\" when +.\" .Fa var +.\" is NULL, else it treats +.\" .Fa var +.\" as a previously found LIST element and begins the loop at +.\" .Fa var +.\" instead of the first element in the LIST referenced by +.\" .Fa head . +.\" .Pp +.\" The macro +.\" .Nm LIST_FOREACH_SAFE +.\" traverses the list referenced by +.\" .Fa head +.\" in the forward direction, assigning each element in turn to +.\" .Fa var . +.\" However, unlike +.\" .Fn LIST_FOREACH +.\" here it is permitted to both remove +.\" .Fa var +.\" as well as free it from within the loop safely without interfering with the +.\" traversal. +.\" .Pp +.\" The macro +.\" .Nm LIST_FOREACH_FROM_SAFE +.\" behaves identically to +.\" .Nm LIST_FOREACH_SAFE +.\" when +.\" .Fa var +.\" is NULL, else it treats +.\" .Fa var +.\" as a previously found LIST element and begins the loop at +.\" .Fa var +.\" instead of the first element in the LIST referenced by +.\" .Fa head . +.Pp +The macro +.Nm LIST_INIT +initializes the list referenced by +.Fa head . +.Pp +The macro +.Nm LIST_INSERT_HEAD +inserts the new element +.Fa elm +at the head of the list. +.Pp +The macro +.Nm LIST_INSERT_AFTER +inserts the new element +.Fa elm +after the element +.Fa listelm . +.Pp +The macro +.Nm LIST_INSERT_BEFORE +inserts the new element +.Fa elm +before the element +.Fa listelm . +.Pp +The macro +.Nm LIST_NEXT +returns the next element in the list, or NULL if this is the last. +.\" .Pp +.\" The macro +.\" .Nm LIST_PREV +.\" returns the previous element in the list, or NULL if this is the first. +.\" List +.\" .Fa head +.\" must contain element +.\" .Fa elm . +.Pp +The macro +.Nm LIST_REMOVE +removes the element +.Fa elm +from the list. +.\" .Pp +.\" The macro +.\" .Nm LIST_SWAP +.\" swaps the contents of +.\" .Fa head1 +.\" and +.\" .Fa head2 . +.Pp +See the EXAMPLES section below for an example program using a linked list. .SH RETURN VALUE .SH CONFORMING TO .SH BUGS diff --git a/man3/queue.3 b/man3/queue.3 index a3a2eb2b0..6ee793e25 100644 --- a/man3/queue.3 +++ b/man3/queue.3 @@ -689,155 +689,6 @@ from the tail queue. .Pp See the EXAMPLES section below for an example program using a singly-linked tail queue. -.Ss Lists -A list is headed by a structure defined by the -.Nm LIST_HEAD -macro. -This structure contains a single pointer to the first element -on the list. -The elements are doubly linked so that an arbitrary element can be -removed without traversing the list. -New elements can be added to the list after an existing element, -before an existing element, or at the head of the list. -A -.Fa LIST_HEAD -structure is declared as follows: -.Bd -literal -offset indent -LIST_HEAD(HEADNAME, TYPE) head; -.Ed -.Pp -where -.Fa HEADNAME -is the name of the structure to be defined, and -.Fa TYPE -is the type of the elements to be linked into the list. -A pointer to the head of the list can later be declared as: -.Bd -literal -offset indent -struct HEADNAME *headp; -.Ed -.Pp -(The names -.Li head -and -.Li headp -are user selectable.) -.Pp -The macro -.Nm LIST_HEAD_INITIALIZER -evaluates to an initializer for the list -.Fa head . -.Pp -The macro -.Nm LIST_EMPTY -evaluates to true if there are no elements in the list. -.Pp -The macro -.Nm LIST_ENTRY -declares a structure that connects the elements in -the list. -.Pp -The macro -.Nm LIST_FIRST -returns the first element in the list or NULL if the list -is empty. -.Pp -The macro -.Nm LIST_FOREACH -traverses the list referenced by -.Fa head -in the forward direction, assigning each element in turn to -.Fa var . -.\" .Pp -.\" The macro -.\" .Nm LIST_FOREACH_FROM -.\" behaves identically to -.\" .Nm LIST_FOREACH -.\" when -.\" .Fa var -.\" is NULL, else it treats -.\" .Fa var -.\" as a previously found LIST element and begins the loop at -.\" .Fa var -.\" instead of the first element in the LIST referenced by -.\" .Fa head . -.\" .Pp -.\" The macro -.\" .Nm LIST_FOREACH_SAFE -.\" traverses the list referenced by -.\" .Fa head -.\" in the forward direction, assigning each element in turn to -.\" .Fa var . -.\" However, unlike -.\" .Fn LIST_FOREACH -.\" here it is permitted to both remove -.\" .Fa var -.\" as well as free it from within the loop safely without interfering with the -.\" traversal. -.\" .Pp -.\" The macro -.\" .Nm LIST_FOREACH_FROM_SAFE -.\" behaves identically to -.\" .Nm LIST_FOREACH_SAFE -.\" when -.\" .Fa var -.\" is NULL, else it treats -.\" .Fa var -.\" as a previously found LIST element and begins the loop at -.\" .Fa var -.\" instead of the first element in the LIST referenced by -.\" .Fa head . -.Pp -The macro -.Nm LIST_INIT -initializes the list referenced by -.Fa head . -.Pp -The macro -.Nm LIST_INSERT_HEAD -inserts the new element -.Fa elm -at the head of the list. -.Pp -The macro -.Nm LIST_INSERT_AFTER -inserts the new element -.Fa elm -after the element -.Fa listelm . -.Pp -The macro -.Nm LIST_INSERT_BEFORE -inserts the new element -.Fa elm -before the element -.Fa listelm . -.Pp -The macro -.Nm LIST_NEXT -returns the next element in the list, or NULL if this is the last. -.\" .Pp -.\" The macro -.\" .Nm LIST_PREV -.\" returns the previous element in the list, or NULL if this is the first. -.\" List -.\" .Fa head -.\" must contain element -.\" .Fa elm . -.Pp -The macro -.Nm LIST_REMOVE -removes the element -.Fa elm -from the list. -.\" .Pp -.\" The macro -.\" .Nm LIST_SWAP -.\" swaps the contents of -.\" .Fa head1 -.\" and -.\" .Fa head2 . -.Pp -See the EXAMPLES section below for an example program using a linked list. .Ss Tail queues A tail queue is headed by a structure defined by the .Nm TAILQ_HEAD From patchwork Tue Oct 20 14:21:38 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40772 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id BC1D43948495; Tue, 20 Oct 2020 14:23:39 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org BC1D43948495 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203819; bh=sYyqCojHCwoa05BbXg/wOATj1nIXJ99/p180jGPHtFE=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=d22C9xes1bHPbJsse6CrztxoLQ9bdZ/Gg7ddMMl1ZwPxBm4UWc4NxfQKXwa5ic6gI 0ccJA2bdjtIEk8+J01LgpTaMvfu+QGWauQZ/Q3oOt4+vmIOH0deh0czT5kHWBNL4A/ ZhSHX+nJyXQwjEcewrc0nfDcGk2EZq+gY08P0/yU= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x444.google.com (mail-wr1-x444.google.com [IPv6:2a00:1450:4864:20::444]) by sourceware.org (Postfix) with ESMTPS id C0F623947407 for ; Tue, 20 Oct 2020 14:23:35 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org C0F623947407 Received: by mail-wr1-x444.google.com with SMTP id s9so2387512wro.8 for ; Tue, 20 Oct 2020 07:23:35 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=sYyqCojHCwoa05BbXg/wOATj1nIXJ99/p180jGPHtFE=; b=UMDIt0ZBDD/tzJqPt514ArpOeIaWMsVxfG6pyJL9Xggarh/xSQXk3+HEXIOpT+ya/m Yp2mgSTu5uRhxBf/qLFjv9piN6W+XbUpJ94XoI+HfH5DOXWJ2ylpHCJ6ha9j5dEDyMop S2+kqVVUt/IMUsAVK92UEQGYTotHaCt4eXd4OWmyrqSlCs8XNOP1Wn5/W6zAJ2q4afRo a8rq7W2MOgWcsOZ5InxwSmNILSL6wycpmm6wMM/f80QdcTsJZyqXXKPHsf77C8vRu0JY atdBShOIRcIJMU9ggP7F7/77wFfLaKkgxGAP0AetJ6y07Axx/x5E6bAbd+1GtNqAvgXc T2qw== X-Gm-Message-State: AOAM533SBzSGuFyFWjjJ36NTaEz2QDehu7Z6jEr2h+81wh5tlv7g7CTk PtK1xIXEok3uWskz1LfGJtY= X-Google-Smtp-Source: ABdhPJxUX69B8ryCORJLEiUHrZu8nL012bHbuwCMriZ4XIs2M7cm4fyeI6cnfNsJxneDM96VmYki7Q== X-Received: by 2002:adf:fac4:: with SMTP id a4mr4120790wrs.172.1603203814701; Tue, 20 Oct 2020 07:23:34 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:34 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 13/22] list.3: DESCRIPTION: ffix: Use man markup Date: Tue, 20 Oct 2020 16:21:38 +0200 Message-Id: <20201020142146.61837-14-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 154 +++++++++++++++++++++++++++------------------------- 1 file changed, 80 insertions(+), 74 deletions(-) diff --git a/man3/list.3 b/man3/list.3 index 3c25b3e55..5b2a72fdb 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -102,9 +102,9 @@ The argument is the name of a user defined structure that must be declared using the macro .BR LIST_HEAD (). -.Ss Lists +.PP A list is headed by a structure defined by the -.Nm LIST_HEAD +.BR LIST_HEAD () macro. This structure contains a single pointer to the first element on the list. @@ -113,143 +113,149 @@ removed without traversing the list. New elements can be added to the list after an existing element, before an existing element, or at the head of the list. A -.Fa LIST_HEAD +.I LIST_HEAD structure is declared as follows: -.Bd -literal -offset indent +.PP +.in +4 +.EX LIST_HEAD(HEADNAME, TYPE) head; -.Ed -.Pp +.EE +.in +.PP where -.Fa HEADNAME +.I HEADNAME is the name of the structure to be defined, and -.Fa TYPE +.I TYPE is the type of the elements to be linked into the list. A pointer to the head of the list can later be declared as: -.Bd -literal -offset indent +.PP +.in +4 +.EX struct HEADNAME *headp; -.Ed -.Pp +.EE +.in +.PP (The names -.Li head +.I head and -.Li headp +.I headp are user selectable.) -.Pp +.PP The macro -.Nm LIST_HEAD_INITIALIZER +.BR LIST_HEAD_INITIALIZER () evaluates to an initializer for the list -.Fa head . -.Pp +.IR head . +.PP The macro -.Nm LIST_EMPTY +.BR LIST_EMPTY () evaluates to true if there are no elements in the list. -.Pp +.PP The macro -.Nm LIST_ENTRY +.BR LIST_ENTRY () declares a structure that connects the elements in the list. -.Pp +.PP The macro -.Nm LIST_FIRST +.BR LIST_FIRST () returns the first element in the list or NULL if the list is empty. -.Pp +.PP The macro -.Nm LIST_FOREACH +.BR LIST_FOREACH () traverses the list referenced by -.Fa head +.I head in the forward direction, assigning each element in turn to -.Fa var . -.\" .Pp +.IR var . +.\" .PP .\" The macro -.\" .Nm LIST_FOREACH_FROM +.\" .BR LIST_FOREACH_FROM () .\" behaves identically to -.\" .Nm LIST_FOREACH +.\" .BR LIST_FOREACH () .\" when -.\" .Fa var +.\" .I var .\" is NULL, else it treats -.\" .Fa var +.\" .I var .\" as a previously found LIST element and begins the loop at -.\" .Fa var +.\" .I var .\" instead of the first element in the LIST referenced by -.\" .Fa head . -.\" .Pp +.\" .IR head . +.\" .PP .\" The macro -.\" .Nm LIST_FOREACH_SAFE +.\" .BR LIST_FOREACH_SAFE () .\" traverses the list referenced by -.\" .Fa head +.\" .I head .\" in the forward direction, assigning each element in turn to -.\" .Fa var . +.\" .IR var . .\" However, unlike -.\" .Fn LIST_FOREACH +.\" .BR LIST_FOREACH () .\" here it is permitted to both remove -.\" .Fa var +.\" .I var .\" as well as free it from within the loop safely without interfering with the .\" traversal. -.\" .Pp +.\" .PP .\" The macro -.\" .Nm LIST_FOREACH_FROM_SAFE +.\" .BR LIST_FOREACH_FROM_SAFE () .\" behaves identically to -.\" .Nm LIST_FOREACH_SAFE +.\" .BR LIST_FOREACH_SAFE () .\" when -.\" .Fa var +.\" .I var .\" is NULL, else it treats -.\" .Fa var +.\" .I var .\" as a previously found LIST element and begins the loop at -.\" .Fa var +.\" .I var .\" instead of the first element in the LIST referenced by -.\" .Fa head . -.Pp +.\" .IR head . +.PP The macro -.Nm LIST_INIT +.BR LIST_INIT () initializes the list referenced by -.Fa head . -.Pp +.IR head . +.PP The macro -.Nm LIST_INSERT_HEAD +.BR LIST_INSERT_HEAD () inserts the new element -.Fa elm +.I elm at the head of the list. -.Pp +.PP The macro -.Nm LIST_INSERT_AFTER +.BR LIST_INSERT_AFTER () inserts the new element -.Fa elm +.I elm after the element -.Fa listelm . -.Pp +.IR listelm . +.PP The macro -.Nm LIST_INSERT_BEFORE +.BR LIST_INSERT_BEFORE () inserts the new element -.Fa elm +.I elm before the element -.Fa listelm . -.Pp +.IR listelm . +.PP The macro -.Nm LIST_NEXT +.BR LIST_NEXT () returns the next element in the list, or NULL if this is the last. -.\" .Pp +.\" .PP .\" The macro -.\" .Nm LIST_PREV +.\" .BR LIST_PREV () .\" returns the previous element in the list, or NULL if this is the first. .\" List -.\" .Fa head +.\" .I head .\" must contain element -.\" .Fa elm . -.Pp +.\" .IR elm . +.PP The macro -.Nm LIST_REMOVE +.BR LIST_REMOVE () removes the element -.Fa elm +.I elm from the list. -.\" .Pp +.\" .PP .\" The macro -.\" .Nm LIST_SWAP +.\" .BR LIST_SWAP () .\" swaps the contents of -.\" .Fa head1 +.\" .I head1 .\" and -.\" .Fa head2 . -.Pp +.\" .IR head2 . +.PP See the EXAMPLES section below for an example program using a linked list. .SH RETURN VALUE .SH CONFORMING TO From patchwork Tue Oct 20 14:21:39 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40773 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 4D9EA3947437; Tue, 20 Oct 2020 14:23:40 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 4D9EA3947437 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203820; bh=ctXdjrzJlVHvsEsqybh2PQrneHNCl16T2yG++nEQNtg=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=duF6MIkeTLfQ1/dOeOkL/RyWhM0jWpvcjbi8jGTGZWOig3wOB9Wfd6FdOrlKQyIN6 lYuhHOY//oNN5lYfvV7EFqTPvYaKJ7lyXRWvJCU/hOtb/tja8Ou3MblVCI1PiKICY0 zp43Mv7omUHUm7tQB8+X5y9W+533gmAdN+eMNT98= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x442.google.com (mail-wr1-x442.google.com [IPv6:2a00:1450:4864:20::442]) by sourceware.org (Postfix) with ESMTPS id B54053947425 for ; Tue, 20 Oct 2020 14:23:36 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org B54053947425 Received: by mail-wr1-x442.google.com with SMTP id x7so2406991wrl.3 for ; Tue, 20 Oct 2020 07:23:36 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=ctXdjrzJlVHvsEsqybh2PQrneHNCl16T2yG++nEQNtg=; b=Til/5ZOgme3pk8e0kIg4Lcc6cK9+e/CNo4vi1scqbsNScZ2RfwiskR0mqi/7x6jrOP u3G7C13caWrSeL9ZYJy9B7MI/53kz35KP0iDNcWOmWjFOxJpgSIm0toGq6Mn+/S2NsU+ NBlUyxPC3PB6YVuYs5C1XVuHM7IRV8H3yKuhFCzpF3ihKfmopc8PfMs+Ow+cSyYdvYaL kfNyAPAG6fGJK3N48c3PMMrJ+xhKjCM2DI2jrNF7AVVmz15i/MsdYXv0Ic4qTh6PFuIq wPBYzM765ECjJqxPOLXzxBr8Jbn0eamDmmv7FhYgkMRNYGHDPBCg74mqinLmXE549Fm3 2jXg== X-Gm-Message-State: AOAM531zE7Y0NXmew4ZFz/JVmWn4CbUJBCMVXoafURJ0hqzt85vfsfw3 6cisMPjinIU83eDDX+kUBx7p9vXHK3Y= X-Google-Smtp-Source: ABdhPJwg9eHpMwWRLfjxr7I9vyNHviZ3VvoCQ7Y33yLCzs9QnuM6nSx5jXsqbVPIL4giLact2zshag== X-Received: by 2002:adf:e849:: with SMTP id d9mr4146707wrn.25.1603203815713; Tue, 20 Oct 2020 07:23:35 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.34 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:35 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 14/22] list.3: DESCRIPTION: Remove line pointing to the EXAMPLES Date: Tue, 20 Oct 2020 16:21:39 +0200 Message-Id: <20201020142146.61837-15-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 2 -- 1 file changed, 2 deletions(-) diff --git a/man3/list.3 b/man3/list.3 index 5b2a72fdb..71b35c26d 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -255,8 +255,6 @@ from the list. .\" .I head1 .\" and .\" .IR head2 . -.PP -See the EXAMPLES section below for an example program using a linked list. .SH RETURN VALUE .SH CONFORMING TO .SH BUGS From patchwork Tue Oct 20 14:21:40 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40774 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id D7C673948A51; Tue, 20 Oct 2020 14:23:40 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org D7C673948A51 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203820; bh=zgvBKoSAae6k8dLA6L3ClK7mZIjOwQuSBwZd1G0z1eI=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=Y7a1dcxpemKJsgPD4XebFcOdeNPE2N/8SH1sePd2t2G2D7WiX8e7ljAC2qGL6yqO9 TuUSLrH/nRgHHbONTBDWpDmZbYKwWBJGSfZjgwSMKMmqC9xsUnYsdF1ly7wO8MKTa+ Zc8xRsSL+dfFfC7razWV2JRP/OxuZ3GyFkIWsV5o= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x342.google.com (mail-wm1-x342.google.com [IPv6:2a00:1450:4864:20::342]) by sourceware.org (Postfix) with ESMTPS id C7E7F3947437 for ; Tue, 20 Oct 2020 14:23:37 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org C7E7F3947437 Received: by mail-wm1-x342.google.com with SMTP id c16so2126593wmd.2 for ; Tue, 20 Oct 2020 07:23:37 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=zgvBKoSAae6k8dLA6L3ClK7mZIjOwQuSBwZd1G0z1eI=; b=NKSnfKi32siY+hfAPY4IdovXzHJyx9F6aKNxqGjp9Y9ZEw1vhK6sAMOWSCGvugpjXd 3Mkrg5UDPNtOu9tElwlJYUaUuPjRSj8GHtCNTR8IxvNpDQHK/0r3vPBR1v4LMk4yIbRO 89f6PPvGl+pC0K/WnIeTomuz5LcaeN/Yxm62OHKXlE05TKL7jsnTHk0sUBUmu4U+6qxr iv8jw1Tb8ZoRvHgxrsw6iZhqeBdx/1Xa4muIC3vOaLKYhkIapaW2Xv8/Z/yC3kBFGpbt 6YNJdaFFFh5+G7O87cTBWObUVCGOJldg5/z+dRCXyAdBZUAc+LLWGgfljVJCN+Phe0rV USVg== X-Gm-Message-State: AOAM5315IxeoKJcJs/XzatHG81yb6psBZ4I8pFi4T8qKBhvzzIHkb/rb 6nNbnrfEBrqF+dUpcYqfVMQ= X-Google-Smtp-Source: ABdhPJw/xHWGB9oeYBqngipHqFoicF0SItBAl5z+vZuw4Asa3RLPLI+Tgyrxgq3TyhjxILe4itYFoA== X-Received: by 2002:a05:600c:1149:: with SMTP id z9mr3475353wmz.180.1603203816827; Tue, 20 Oct 2020 07:23:36 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:36 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 15/22] list.3: CONFORMING TO: Copy from queue.3 Date: Tue, 20 Oct 2020 16:21:40 +0200 Message-Id: <20201020142146.61837-16-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.5 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, KAM_NUMSUBJECT, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/man3/list.3 b/man3/list.3 index 71b35c26d..64f94197a 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -257,6 +257,11 @@ from the list. .\" .IR head2 . .SH RETURN VALUE .SH CONFORMING TO +Not in POSIX.1, POSIX.1-2001 or POSIX.1-2008. +Present on the BSDs. +.Nm queue +functions first appeared in +.Bx 4.4 . .SH BUGS .SH EXAMPLES .SH SEE ALSO From patchwork Tue Oct 20 14:21:41 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40775 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 6AC443948D95; Tue, 20 Oct 2020 14:23:41 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 6AC443948D95 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203821; bh=pPKuMBiv52/bvg9lIGM3tBEPqf6hoRrTZs/pqh82PCM=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=w0RdInaQDxRjNxsZ2d7a+7ra1GWM8rLOqmHyPX+sf2YEfYPkrfbAXUIt1Lt72iBCX Maas5amF55Hfo/umeiP1vg4pzrrItMy0V+tyqLpRN9xqd1vb/C/6bEtR9lui4QmGRJ meNtaGJZUf2GU/tUYvF4xOoFuMpzrHeGVuoCVTk4= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x343.google.com (mail-wm1-x343.google.com [IPv6:2a00:1450:4864:20::343]) by sourceware.org (Postfix) with ESMTPS id C8AC63947C28 for ; Tue, 20 Oct 2020 14:23:38 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org C8AC63947C28 Received: by mail-wm1-x343.google.com with SMTP id a72so1997734wme.5 for ; Tue, 20 Oct 2020 07:23:38 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=pPKuMBiv52/bvg9lIGM3tBEPqf6hoRrTZs/pqh82PCM=; b=LhwNn5lW364KiucPHV5U7IMoCfzPcMDDXuNPcxJBNvRYpQ6ndbf9Xt1nPZ9OAS6uFi OKrgI/9nCpCq2lCgYHzRH+YJ3YV6bInCYNaEv4FEiBRf8MAMaP3EP6if0fMUKbtGBZAX MxUGE2Q1wyYS2z8TPKrGhKJ/6CptnxPYwBs/SFOblnDn2VX7MDxKTIY8ELkN/Hl10WPy yy3j5hBysmbEJy8sD3HoVvtqQmAYCd6axJvmlrFCbV+AtvfOhgqfF7K/V47TxBOb74N4 o6fvbZQK5IKEvKNIBaScrNpCkgS65JHXmdwt/jShcwrmnPnV4HSfDbI870iEokHnHAyn /UeA== X-Gm-Message-State: AOAM5308L7lxUIbQXvRSN9QMCcwnLxMlHWLPyaiEajnG4yOSXCah+QRb Bikpg5/ShcySjQ0vETgka3Q= X-Google-Smtp-Source: ABdhPJwd/0AxQt0BWQKFLRhTGtk8xdSG2uFYQP+zarNXVQT5/o09J/Ms0MAwlEHFbTWmTvHuGmRRbQ== X-Received: by 2002:a1c:cc01:: with SMTP id h1mr3379599wmb.114.1603203817952; Tue, 20 Oct 2020 07:23:37 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:37 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 16/22] list.3: CONFORMING TO: Adapt to this page Date: Tue, 20 Oct 2020 16:21:41 +0200 Message-Id: <20201020142146.61837-17-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/man3/list.3 b/man3/list.3 index 64f94197a..2a873deab 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -258,10 +258,9 @@ from the list. .SH RETURN VALUE .SH CONFORMING TO Not in POSIX.1, POSIX.1-2001 or POSIX.1-2008. -Present on the BSDs. -.Nm queue -functions first appeared in -.Bx 4.4 . +Present on the BSDs +(LIST macros first appeared in +.Bx 4.4 ). .SH BUGS .SH EXAMPLES .SH SEE ALSO From patchwork Tue Oct 20 14:21:42 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40776 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id EC5ED39494B3; Tue, 20 Oct 2020 14:23:43 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org EC5ED39494B3 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203824; bh=jbkBjfvwtbmvjHEYZB8dIAYP4PDfKaSkHZNncV8uSXc=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=Sq1P+xlTlCfLZXyuiMBckDymzPXON8uyhBC9vOXY8h8iaxcXdE8vFGCT98Faq32Ug gZdI5QXvDOxcqeerRY869exGufc1B4D+RhFFejsK1MzPU+nO43m5sXV72h0XU/lKBt 8mOQlSSCP++fph3ScXacNl7Xo6xQHOzPY1vNr+GM= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x341.google.com (mail-wm1-x341.google.com [IPv6:2a00:1450:4864:20::341]) by sourceware.org (Postfix) with ESMTPS id 0A6253948804 for ; Tue, 20 Oct 2020 14:23:40 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 0A6253948804 Received: by mail-wm1-x341.google.com with SMTP id k21so1282184wmi.1 for ; Tue, 20 Oct 2020 07:23:39 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=jbkBjfvwtbmvjHEYZB8dIAYP4PDfKaSkHZNncV8uSXc=; b=nL+JPlfaqRRqfhA1zJfHdoTs0R6N4IDJ/DxWkpvS3vgmrW1oComK3zpAOnLrmvkv7r wnGwFjhwnP8Sw78jBjkbrQYsb01D6cwRLPYATiU3UEx93bsSa+BwGFRCKqWu2Y+iGEvF QOX4Zd9n3aGU/zYzyrWBM48DBiy0O3eZT4cvhvT4Cp79HSLce0yYl7D+u/NnBQETwzcp f3NmiHPlBYWcCRstiJgxRC5dvsezNM28ry5EDtUClJnXAKRdo4gSjRV2rTbiweUnlL95 BSYjsPids1KvkiFP75gLu8ia0VX95vrl556E8rmsFDu7DdvnxtnC8hnJ+S2E5J68PiYX sPQQ== X-Gm-Message-State: AOAM530UzV/j/mRnvDnkuYekL42vA17PLnSgt0HZaz/LsZfA8Lm98czO 3DhUKLPLU834stMrxxdXbdY= X-Google-Smtp-Source: ABdhPJwUdVbyuXIXUwcihyfslEXAKg1kndI5cGGFoeywFBIBDfjxNQdNTBomHptrjDR/eSttYOmOkg== X-Received: by 2002:a1c:e244:: with SMTP id z65mr1312394wmg.40.1603203819135; Tue, 20 Oct 2020 07:23:39 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.38 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:38 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 17/22] list.3: CONFORMING TO: ffix: Use man markup Date: Tue, 20 Oct 2020 16:21:42 +0200 Message-Id: <20201020142146.61837-18-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/man3/list.3 b/man3/list.3 index 2a873deab..478fa2bf3 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -259,8 +259,7 @@ from the list. .SH CONFORMING TO Not in POSIX.1, POSIX.1-2001 or POSIX.1-2008. Present on the BSDs -(LIST macros first appeared in -.Bx 4.4 ). +(LIST macros first appeared in 4.4BSD). .SH BUGS .SH EXAMPLES .SH SEE ALSO From patchwork Tue Oct 20 14:21:43 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40777 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 79E703949F39; Tue, 20 Oct 2020 14:23:44 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 79E703949F39 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203824; bh=YMKdFZ0eb1GC6nHLjRmILO1T/IbNsLeL6Watx/NwAes=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=EI1L05DZexXeIyRRq78q60no4j+AZMyrAC0CPiUbGnHhcOXUNlmZBf91iJlMNugr4 75QQIFy/+UO5Oat7mC+SmUScE4l3iXX1f2BgxJJqTlew7+lH0CDCfQc5m8YL5rhOcF dMjmrjL934rXMGWkAEUy3LdWOo5KFuNJCJO0iae0= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x343.google.com (mail-wm1-x343.google.com [IPv6:2a00:1450:4864:20::343]) by sourceware.org (Postfix) with ESMTPS id 17B603948A7B for ; Tue, 20 Oct 2020 14:23:41 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 17B603948A7B Received: by mail-wm1-x343.google.com with SMTP id c194so1995300wme.2 for ; Tue, 20 Oct 2020 07:23:41 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=YMKdFZ0eb1GC6nHLjRmILO1T/IbNsLeL6Watx/NwAes=; b=svbfaSxSltniSEmKHcY5FQYOpzJMpUGecdMjDwkf7PTVuE8jvrVIEfghUkv6wg6udl eQP1a8RSanoFFPRV+SttnaEW4KY62buofhCwLoBu0oLNXh1Oo5ik1p2gNO+z5CUPHiR7 Y+I59xvV3VhsOZmUc5xG/NAOVQY/ycyIy1i762xC5GsXkMij6JkQBR1GblTIwRbrJ0s2 e7MU+aYGyU3M8pm33TDdFwsctq5DBhGN7ZYqo0kuY4JPtlXeScOQtHgYq6YqYFo+/DrW 7SgHf0sfGFxk4mYJnBoyZsDvgn+S4XcSrvEMsXPJaVFMRM7BoKW7KJKR1gntGQjZ97oB 4K7w== X-Gm-Message-State: AOAM533NhjjhoCPYX6IdQ5pSDzOI2jilsWoHQm/tO6d9NQOx2dDcsQOJ FS2EAKa8gBhW3mCZdd0hk0o= X-Google-Smtp-Source: ABdhPJywqF1MKA+aA/Q6eJ6rO8BWeTcftmwOh6wBI1FUcXNdqNkPxws5eZXcTy0w2Rbp3L53jbE5hw== X-Received: by 2002:a1c:62c4:: with SMTP id w187mr3246795wmb.149.1603203820231; Tue, 20 Oct 2020 07:23:40 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.39 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:39 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 18/22] list.3: SEE ALSO: Add insque(3) and queue(3) Date: Tue, 20 Oct 2020 16:21:43 +0200 Message-Id: <20201020142146.61837-19-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 2 ++ 1 file changed, 2 insertions(+) diff --git a/man3/list.3 b/man3/list.3 index 478fa2bf3..82ab4dae4 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -263,3 +263,5 @@ Present on the BSDs .SH BUGS .SH EXAMPLES .SH SEE ALSO +.BR insque (3), +.BR queue (3) From patchwork Tue Oct 20 14:21:44 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40778 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 0838C394BE1E; Tue, 20 Oct 2020 14:23:47 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 0838C394BE1E DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203827; bh=qKxFdoB7BkFr4yTxpHUhm8llf8mmFKw38T1ZVFXcz9c=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=wC5a9EbKamcgwDj0KoQ1J89260cgMasZ+8gcnwtCyoz2FbU+rvhpabEhH3d+ttu7x CV/pr8covm/rUTOfr+RpZ44qkZlUm7f33MAlw/Ovj2f609il2JpzzWLWwWaSq/pRdy 4R9y6XozhEqExMSDNhXzwwl6SD4K7hpIQBCD7Dts= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x335.google.com (mail-wm1-x335.google.com [IPv6:2a00:1450:4864:20::335]) by sourceware.org (Postfix) with ESMTPS id 4CB783947C00 for ; Tue, 20 Oct 2020 14:23:42 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 4CB783947C00 Received: by mail-wm1-x335.google.com with SMTP id a72so1997939wme.5 for ; Tue, 20 Oct 2020 07:23:42 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=qKxFdoB7BkFr4yTxpHUhm8llf8mmFKw38T1ZVFXcz9c=; b=WWKF0bVj24T/3+JYKx2roYOp9O/PCZira/mEfpv6T8d06/McFvIi3EGFK1XzW8KBz0 AhAcWwiY7GGNdUlvPK7h7NNFAapRKENLQYsSq81TRS6u/dbOIM/AlA8hwDsx6sFxAb1p s+clE7r2rKic4rO0md37OYkEI3dd/ERRzUKa4My6DMx7ubmUqPnEIYG+RMVUfcGkybxw qHmeYyOEkE72Vv2mmUqBnAJQgbbmubm4bEZgezIJWhOTN21aT72NWsiUhEHl815Cp5CK BLl9PztNGTINrmw/3pSwXJfqOWQVqmrf8sEGIiEedouf9VFjZdpnSvT3ayr9rZJtOdQc G6wQ== X-Gm-Message-State: AOAM53057xejAYa18wmJV01njVh4/5Y4PnZ6BUdBI3IUmY1Wb5bA0piv 1eOEazex8u7uWhMAx4XYz3s= X-Google-Smtp-Source: ABdhPJwJksIHeJBSVlSDTZ9mKaaJgFqClyF3ph/sgrnsViH3X5tOjY5iKgnrMn8G79hRh3aKOPNFmg== X-Received: by 2002:a1c:9641:: with SMTP id y62mr3317887wmd.145.1603203821264; Tue, 20 Oct 2020 07:23:41 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:40 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 19/22] list.3, queue.3: EXAMPLES: Move example program from queue.3 to list.3 Date: Tue, 20 Oct 2020 16:21:44 +0200 Message-Id: <20201020142146.61837-20-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.5 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, KAM_NUMSUBJECT, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 53 ++++++++++++++++++++++++++++++++++++++++++++++++++++ man3/queue.3 | 53 ---------------------------------------------------- 2 files changed, 53 insertions(+), 53 deletions(-) diff --git a/man3/list.3 b/man3/list.3 index 82ab4dae4..b22453ab9 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -262,6 +262,59 @@ Present on the BSDs (LIST macros first appeared in 4.4BSD). .SH BUGS .SH EXAMPLES +.Ss List example +.Bd -literal +#include +#include +#include +#include + +struct entry { + int data; + LIST_ENTRY(entry) entries; /* List. */ +}; + +LIST_HEAD(listhead, entry); + +int +main(void) +{ + struct entry *n1, *n2, *n3, *np; + struct listhead head; /* List head. */ + int i; + + LIST_INIT(&head); /* Initialize the list. */ + + n1 = malloc(sizeof(struct entry)); /* Insert at the head. */ + LIST_INSERT_HEAD(&head, n1, entries); + + n2 = malloc(sizeof(struct entry)); /* Insert after. */ + LIST_INSERT_AFTER(n1, n2, entries); + + n3 = malloc(sizeof(struct entry)); /* Insert before. */ + LIST_INSERT_BEFORE(n2, n3, entries); + + i = 0; /* Forward traversal. */ + LIST_FOREACH(np, &head, entries) + np->data = i++; + + LIST_REMOVE(n2, entries); /* Deletion. */ + free(n2); + /* Forward traversal. */ + LIST_FOREACH(np, &head, entries) + printf("%i\en", np->data); + /* List Deletion. */ + n1 = LIST_FIRST(&head); + while (n1 != NULL) { + n2 = LIST_NEXT(n1, entries); + free(n1); + n1 = n2; + } + LIST_INIT(&head); + + exit(EXIT_SUCCESS); +} +.Ed .SH SEE ALSO .BR insque (3), .BR queue (3) diff --git a/man3/queue.3 b/man3/queue.3 index 6ee793e25..0f55a899e 100644 --- a/man3/queue.3 +++ b/man3/queue.3 @@ -1155,59 +1155,6 @@ main(void) exit(EXIT_SUCCESS); } .Ed -.Ss List example -.Bd -literal -#include -#include -#include -#include - -struct entry { - int data; - LIST_ENTRY(entry) entries; /* List. */ -}; - -LIST_HEAD(listhead, entry); - -int -main(void) -{ - struct entry *n1, *n2, *n3, *np; - struct listhead head; /* List head. */ - int i; - - LIST_INIT(&head); /* Initialize the list. */ - - n1 = malloc(sizeof(struct entry)); /* Insert at the head. */ - LIST_INSERT_HEAD(&head, n1, entries); - - n2 = malloc(sizeof(struct entry)); /* Insert after. */ - LIST_INSERT_AFTER(n1, n2, entries); - - n3 = malloc(sizeof(struct entry)); /* Insert before. */ - LIST_INSERT_BEFORE(n2, n3, entries); - - i = 0; /* Forward traversal. */ - LIST_FOREACH(np, &head, entries) - np->data = i++; - - LIST_REMOVE(n2, entries); /* Deletion. */ - free(n2); - /* Forward traversal. */ - LIST_FOREACH(np, &head, entries) - printf("%i\en", np->data); - /* List Deletion. */ - n1 = LIST_FIRST(&head); - while (n1 != NULL) { - n2 = LIST_NEXT(n1, entries); - free(n1); - n1 = n2; - } - LIST_INIT(&head); - - exit(EXIT_SUCCESS); -} -.Ed .Ss Tail queue example .Bd -literal #include From patchwork Tue Oct 20 14:21:45 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40779 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 89735394C04D; Tue, 20 Oct 2020 14:23:47 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 89735394C04D DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203827; bh=mmsFsfv/B3MScHqyQjkwZ06nYyX1lorlGxlwweOx9HM=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=nhz5Nj63JEnxayeQ07D5nf74ehXwkKAzzZfKtiAYF9udzMCksltb5Rqv3Ew0w0o76 AhxveJT1JdbdkzuezSPkITI0AOFOQN8VF4Osk2B0m+HzzbBMhZIBESStIo5Prylgou 61pd16l3cb+9DP2hDWfzEnIwUOwNpGHX5WgsXwlo= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x343.google.com (mail-wm1-x343.google.com [IPv6:2a00:1450:4864:20::343]) by sourceware.org (Postfix) with ESMTPS id 3AF463948A7B for ; Tue, 20 Oct 2020 14:23:43 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 3AF463948A7B Received: by mail-wm1-x343.google.com with SMTP id c16so2126945wmd.2 for ; Tue, 20 Oct 2020 07:23:43 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=mmsFsfv/B3MScHqyQjkwZ06nYyX1lorlGxlwweOx9HM=; b=hQT3pj0CFyx5MKjln5jXJ1ZUN+7Te0xPIZSpzjBbuopeB51OjeHJ+DZjGwI3sPZXD8 0IptlpTBRbr56kL2QAKEvdQfzq/E3sNDRLwa0pmOW4M1NcFS3eqcwJiohK2xSgbEdneD LRwk5FFlUc0e4+fsMwjLkAQ2zeqK6w0L4sjO4AYR4zGDpOwfoE61MWLf+FaSG/bhcWfr ew4Cldi+s5MTCqcnNiX6rXlXWQdm/Mcs5tl3Q3q7C0Uw0WybzFGHzviiask7iBo6Zig6 O9CuGvnFkbST0ISAhJ4aRTKlR9vHoowxMfhW7bfF3fV+Wg0devdQ45rG7YAgpWL6Bx/B +XcA== X-Gm-Message-State: AOAM533oucKKRktPo/7OMuyi67L38NiucVtuE1vBZ1K4mr6XebJddE4a UNBBLhAVInWNkiA6n00gnOQ= X-Google-Smtp-Source: ABdhPJwzYi91lN0Rs2ouQc9UcGgwdgVzhI3NkaYttd6hm89/a1v1oAeSeg/TDyUhcWV+UX/OYzPc2g== X-Received: by 2002:a1c:a749:: with SMTP id q70mr1309267wme.117.1603203822369; Tue, 20 Oct 2020 07:23:42 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:41 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 20/22] list.3: EXAMPLES: ffix: Use man markup Date: Tue, 20 Oct 2020 16:21:45 +0200 Message-Id: <20201020142146.61837-21-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/man3/list.3 b/man3/list.3 index b22453ab9..bb64fff92 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -262,8 +262,7 @@ Present on the BSDs (LIST macros first appeared in 4.4BSD). .SH BUGS .SH EXAMPLES -.Ss List example -.Bd -literal +.EX #include #include #include @@ -314,7 +313,7 @@ main(void) exit(EXIT_SUCCESS); } -.Ed +.EE .SH SEE ALSO .BR insque (3), .BR queue (3) From patchwork Tue Oct 20 14:21:46 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40780 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 1D676394D818; Tue, 20 Oct 2020 14:23:48 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 1D676394D818 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203828; bh=hgt+bR4Tevd5sxU7yCKi7CgfsprPB04M5XYVo9EqDJQ=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=fnDf+SW0nvvWlBgp6K6MaWW6G1jv0AsljmE9ly990TeoelqwEDQnr9G4mpNTN+KXm k8ubU8gs9HU31gKjjNE01SLHPt89D9AeRBXRizST4Y0MmYF3yCsmQu/O5pew8zC14O 6eYoI3y5onFfv5vBphZV+D4lhdqYPKVX5oM9i5NQ= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x342.google.com (mail-wm1-x342.google.com [IPv6:2a00:1450:4864:20::342]) by sourceware.org (Postfix) with ESMTPS id 462BA394743E for ; Tue, 20 Oct 2020 14:23:44 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 462BA394743E Received: by mail-wm1-x342.google.com with SMTP id k18so2121728wmj.5 for ; Tue, 20 Oct 2020 07:23:44 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=hgt+bR4Tevd5sxU7yCKi7CgfsprPB04M5XYVo9EqDJQ=; b=k9BgT5vWPUFACT6BK+B/n6sYjz27+lil10lgnL/1HaasLuFRCLdXC7KY/AiC2neEtQ ckqlP14I4IhQyGjELYTriqNYF0QvHRe7N8YhSzDRI6Bq9IDYiy8RkOB488JuA6dR4IRh jeLUe5GshjX33zzDM/nHhca/KyHg+BfI3UUTfFBCa6s/5xDVTOdnzYKujGkwBxcJAQP9 CrRWBdgT7k7OLy/aqgtn+mSvKh5Oy8a4LA1UkRKeOL8MmCw5CUAfWF9ZKHm0jJcZKWPX dbFnKYex+gcpM05nies9urNDjOuwFB0l88Yzr2N1vDvdRStzu5BH1L1wz6hscnBk8Ncb 5V+g== X-Gm-Message-State: AOAM531UHLkQNil/G5OyOEblWHSmP9QHx5dx/6SNIUrHIuiViLnDtIke KPX9ugGmd54rqDUh++CTQzA= X-Google-Smtp-Source: ABdhPJxvXTckkuTNsrVQmsKdjWUfM5hyfWrDPbCE3PJJSV2A8cvuqCTn50aSj10Z5KklEh8uhyAYoQ== X-Received: by 2002:a1c:b402:: with SMTP id d2mr3398980wmf.128.1603203823422; Tue, 20 Oct 2020 07:23:43 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:42 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 21/22] list.3: BUGS: Note LIST_FOREACH() limitations Date: Tue, 20 Oct 2020 16:21:46 +0200 Message-Id: <20201020142146.61837-22-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/man3/list.3 b/man3/list.3 index bb64fff92..4aec14cc8 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -261,6 +261,20 @@ Not in POSIX.1, POSIX.1-2001 or POSIX.1-2008. Present on the BSDs (LIST macros first appeared in 4.4BSD). .SH BUGS +The macro +.BR LIST_FOREACH () +doesn't allow +.I var +to be removed or freed within the loop, +as it would interfere with the traversal. +The macro +.BR LIST_FOREACH_SAFE (), +which is not present in glibc, +solves this bug by +allowing to both remove +.I var +as well as free it from within the loop safely +without interfering with the traversal. .SH EXAMPLES .EX #include From patchwork Tue Oct 20 14:21:47 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 40781 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 3086D394D82F; Tue, 20 Oct 2020 14:23:49 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 3086D394D82F DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603203829; bh=BqmXmbKrXg1DH/KrgyTuNS8q1K3WnyQKkzpPuJBr/pA=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=B4cuX96aFZtRxM/Vv/cNIJt0ZV1wL9XUYA427Vu6CjOV7BuSAiUOGsmAep4Vjxm5/ k2XZ518edYAmZFoWUtIOWikeWZ5SZuIM3TbtpzJ1e+6YeQebtJVITmirCIudfdXTE/ R4GmXGAedPPpXfUJO6Faav2yrH4kZJCNMU8LgnUs= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x444.google.com (mail-wr1-x444.google.com [IPv6:2a00:1450:4864:20::444]) by sourceware.org (Postfix) with ESMTPS id 51940394B01F for ; Tue, 20 Oct 2020 14:23:45 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 51940394B01F Received: by mail-wr1-x444.google.com with SMTP id e17so2376223wru.12 for ; Tue, 20 Oct 2020 07:23:45 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=BqmXmbKrXg1DH/KrgyTuNS8q1K3WnyQKkzpPuJBr/pA=; b=DFukiLQAU9FcCmUWh9kmBobOuSTK3Bcpxv6ynH02QuXTYTi/8feaLaHJBmTWgF/+Mh JfjDUf2u1T20mVrVugPInzugJc4GX8l4pp6TIt+qjx516QMhIPBWIjTcUgh5FJTbj2Wx L3blGegVpZ8rxp28beh790Jy5zPXNLjVZqpjvJIRBlwlkwtr0/jTyV55h2UAzYONmw6T zuvwAVJTNXnNFA2UI4Iji3UTENL4wXSQ0z6Oc9jDHu/h79xV/IBK/4H9KCul6TBA/xNu o6lhzXISbs4LO5pThxwrkf9+zwMJltnQPbMC9ImGv0EEhHaZm/ZTT/3n/a+IobqF8xqN 06Nw== X-Gm-Message-State: AOAM53382M/vxup03VbhJkEpRvh4esSaH7gnngCAgca236Sp78z80TWh +NpK+QlTUMw3pxXdLV3mFYI= X-Google-Smtp-Source: ABdhPJxS0wVAU5kxhUejvsqV3OdYhGP4VDXSwxFUsipovZAbeYi1WxxAFaMPJy1UohTVuS+I2mxaiw== X-Received: by 2002:a5d:6407:: with SMTP id z7mr4059173wru.271.1603203824472; Tue, 20 Oct 2020 07:23:44 -0700 (PDT) Received: from localhost.localdomain ([170.253.60.68]) by smtp.googlemail.com with ESMTPSA id s19sm3422153wmc.0.2020.10.20.07.23.43 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 Oct 2020 07:23:43 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 22/22] list.3: RETURN VALUE: Add details about the return value of those macros that "return" a value Date: Tue, 20 Oct 2020 16:21:47 +0200 Message-Id: <20201020142146.61837-23-colomar.6.4.3@gmail.com> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20201020142146.61837-1-colomar.6.4.3@gmail.com> References: <20201020142146.61837-1-colomar.6.4.3@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-10.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man3/list.3 | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/man3/list.3 b/man3/list.3 index 4aec14cc8..8233c3b3e 100644 --- a/man3/list.3 +++ b/man3/list.3 @@ -256,6 +256,20 @@ from the list. .\" and .\" .IR head2 . .SH RETURN VALUE +.BR LIST_EMPTY () +returns non-zero if the list is empty, +and zero if the list contains at least one entry. +.PP +.BR LIST_FIRST (), +and +.BR LIST_NEXT () +return a pointer to the first or next +.I LIST_ENTRY +structre, respectively. +.PP +.BR LIST_HEAD_INITIALIZER () +returns an initializer that can be assigned to the list +.IR head . .SH CONFORMING TO Not in POSIX.1, POSIX.1-2001 or POSIX.1-2008. Present on the BSDs