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 q6I4BaKO012071 for ; Wed, 18 Jul 2012 06:11:37 +0200 Received: (qmail 14932 invoked by alias); 18 Jul 2012 04:11:31 -0000 Delivered-To: GMX delivery to rainer.schoepf@gmx.net Received: (qmail invoked by alias); 18 Jul 2012 04:11:31 -0000 Received: from relay.uni-heidelberg.de (EHLO relay.uni-heidelberg.de) [129.206.100.212] by mx0.gmx.net (mx072) with SMTP; 18 Jul 2012 06:11:31 +0200 Received: from listserv.uni-heidelberg.de (listserv.uni-heidelberg.de [129.206.100.94]) by relay.uni-heidelberg.de (8.14.1/8.14.1) with ESMTP id q6I49bke002445 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 18 Jul 2012 06:09:38 +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 q6HM1IMI014993; Wed, 18 Jul 2012 06:09:37 +0200 Received: by LISTSERV.UNI-HEIDELBERG.DE (LISTSERV-TCP/IP release 16.0) with spool id 2036192 for LATEX-L@LISTSERV.UNI-HEIDELBERG.DE; Wed, 18 Jul 2012 06:09:37 +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 q6I49bMH009871 for ; Wed, 18 Jul 2012 06:09:37 +0200 Received: from mail-vc0-f177.google.com (mail-vc0-f177.google.com [209.85.220.177]) by relay2.uni-heidelberg.de (8.13.8/8.13.8) with ESMTP id q6I48dG8030085 (version=TLSv1/SSLv3 cipher=RC4-SHA bits=128 verify=FAIL) for ; Wed, 18 Jul 2012 06:09:36 +0200 Received: by vcbfl13 with SMTP id fl13so1051742vcb.22 for ; Tue, 17 Jul 2012 21:08:38 -0700 (PDT) Received: by 10.52.67.134 with SMTP id n6mr2343631vdt.23.1342584518631; Tue, 17 Jul 2012 21:08:38 -0700 (PDT) Received: from [192.168.1.43] (pool-173-52-254-193.nycmny.east.verizon.net. [173.52.254.193]) by mx.google.com with ESMTPS id m14sm3350667vdh.4.2012.07.17.21.08.36 (version=SSLv3 cipher=OTHER); Tue, 17 Jul 2012 21:08:37 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:14.0) Gecko/20120713 Thunderbird/14.0 MIME-Version: 1.0 References: <5005AE88.9060108@morningstar2.co.uk> X-Enigmail-Version: 1.5a1pre OpenPGP: url=hkp://pool.sks-keyservers.net Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Spam-Whitelist: Message-ID: <500636C2.9010702@gmail.com> Date: Wed, 18 Jul 2012 00:08:34 -0400 Reply-To: Mailing list for the LaTeX3 project Sender: Mailing list for the LaTeX3 project From: "Joel C. Salomon" Subject: Re: model l3 dtx file To: LATEX-L@listserv.uni-heidelberg.de In-Reply-To: <5005AE88.9060108@morningstar2.co.uk> Precedence: list List-Help: , List-Unsubscribe: List-Subscribe: List-Owner: List-Archive: X-GMX-Antispam: 0 (eXpurgate); Detail=5D7Q89H36p6sJLDpZh614CxMiiOljKSnfiGIjbW052xhorv1BWWMf5trSVfUAY1BcmyQJ NseJk5bmB4JfCNo9gwBxyQJ+vCsCbnApYzdqcBoEZ93JAOkXc3OcJRSH0bGVIH9VtdfE8g8nBRO6 HUpB1iDTlUj/rnCgVvvkOg7Jk+UVHf7Te7nFAn1EgJVbODGWhdYGAkgjcw=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: 7086 On 07/17/2012 02:27 PM, Joseph Wright wrote: > On 17/07/2012 18:38, Joel C. Salomon wrote: >> I've been playing with some expl3 code on TeX.SX, and I'm trying to >> turn some of that code into a package. Since I'm using expl3, I >> figured I'd also experiment with l3doc. (Yes, I know it's labeled >> "experimental"; I want to experiment.) >> >> I started with Joseph Wright's model dtx file from >> , but I'm having some >> trouble adapting it to l3doc. Does anyone have some boilerplate code I >> can build off of? <> >> BTW, should I also be using l3docstrip? > > There are a few approaches to building a .dtx file, as you can see if > you look at the selection on CTAN. You will find 'traditional' .dtx > files, which need an .ins file to be extracted, and 'all-in-one' .dtx > files, which include their own .ins internally. My model .dtx file is of > the latter type. > I've attached a template for creating a 'self extracting' .dtx file > using l3doc, based on the approach I use in notes2bib and siunitx. I've > kept only the basics, and removed some code I use for including demos: > look at "LaTeXdemo" in my .dtx files to see this. > > In the demo, I've stuck with hard-coding in the version, so the > \ProvidesExplClass is less complex than the one you've mentioned. > Although this does not pick up data directly from commits to a version > control system, I think it works better over all. (Certainly if you use > Git or Mercurial.) Thanks; I've used that template to put together a simple package that I've just uploaded to CTAN. Until it's up there, take a look at the repository at . Regarding the use of l3docstrip, I had to downgrade to regular docstrip because the l3 version is not yet in TeX Live. Maybe sometime soon. There are some oddities regarding documenting messages defined with \msg_new:* (they show up in the index with a leading backslash); and I would welcome critique about my documentation style off-list or via the GitHub issue tracker. Thanks for the help, ---Joel