User-Agent: Thunderbird 2.0.0.22 (Windows/20090605)
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>
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Message-ID:  <4A9CCC56.80001@morningstar2.co.uk>
Date:         Tue, 1 Sep 2009 08:25:10 +0100
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: Joseph Wright <joseph.wright@MORNINGSTAR2.CO.UK>
Subject: Re: l3doc, was Re: xparse
To: LATEX-L@LISTSERV.UNI-HEIDELBERG.DE
In-Reply-To:  <E6A84A92-B935-4144-9618-6BA45293958F@gmail.com>
Precedence: list
Status: R

Will Robertson wrote:
> On 01/09/2009, at 5:39 AM, Joseph Wright wrote:
> 
>> I'd noticed that too: Will is in charge of l3doc! (Seriously, I think
>> l3doc needs a good overhaul but Will did take charge of that part of
>> expl3, so for the moment I'm leaving well alone. He has lots of plans, I
>> think.)
> 
> Ha :)
> Some things all in my head, but I don't know whether to start with
> something like xdoc2 or gmdoc as a starting point.
> 
> I just put into expl3 whatever made it easier for writing the test suite
> and improving (piece-wise) the documentation. Indexing is a part that I
> didn't spend too much time on -- partially because I rarely use them
> myself!
> 
> I'm not saying that I'm abandoning l3doc in its current state or
> anything at all like that, but if you do feel the urge to tinker around
> then by all means go in there and tear it apart.
> 
> Which is another way of saying that if you don't see me making changes
> in there, then I'm not working on it and the whole thing is fair game;
> don't stay away just in case you feel you're stepping on my toes --
> you're not.

Hello Will,

I imagine that l3doc is going to be a "work in progress" for some time
to come. It seems to me that, as bits of LaTeX3 get written, l3doc is
likely to be the first place they get used as it is the one document
class that really can depend on the state of LaTeX3 at any given moment!

I'd imagine that the code needs a careful overhaul at some stage, as
things are very much a mish-mash at the the moment. However, that
depends on what we want, as you say. For example, the gmdoc approach of
not needing \begin{macrocode} ... \end{macrocode} is interesting: I
wonder if it makes it easier for new users to write documented files?

I might give this some thought and see what happens, but that depends on
what I do with other ongoing things!
-- 
Joseph Wright