From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/42815 Path: news.gmane.org!not-for-mail From: Uwe Koloska Newsgroups: gmane.comp.tex.context Subject: Re: cont-enp.pdf on lulu Date: Tue, 29 Jul 2008 01:07:43 +0200 Message-ID: <200807290107.43947.ml@koloro.de> References: <488DA374.8060404@elvenkind.com> Reply-To: mailing list for ConTeXt users NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1217286595 4589 80.91.229.12 (28 Jul 2008 23:09:55 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 28 Jul 2008 23:09:55 +0000 (UTC) To: mailing list for ConTeXt users Original-X-From: ntg-context-bounces@ntg.nl Tue Jul 29 01:10:45 2008 Return-path: Envelope-to: gctc-ntg-context-518@m.gmane.org Original-Received: from ronja.vet.uu.nl ([131.211.172.88] helo=ronja.ntg.nl) by lo.gmane.org with esmtp (Exim 4.50) id 1KNbrW-00064P-62 for gctc-ntg-context-518@m.gmane.org; Tue, 29 Jul 2008 01:10:42 +0200 Original-Received: from localhost (localhost [127.0.0.1]) by ronja.ntg.nl (Postfix) with ESMTP id 078AA1FE4A; Tue, 29 Jul 2008 01:09:45 +0200 (CEST) Original-Received: from ronja.ntg.nl ([127.0.0.1]) by localhost (smtp.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 08533-03-4; Tue, 29 Jul 2008 01:09:08 +0200 (CEST) Original-Received: from ronja.vet.uu.nl (localhost [127.0.0.1]) by ronja.ntg.nl (Postfix) with ESMTP id D8B731FDD8; Tue, 29 Jul 2008 01:09:00 +0200 (CEST) Original-Received: from localhost (localhost [127.0.0.1]) by ronja.ntg.nl (Postfix) with ESMTP id 196B01FB74 for ; Tue, 29 Jul 2008 01:08:50 +0200 (CEST) Original-Received: from ronja.ntg.nl ([127.0.0.1]) by localhost (smtp.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 09429-03-7 for ; Tue, 29 Jul 2008 01:08:05 +0200 (CEST) Original-Received: from dd16232.kasserver.com (dd16232.kasserver.com [85.13.137.72]) by ronja.ntg.nl (Postfix) with ESMTP id 7B56C1FE04 for ; Tue, 29 Jul 2008 01:07:46 +0200 (CEST) Original-Received: from bilbo.auenland (dslb-088-072-130-206.pools.arcor-ip.net [88.72.130.206]) by dd16232.kasserver.com (Postfix) with ESMTP id C94F018106443 for ; Tue, 29 Jul 2008 01:07:52 +0200 (CEST) Original-Received: from gandalf.auenland (gandalf.auenland [192.168.0.90]) by bilbo.auenland (Postfix) with ESMTP id 61C0C2A743 for ; Tue, 29 Jul 2008 01:05:30 +0200 (CEST) User-Agent: KMail/1.9.9 In-Reply-To: Content-Disposition: inline X-Virus-Scanned: amavisd-new at ntg.nl X-BeenThere: ntg-context@ntg.nl X-Mailman-Version: 2.1.9 Precedence: list List-Id: mailing list for ConTeXt users List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: ntg-context-bounces@ntg.nl Errors-To: ntg-context-bounces@ntg.nl X-Virus-Scanned: amavisd-new at ntg.nl Xref: news.gmane.org gmane.comp.tex.context:42815 Archived-At: Hello, Am Montag, 28. Juli 2008 schrieb Gerben Wierda: > I have an idea. Why not have a live ConTeXt manual.pdf where you add > something in the proper location and compile the document every time > you answer a question from a user? As you are the person answering > anyway, it should be little extra work. A good idea! But from my pov it should be clarified a bit. We must distinguish between: - a user manual that tells you how to use the system and give you an overview of the whole system and the most important parts (pictures, math, etc.) - and a reference manual, that describes all available commands in detail. The user manual exists (excursion and manual) but has to be revised. The reference manual exists (http://texshow.contextgarden.net/) but is by far not complete. As it is very difficult to make an automated process for producing the user manual, the candidate for the proposed semiautomatic production is the reference manual. Where does the XML-files that are the basis for the existing texshow applications come from? The production of this file(s) has to be somehow bound to the current sourcecode. Then at least all commands are present and "only" the documentation has to be filled in. The last commands I have learned by asking on this list, are all not present in texshow so that I was not able to add the description there ... For the user manual(s) (in my opinion the excursion is a part of "the manual"), there are these steps necessary: - provide a sourceversion that works with the current state of context - identify the portions that are completely out of sync and cut them out (or mark them clearly as outdated) - provide pointers to the more current documentation for every part (and mark differences between mkii and mkiv) - add the missing main features and as a bonus to the reference manual: - make groups of commands that belong together and describe their interactions (something like the portal pages of wikipedia) As far as I understand the situation, the completion of the reference manual is a realistic goal for the near future. And it is possible that everyone helps with this by filling the answers you get on this list into the command descriptions. Wow, this has been gotten longer than I wanted it to be :-) But let me close with a HUGE big THANK YOU to Hans and Taco and the other people that make context such a great tool! Uwe ___________________________________________________________________________________ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context webpage : http://www.pragma-ade.nl / http://tex.aanhet.net archive : https://foundry.supelec.fr/projects/contextrev/ wiki : http://contextgarden.net ___________________________________________________________________________________