Received: from mout.gmx.net (mout.gmx.net [212.227.17.22]) by h1439878.stratoserver.net (8.14.2/8.14.2/Debian-2build1) with ESMTP id s2G9PPsQ029929 for ; Sun, 16 Mar 2014 10:25:27 +0100 Received: from relay2.uni-heidelberg.de ([129.206.210.211]) by mx-ha.gmx.net (mxgmx102) with ESMTPS (Nemesis) id 0Mch7F-1WgNDl06sL-00Hyvz for ; Sun, 16 Mar 2014 10:25:20 +0100 Received: from listserv.uni-heidelberg.de (listserv.uni-heidelberg.de [129.206.100.94]) by relay2.uni-heidelberg.de (8.13.8/8.13.8) with ESMTP id s2G9KC81005442 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sun, 16 Mar 2014 10:20:12 +0100 Received: from listserv.uni-heidelberg.de (listserv.uni-heidelberg.de [127.0.0.1]) by listserv.uni-heidelberg.de (8.13.8/8.13.8) with ESMTP id s2G500ql003739; Sun, 16 Mar 2014 10:20:11 +0100 Received: by LISTSERV.UNI-HEIDELBERG.DE (LISTSERV-TCP/IP release 16.0) with spool id 10758406 for LATEX-L@LISTSERV.UNI-HEIDELBERG.DE; Sun, 16 Mar 2014 10:20:11 +0100 Received: from relay.uni-heidelberg.de (relay.uni-heidelberg.de [129.206.100.212]) by listserv.uni-heidelberg.de (8.13.8/8.13.8) with ESMTP id s2G9KBk0018018 for ; Sun, 16 Mar 2014 10:20:11 +0100 Received: from moutng.kundenserver.de (moutng.kundenserver.de [212.227.126.130]) by relay.uni-heidelberg.de (8.14.1/8.14.1) with ESMTP id s2G9K44A000685 for ; Sun, 16 Mar 2014 10:20:06 +0100 Received: from mittelbach-online.de (pD9FE32EF.dip0.t-ipconnect.de [217.254.50.239]) by mrelayeu.kundenserver.de (node=mreue007) with ESMTP (Nemesis) id 0MK8bx-1WNk7419C1-001Upj; Sun, 16 Mar 2014 10:14:59 +0100 Received: from [192.168.123.105] (falco [192.168.123.105]) (Authenticated sender: frank) by mittelbach-online.de (Postfix) with ESMTPSA id 85ECAA00B7 for ; Sun, 16 Mar 2014 09:57:51 +0100 (CET) User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:24.0) Gecko/20100101 Thunderbird/24.3.0 MIME-Version: 1.0 References: <53248902.4050200@morningstar2.co.uk> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-MailScanner-ID: 85ECAA00B7.A7E3E X-MailScanner: Not scanned: please contact your Internet E-Mail Service Provider for details X-MailScanner-From: frank.mittelbach@latex-project.org X-Spam-Status: No X-Provags-ID: V02:K0:gDdXPKwLwiJciEux3Qt1V+zyMeNX6rq3Cp9blmnQ9ml dEwbyLXkYf5cQW39g3wNf3vCXCf6zpB8ieHWNLliGJDpUKpHrf Qo168GweTcR+4X9JWIUhDj6piwjW6kzFYwwHLPjZfB1WJ6RRgP LozI3Iu3iZRBjLn1bc9Tx/HL6aNOHZ4UQHV+6hTn/ZYAeM0mNH bi6fg7NTWIMtq2XA3EZaLsTuw53FNqEMdKX0cbEqB1qqWiiiTi 93gaCjYl/H8L7plat2wVaDlUxmMndnWM5w1C8PHDczZyd06cmO WbK8SpavU8QeADaVrD62ENlrJe+r0WiZ62etNFAkXiuhtqzXny OqAFgV0khE529KOEkrytW+d9TZJuNOdhS8bG4zovflSbYzN/T8 ktKfIWPKQB1VA== Message-ID: <53256B76.3050006@latex-project.org> Date: Sun, 16 Mar 2014 10:14:30 +0100 Reply-To: Mailing list for the LaTeX3 project Sender: Mailing list for the LaTeX3 project From: Frank Mittelbach Subject: Re: Documenting 'locally added' expl3 variants To: LATEX-L@LISTSERV.UNI-HEIDELBERG.DE In-Reply-To: Precedence: list List-Help: , List-Unsubscribe: List-Subscribe: List-Owner: List-Archive: Envelope-To: X-GMX-Antispam: 0 (Mail was not recognized as spam); Detail=V3; X-GMX-Antivirus: 0 (no virus found) X-UI-Filterresults: notjunk:1;V01:K0:k+zwTAULupk=:uO5O468kZffQX+CsN/OHvsciwf Ab5fjgOIjzZcdLtHUFXLNhhFE/7m0DGUsIpusapdAMKY16VTZ2YyIwp+QgBzaytb6i/MGgqE+ 9kjwjYFcoGsibmceocSNYx3KUDsfN9YpdhWPC5K35IhfTd3U+z9xCrC/OgYsvnfiM0kdpNPrJ +6e2zYonTYbI48UEWHvyC7c7xioVC/TGDy3C9qJqc1Bvfzsgav75PsbGEudtXRXLawDPHWqBF u0IzMDqW1zDKVRHvTFE1dqNQfgawrg5L96YyC2xtUOGWCpVOpiYNoslRUwugNjdWqt6QfG8lU lgAdbj5Uvm/RJ+koyAqWBBPjXdsOOezbfxKsIk362UWFmmO3Jm4ZRCY20P9yAmgdn2aB/abX+ IpFZI0gEtMj8NmAwUvgz4nbDtQJnJWHjD1oVPXQou+LI8UHQ6AgsqEcBMYjZTAR3e0kCWoG1Z ce3kMAgQGMq1MIuEIR2xuDmVEE8/IgVzBWK9yfkbvmCfTEJnRAw+MSg0haNMFNOjZlvxYZjgs ZvQ5/LWT80JJfwIN1YailV5+zCsxIR60aSj5fHg97C6K2gl2mUb4pAedtLpFn8RnwSRc+im2n 3Ocmrf3fsKt2OOQk7hQBHTYdAICDKF6zHvdsMuzevpjYnDyulbPBXvvbScxzF3rwdC3yP99Fy kQHOhJqxbaNMwoM+nQTA3jRpPUVqo4hfHG1qC0BUrw8kpUgbQ+uootL4OdeqVjUIo2EBCck+z UwGN79Chcx7jW8eB4E+2IQ5ffFon9nuA45yJXSvPQwc2c9nHF8wcp+8GsXL6pB2NoVNsZ3/a3 ag9mQmANPsotsQs7WF77Tb4AiguwMISOHK/vxZJMrYErxNvqB+MO3MVCMnb4wDIwdbtjoI4/I nfSsM0FoLoqN8XHwncBUkPkyav2juA8m6na81RrkQp55OywReWzLGSXdcqXTvkLNoVOlSqEgH ydJdJhR5QqCrRwc8Z0r7VewkLUBouBJ5c1SUkwj6jZ2gGiJIvnZqzZ7ToTEULi6bchZ7Ibx+o RhQV9yZQU/XmKVPMupXKshJrEEUHb3KvdDqSAct2KYRx//8WvuQ9H23MLeWYr49/Dd9cMbv4O RuS7xfk1FtWvkufcdlGz9Ckt/9awgx7VC2AB5soNw8oi7vG1TgwPOIAVuQfRc+BZybbs3yGEm BRuc7AXkrUGsRkK4kxmDb/T7X8eAcmm+cdiLeS3e3/1SjwQybNpPWRRjJO7oSZa4+MMluDNZy n5X0dY1ZfCoJ3gOVc1Ooz9UmloLMYaEMWi7M7ISHQfuuNh8LvoAqtYYgb/JX+JZGPmxiaD7tk kRdweE70pNrskTXiZZKl3thUuAguezvNozgIzUPZ/bX/oZdHkEpAs4Fn8slhhLJzfSuQShZpY 8fPdPwMVwwf/uihWYp3hbW75m7/jXjMJT8qkLIqzEw6NHiJkISmE0LlVUu6M4vDumLtF5MzeP XtkkGm7Q== X-UI-Loop:V01:SfdeCWAsi7Q=:shi1QGbpaXh732fVoVb4M0JM6xtMKm2JUdpYawdkTwA= Status: R X-Status: X-Keywords: X-UID: 7340 Am 15.03.2014 23:18, schrieb Michiel Helvensteijn: > On Sat, Mar 15, 2014 at 6:08 PM, Joseph Wright > wrote: > >> Working systematically, I notice that I use a few variants of core expl3 >> commands that have to be created. Based on the 'document everything >> public' principle, these should be mentioned (they have 'public' >> function names). On the other hand, they are 'nothing to do with me' as >> all I'm doing is something like >> >> \cs_generate_variant:Nn \some_team_function:n { V } > > Would you have generated this variant for the public interface even if > you didn't need it internally? That is, does it make sense on its own? > If so, document it. If not, don't document it. that's perfectly right if \some_team_function:n is really an interface of the package being defined. I maintain it is not alright if it is an interface of a different package or the kernel. In that case any package that needs the variant should declare it (which is an idempotent operation, so that's fine) but it avoids creating dependencies between packages that are unnecessary. cheers frank