Received: from mx0.gmx.net (mx0.gmx.net [213.165.64.100]) by h1439878.stratoserver.net (8.14.2/8.14.2/Debian-2build1) with SMTP id q6HIbaPi022467 for ; Tue, 17 Jul 2012 20:37:37 +0200 Received: (qmail 31087 invoked by alias); 17 Jul 2012 18:37:31 -0000 Delivered-To: GMX delivery to rainer.schoepf@gmx.net Received: (qmail invoked by alias); 17 Jul 2012 18:37:30 -0000 Received: from relay2.uni-heidelberg.de (EHLO relay2.uni-heidelberg.de) [129.206.210.211] by mx0.gmx.net (mx030) with SMTP; 17 Jul 2012 20:37:30 +0200 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 q6HIVgZA030354 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Tue, 17 Jul 2012 20:31:42 +0200 Received: from listserv.uni-heidelberg.de (localhost.localdomain [127.0.0.1]) by listserv.uni-heidelberg.de (8.13.1/8.13.1) with ESMTP id q6HGEB7A000878; Tue, 17 Jul 2012 20:31:42 +0200 Received: by LISTSERV.UNI-HEIDELBERG.DE (LISTSERV-TCP/IP release 16.0) with spool id 2035003 for LATEX-L@LISTSERV.UNI-HEIDELBERG.DE; Tue, 17 Jul 2012 20:31:42 +0200 Received: from relay2.uni-heidelberg.de (relay2.uni-heidelberg.de [129.206.210.211]) by listserv.uni-heidelberg.de (8.13.1/8.13.1) with ESMTP id q6HIVfWv031275 for ; Tue, 17 Jul 2012 20:31:41 +0200 Received: from smtp.demon.co.uk (mdfmta004.mxout.tch.inty.net [91.221.169.45]) by relay2.uni-heidelberg.de (8.13.8/8.13.8) with ESMTP id q6HIUdhb029940 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Tue, 17 Jul 2012 20:31:36 +0200 Received: from mdfmta004.tch.inty.net (unknown [127.0.0.1]) by mdfmta004.tch.inty.net (Postfix) with ESMTP id 17930AC406F; Tue, 17 Jul 2012 19:30:39 +0100 (BST) Received: from mdfmta004.tch.inty.net (unknown [127.0.0.1]) by mdfmta004.tch.inty.net (Postfix) with ESMTP id E3DE9AC406C; Tue, 17 Jul 2012 19:30:38 +0100 (BST) Received: from palladium.local (unknown [80.176.134.7]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mdfmta004.tch.inty.net (Postfix) with ESMTP; Tue, 17 Jul 2012 19:30:38 +0100 (BST) User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.7; rv:13.0) Gecko/20120614 Thunderbird/13.0.1 MIME-Version: 1.0 References: X-Enigmail-Version: 1.4.2 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-MDF-HostID: 17 Message-ID: <5005AF4D.7080802@morningstar2.co.uk> Date: Tue, 17 Jul 2012 19:30:37 +0100 Reply-To: Mailing list for the LaTeX3 project Sender: Mailing list for the LaTeX3 project From: Joseph Wright Subject: Re: model l3 dtx file To: LATEX-L@listserv.uni-heidelberg.de In-Reply-To: Precedence: list List-Help: , List-Unsubscribe: List-Subscribe: List-Owner: List-Archive: X-GMX-Antispam: 0 (Sender is in whitelist: joseph.wright@MORNINGSTAR2.CO.UK); Detail=5D7Q89H36p4L00VTXC6D4q0N+AH0PUCnBi0P5cROEGjO+pG7NAH/K+tf9SrVFtpLrKONl 2T9EL4W4U4jgzLbnCcGpk1z/zwmKT/K1fv3lD0=V1; X-Resent-By: Forwarder X-Resent-For: rainer.schoepf@gmx.net X-Resent-To: rainer@rainer-schoepf.de Status: R X-Status: X-Keywords: X-UID: 7085 On 17/07/2012 18:38, Joel C. Salomon wrote: > BTW, should I also be using l3docstrip? > > —Joel > You should certainly mark up your internal functions \__mypkg_function:nnn separately from those which are documented for interface use \mypkg_public_interface:nn You can do that directly, or use the mechanism provided by l3docstrip. Obviously, the team have developed l3docstrip for general use, and it does keep the typing down. If you use l3doc for your .dtx, l3doc will auto-magically turn any "@@" material in the source into "\__mypkg" if you typeset your .dtx. -- Joseph Wright