User-Agent: Thunderbird 2.0.0.21 (Windows/20090302)
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Message-ID:  <4A2F5C37.5080305@morningstar2.co.uk>
Date:         Wed, 10 Jun 2009 08:09:43 +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: l3doc
To: LATEX-L@LISTSERV.UNI-HEIDELBERG.DE
Precedence: list
Status: R

Hello all,

Will has worked quite a lot on l3doc. One of the newer ideas to to
replace the old \StopEventually / \Finale idea with:

\begin{documentation}
...
\end{documentation}
\begin{implementation}
...
\end{implementation}

This is, I think, a good idea. However, I wonder if a second level of
control might be a good thing. At the moment, the first section contains
all of the documentation. However, if you consider some user package, it
would be helpful to have the user functions and internal stuff
documented separately.  I wondered about:


\begin{documentation}
  \begin{user-functions}
   ...
  \end{user-functions}
  \begin{internal-functions}
   ...
  \end{internal-functions}
\end{documentation}

or

\begin{documentation}
...
\end{documentation}
\begin{programmers-documentation}
...
\end{programmers-documentation}

or ...

What do other people think?
-- 
Joseph Wright