Received: from mail.proteosys.com ([213.139.130.197]) by nummer-3.proteosys with Microsoft SMTPSVC(6.0.3790.3959);
	 Tue, 8 Sep 2009 21:29:50 +0200
Received: by mail.proteosys.com (8.14.3/8.14.3) with ESMTP id n88JToNq013447
	for <rainer.schoepf@PROTEOSYS.COM>; Tue, 8 Sep 2009 21:29:51 +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 n88JQ3YC012463
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO);
	Tue, 8 Sep 2009 21:26:04 +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 n88JKUBM022031;
	Tue, 8 Sep 2009 21:25:55 +0200
Received: by LISTSERV.UNI-HEIDELBERG.DE (LISTSERV-TCP/IP release 15.5) with
          spool id 307904 for LATEX-L@LISTSERV.UNI-HEIDELBERG.DE; Tue, 8 Sep
          2009 21:25:55 +0200
Received: from relay.uni-heidelberg.de (relay.uni-heidelberg.de
          [129.206.100.212]) by listserv.uni-heidelberg.de (8.13.1/8.13.1) with
          ESMTP id n88JPtL3014198 for <LATEX-L@listserv.uni-heidelberg.de>;
          Tue, 8 Sep 2009 21:25:55 +0200
Received: from fmmailgate03.web.de (fmmailgate03.web.de [217.72.192.234]) by
          relay.uni-heidelberg.de (8.14.1/8.14.1) with ESMTP id n88JPbhd011987
          for <LATEX-L@listserv.uni-heidelberg.de>; Tue, 8 Sep 2009 21:25:40
          +0200
Received: from smtp07.web.de (fmsmtp07.dlan.cinetic.de [172.20.5.215]) by
          fmmailgate03.web.de (Postfix) with ESMTP id 85201113BA2E6 for
          <LATEX-L@listserv.uni-heidelberg.de>; Tue,  8 Sep 2009 21:25:37 +0200
          (CEST)
Received: from [89.50.22.161] (helo=uwe.lueck) by smtp07.web.de with esmtp
          (SSLv3:DES-CBC3-SHA:168) (WEB.DE 4.110 #314) id 1Ml6Jq-0001CK-00 for
          LATEX-L@LISTSERV.UNI-HEIDELBERG.DE; Tue, 08 Sep 2009 21:25:34 +0200
X-Sender: uwe.lueck@pop3.web.de
X-Mailer: QUALCOMM Windows Eudora Version 5.1
References: <Your message of Tue, 08 Sep 2009 15:12:17 +0200.  
            <5.1.0.14.0.20090908150936.03045ec0@pop3.web.de>
Mime-Version: 1.0
Content-Type: text/plain; charset="iso-8859-1"; format=flowed
X-Sender: uwe.lueck@web.de
X-Provags-ID: V01U2FsdGVkX18UObNR72uj/83o89iIViRs7irbijVVJeg/bKpR
              b5cW8MERFZxDTTN0tkl3TFbd/sPPNGHGCN9fqg1n5+h1H1ka+v xqxdaN6tg=
Content-Transfer-Encoding: 8bit
X-MIME-Autoconverted: from quoted-printable to 8bit by
                      listserv.uni-heidelberg.de id n88JPtL3014199
Message-ID:  <5.1.0.14.0.20090908170522.0339ca70@pop3.web.de>
Date:         Tue, 8 Sep 2009 21:08:53 +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: Uwe =?iso-8859-1?Q?L=FCck?= <uwe.lueck@WEB.DE>
Subject: Re: l3doc, was Re: xparse
To: LATEX-L@LISTSERV.UNI-HEIDELBERG.DE
In-Reply-To:  <20754.1252419310@cl.cam.ac.uk>
Precedence: list
List-Help: <http://listserv.uni-heidelberg.de/cgi-bin/wa?LIST=LATEX-L>,
           <mailto:LISTSERV@LISTSERV.UNI-HEIDELBERG.DE?body=INFO%20LATEX-L>
List-Unsubscribe: <mailto:LATEX-L-unsubscribe-request@LISTSERV.UNI-HEIDELBERG.DE>
List-Subscribe: <mailto:LATEX-L-subscribe-request@LISTSERV.UNI-HEIDELBERG.DE>
List-Owner: <mailto:LATEX-L-request@LISTSERV.UNI-HEIDELBERG.DE>
List-Archive: <http://listserv.uni-heidelberg.de/cgi-bin/wa?LIST=LATEX-L>
X-ProteoSys-SPAM-Score: -6.599 () BAYES_00,RCVD_IN_DNSWL_MED
X-Scanned-By: MIMEDefang 2.65 on 213.139.130.197
Return-Path: owner-latex-l@LISTSERV.UNI-HEIDELBERG.DE
X-OriginalArrivalTime: 08 Sep 2009 19:29:50.0641 (UTC) FILETIME=[BBCE9A10:01CA30BA]
Status: R
X-Status: 
X-Keywords:                  
X-UID: 6095

At 00:58 02.09.09, Manuel Pégourié-Gonnard wrote:
>I prefer package code to be the primary content and documentation to be 
>extracted from comments. I find it much easier for changing the code and 
>testing it without needing ot extract it first. (Same problem as dtx.)

At 16:15 08.09.09, Robin Fairbairns answered an answer to the previous as 
follows:
>i don't mind dtx, particularly (i've been writing it for >15 years, and
>my fingers wander to the necessary groove without prompting).
>
>however, there are quite a few (significant) packages on ctan that have
>lots of documentation as comments only.  if i could take one such and
>produce a useful printable document, i could improve the quality of user
>support quite a bit.
>
>(i've dallied with editing the comments into a separate .tex file.
>this works, but is time-consuming, and tempts one into editorial work.)

Indeed I hope to do this (including automatic ASCII to LaTeX) with 
'makedoc' and plan to apply to the development fund for it. It works with 
my own preferred ASCII style to some extent now, but other authors use 
different styles. At present only lines starting with `%% ' are considered 
"smoothly" typesettable comments, in order to allow "commenting out" of 
code that then is to be typeset verbatim. With 'wiki.sty' I have also 
implemented some ASCII representation of list-like environments, but 
package authors have different ideas for such ASCII representations. 
'makedoc' must be made adaptable to such styles, and it needs some tidying 
to be useful before.

My first focus is on Donald Arseneau's packages. I think 'natbib' has 
"internal" documentation of this style, PiCTeX as well, but such packages 
seem to have some other well-typeset documentation already.

Wait what happens ...

     Uwe.