User-Agent: Mozilla-Thunderbird 2.0.0.19 (X11/20090103)
MIME-Version: 1.0
References: <4A7921CF.5020803@morningstar2.co.uk>                              
            <4A86949D.3090500@morningstar2.co.uk>                              
            <4A886BA8.2000209@morningstar2.co.uk>                              
            <0417DF73-EC19-4262-B9DF-5C870D47BFCE@gmail.com>                   
            <4A893816.2090807@residenset.net>                                 
            <4A89610D.8060108@morningstar2.co.uk>                              
            <4A8C71CC.7000006@residenset.net>                                 
            <4A8D0048.4070101@morningstar2.co.uk>                              
            <4A946AD7.4020506@residenset.net>                                 
            <4A9C2DF7.6070002@morningstar2.co.uk>                      
            <E6A84A92-B935-4144-9618-6BA45293958F@gmail.com>           
            <4A9CCC56.80001@morningstar2.co.uk> <4A9CF90D.5030100@elzevir.fr>
            <39E0419A-5258-449B-8581-6880FEB3E177@gmail.com>
OpenPGP: url=http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x50A89B42
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 8bit
Message-ID:  <4A9E63A8.4060409@elzevir.fr>
Date:         Wed, 2 Sep 2009 14:23:04 +0200
Reply-To: Mailing list for the LaTeX3 project
              <LATEX-L@LISTSERV.UNI-HEIDELBERG.DE>
Sender: Mailing list for the LaTeX3 project <LATEX-L@LISTSERV.UNI-HEIDELBERG.DE>
From: =?ISO-8859-1?Q?Manuel_P=E9gouri=E9-Gonnard?= <mpg@ELZEVIR.FR>
Subject: Re: l3doc, was Re: xparse
To: LATEX-L@LISTSERV.UNI-HEIDELBERG.DE
In-Reply-To:  <39E0419A-5258-449B-8581-6880FEB3E177@gmail.com>
Precedence: list
Status: R

Will Robertson a écrit :
> I've written a couple of packages using gmdoc (pstool and asyfig, off
> the top of my head), and the feeling I get when opening up the source
> and seeing empty lines and no '%    \begin{macrocode}' is quite
> refreshing. The code is easier to come back to because there's a lot
> less visual cruft (which is easy enough to ignore while writing the code
> the first time).
> 
That's exactly my impression: I can cope fairly well with dtx while writing for
the first time, but find it more difficult to edit afterwards.

> The only attempt at this so far have been to output a list of commands
> defined in the package, if desired, in an external file \jobname.cmds.
> 
That's already a first step :-)

> My feeling so far is that since we're writing free-form documentation in
> LaTeX plus the little structured pieces of information (e.g., function
> names and a description of their arguments) it makes more sense to
> export the desired structured parts as the document is compiled.
> 
I agree. Maybe it would be good to make the structured part a bit more
important, this certainly needs quite a bit of thinking...

Manuel.