From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-Status: No, score=-4.0 required=3.0 tests=AWL,BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_REPLYTO_END_DIGIT, MAILING_LIST_MULTI,SPF_HELO_PASS,SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from sourceware.org (server2.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by dcvr.yhbt.net (Postfix) with ESMTPS id 60FF01F4B4 for ; Mon, 19 Oct 2020 15:29:40 +0000 (UTC) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 05F213870890; Mon, 19 Oct 2020 15:29:39 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 05F213870890 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1603121379; bh=4objxiWWdmdYl/6IcaNg+xFa0q9tF2n6Ld8vAI4q69I=; h=To:Subject:Date:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:Cc:From; b=W6SZ0WxRh6W7HAA5LPFCnwPsuosW2ueELvatq7Z3LqwtGGsw/f/hs8YB+IYMjQV9W Ik2lpUtgxwh22zJZR84Bl4HlSvWcJTdgsOVTr+1t+cXXX7dJJz0sVU0LHeCkSRW4rt 1chbX5P5ewnyttcU/GiwtTZx2G0y8dSF7YgCZGOs= Received: from mail-wm1-x336.google.com (mail-wm1-x336.google.com [IPv6:2a00:1450:4864:20::336]) by sourceware.org (Postfix) with ESMTPS id 8F86B3857C4F for ; Mon, 19 Oct 2020 15:29:35 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 8F86B3857C4F Received: by mail-wm1-x336.google.com with SMTP id a72so225554wme.5 for ; Mon, 19 Oct 2020 08:29: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:to:cc:from:subject:message-id:date:user-agent :mime-version:content-language:content-transfer-encoding; bh=4objxiWWdmdYl/6IcaNg+xFa0q9tF2n6Ld8vAI4q69I=; b=A+Q3E/E+Qf6t5FpqjmU+EB7ux3Uy28Mz0ywPHL1apDIx7A+VPelbFWIhvsoAHNNLYq lP9dS7wwjqZMc+nwTmerlAIllp+9TsqEGlKwokRyqA9StPjDyPOIwLrYsfPzeoe/UPXp e/3XN/TNdIhyB+HIiclV0QJhtI7mAv1kaXrR2cEjLuChr8PpyaqU6+5YgCXOsTGweF36 +GUgEM6Blko+kZYmtkroBFGeDx4zmj1WPTprrrEtTX2Pg/J90In/r4GRC2Lp7/1YYH62 eHhdll/eHQzXVniNSXjHpwPImF05JiID2f6KPZcc+l7A8k+O+2jBRUMb2LB0EUfDmeo7 VuEw== X-Gm-Message-State: AOAM532oBqxz9y+6R8+Brubj1JmIGNwhcWtU7rOGaHwB81f1YVHjWMGj TyukRiYaJ1H+Ck+v+cqyL4F/HEm/BSU= X-Google-Smtp-Source: ABdhPJw/h1eFErMBZw6Jws74xqZoWdWTEFPJuq3cKPnwUJaCiVj2TpQVCVbgPWE2iTnb32yoQNcYkg== X-Received: by 2002:a1c:5683:: with SMTP id k125mr87174wmb.160.1603121374329; Mon, 19 Oct 2020 08:29:34 -0700 (PDT) Received: from [192.168.1.143] ([170.253.60.68]) by smtp.gmail.com with ESMTPSA id a7sm447839wmh.6.2020.10.19.08.29.33 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 19 Oct 2020 08:29:33 -0700 (PDT) To: "Michael Kerrisk (man-pages)" Subject: queue.3 overhaul Message-ID: <33af3ca2-d6ea-5f75-6ad2-e2f43eefe4fa@gmail.com> Date: Mon, 19 Oct 2020 17:29:32 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.12.0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit 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: , From: Alejandro Colomar via Libc-alpha Reply-To: Alejandro Colomar Cc: linux-man , "libc-alpha@sourceware.org" Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Hi Michael, I'm working on moving and fixing code from queue.3 to different pages. I'd like to send you patches against a separate branch, if you would create one, to ask you some questions from time to time, and maybe get suggestions. Or maybe you could look at my branch on github (https://github.com/alejandro-colomar/man-pages/commits/queue (I may force push changes there sometimes)) (BTW, if you have a look there, you can see how I'm moving&fixing the code from queue.3 to the other pages and maybe suggest a different way). Or maybe I can just show you small pieces of code (no patches), like in this email. Whatever works best for you. What do you think about this SYNOPSIS for list.3?: [[ .SH SYNOPSIS .nf .B #include .PP .BI "int LIST_EMPTY(LIST_HEAD *" head ");" .B " LIST_ENTRY(TYPE);" .BI "LIST_ENTRY LIST_FIRST(LIST_HEAD *" head ");" .BI " LIST_FOREACH(TYPE *" var ", LIST_HEAD *" head ", LIST_ENTRY " NAME ");" .\".BI " LIST_FOREACH_FROM(TYPE *" var ", LIST_HEAD *" head ", LIST_ENTRY " NAME ");" .\".BI " LIST_FOREACH_SAFE(TYPE *" var ", LIST_HEAD *" head ", LIST_ENTRY " NAME ", TYPE *" temp_var ");" .\".BI " LIST_FOREACH_FROM_SAFE(TYPE *" var ", LIST_HEAD *" head ", LIST_ENTRY " NAME ", TYPE *" temp_var ");" .B " LIST_HEAD(HEADNAME, TYPE);" .BI "LIST_HEAD LIST_HEAD_INITIALIZER(LIST_HEAD " head ");" .BI "void LIST_INIT(LIST_HEAD *" head ");" .BI "void LIST_INSERT_AFTER(TYPE *" listelm ", TYPE *" elm ", LIST_ENTRY " NAME ");" .BI "void LIST_INSERT_BEFORE(TYPE *" listelm ", TYPE *" elm ", LIST_ENTRY " NAME ");" .BI "void LIST_INSERT_HEAD(LIST_HEAD *" head ", TYPE *" elm ", LIST_ENTRY " NAME ");" .BI "LIST_ENTRY LIST_NEXT(TYPE *" elm ", LIST_ENTRY " NAME ");" .\".BI "LIST_ENTRY LIST_PREV(TYPE *" elm ", LIST_HEAD *" head ", TYPE, LIST_ENTRY " NAME ");" .BI "void LIST_REMOVE(TYPE *" elm ", LIST_ENTRY " NAME ");" .\".BI "void IST_SWAP(LIST_HEAD *" head1 ", LIST_HEAD *" head2 ", TYPE, LIST_ENTRY " NAME ");" .fi ]] Things to note: - The (many) spaces are there because otherwise it's unreadable (at least for me). Also, I kept the copyright from the University of California and added myself: I consider this to be a modified redistribution but not a derived product; maybe I'm wrong in that (I'm not a lawyer :)). Please tell me your thoughts about all of this :) Kind regards, Alex