From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/81375 Path: news.gmane.org!not-for-mail From: "Keith J. Schultz" Newsgroups: gmane.comp.tex.context Subject: Re: upto current Date: Mon, 25 Mar 2013 09:02:39 +0100 Message-ID: <3F06978B-6930-45F0-BFB5-71E27AD0B786@web.de> References: <5148AB62.50002@wxs.nl> <2F2ABC1E-124E-424D-94B4-E3CBF448E88A@web.de> <20130320092558.1d0f33cd@aga-netbook> <3C82073C-9A1E-4DE2-AFB5-BDE3C0550994@web.de> <20130321113201.365016f8@iram-hb-003386.extra.cea.fr> <20130321152603.13688b88@aga-netbook> <710C7AA9-2A41-4793-841A-CC0757540CDC@web.de> <514C685A.1000609@meahan.net> Reply-To: mailing list for ConTeXt users NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 (Mac OS X Mail 6.3 \(1503\)) Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1364198566 27795 80.91.229.3 (25 Mar 2013 08:02:46 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 25 Mar 2013 08:02:46 +0000 (UTC) To: mailing list for ConTeXt users Original-X-From: ntg-context-bounces@ntg.nl Mon Mar 25 09:03:13 2013 Return-path: Envelope-to: gctc-ntg-context-518@m.gmane.org Original-Received: from balder.ntg.nl ([195.12.62.10]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UK2N7-0005Kd-1g for gctc-ntg-context-518@m.gmane.org; Mon, 25 Mar 2013 09:03:13 +0100 Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id B0EC4101E3; Mon, 25 Mar 2013 09:02:48 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at balder.ntg.nl Original-Received: from balder.ntg.nl ([127.0.0.1]) by localhost (balder.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP id kuRZ8jaKXCyy; Mon, 25 Mar 2013 09:02:46 +0100 (CET) Original-Received: from balder.ntg.nl (localhost [IPv6:::1]) by balder.ntg.nl (Postfix) with ESMTP id 7737F101E4; Mon, 25 Mar 2013 09:02:46 +0100 (CET) Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id E392C101E4 for ; Mon, 25 Mar 2013 09:02:44 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at balder.ntg.nl Original-Received: from balder.ntg.nl ([127.0.0.1]) by localhost (balder.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP id bTyywlpWy9GO for ; Mon, 25 Mar 2013 09:02:42 +0100 (CET) Original-Received: from filter3-til.mf.surf.net (filter3-til.mf.surf.net [194.171.167.219]) by balder.ntg.nl (Postfix) with ESMTP id D91F3101E3 for ; Mon, 25 Mar 2013 09:02:42 +0100 (CET) Original-Received: from mout.web.de (mout.web.de [212.227.17.12]) by filter3-til.mf.surf.net (8.14.3/8.14.3/Debian-9.4) with ESMTP id r2P82f2s028200 for ; Mon, 25 Mar 2013 09:02:41 +0100 Original-Received: from [10.0.62.4] ([84.58.248.121]) by smtp.web.de (mrweb002) with ESMTPSA (Nemesis) id 0M09uu-1Uf97U3aYO-00uYQp for ; Mon, 25 Mar 2013 09:02:41 +0100 In-Reply-To: <514C685A.1000609@meahan.net> X-Mailer: Apple Mail (2.1503) X-Provags-ID: V02:K0:tYx9bffXZzeiNlNNsGAKxqJjkd9A7m49kDFoGIojdBR +NF04U5HrK7CLZzV9e/45by1v2ef7V0v2DvCyWvFggF2DDTFHm aYqaY17wsQ5YJcwK/VZXn4a/ZaS+Xn7nWcrUIRTgpaJtvIgmOs 3rKdaukd7ukWm95J53LzmCugsiZFjakNTrgXfetr59t2z41Wd0 gb16EaabdA2K8T7Vha58w== X-Bayes-Prob: 0.0003 (Score 0, tokens from: @@RPTN) X-CanIt-Geo: ip=212.227.17.12; country=DE; latitude=51.0000; longitude=9.0000; http://maps.google.com/maps?q=51.0000,9.0000&z=6 X-CanItPRO-Stream: uu:ntg-context@ntg.nl (inherits from uu:default, base:default) X-Canit-Stats-ID: 06JfI2FXW - dfbdf3f4a9dc - 20130325 (trained as not-spam) X-Scanned-By: CanIt (www . roaringpenguin . com) on 194.171.167.219 X-BeenThere: ntg-context@ntg.nl X-Mailman-Version: 2.1.14 Precedence: list List-Id: mailing list for ConTeXt users List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ntg-context-bounces@ntg.nl Original-Sender: ntg-context-bounces@ntg.nl Xref: news.gmane.org gmane.comp.tex.context:81375 Archived-At: Hi Bill, Am 22.03.2013 um 15:19 schrieb Bill Meahan : > On 03/22/2013 03:31 AM, Keith J. Schultz wrote: >> Hi All, >> >> Maybe, we could setup a collaborative work group to do the documentation. >> >> That is a group of us are responsible for certain groups of commands. This way >> the manuals can become more complete. That way some of the more advance >> stuff that is hardly documented finally gets documented. >> >> What we would need is a specification for: >> [snip] > In 45+ years of programming[1] it has never ceased to amaze me how the wheel has to be reinvented for every new system whether language, macro package or whatever. Why do it again? Why not adopt some documentation system that is already widely-used and for which infrastructure and knowledge of use is already in place? I agree with your statement fully. Specification is a loaded word, too! What I was trying to say that we need convention how things are to be laid out! Setting up, maybe, a module to facilitate a common look. Otherwise the manuals will be a mess of styles and clarity. > I have no investment in any particular system. I'm happily generating other types of non-computer-related documents using reStructuredText since I can easily convert that various publication formats as required without separate source files for each format. It seems to me docutils has everything that would be needed to document ConTeXt and is very widely used given the popularity of Python (which makes me cringe). If doxygen or something else would work better, so be it. The point is, **use something that exists instead of expending time and effort reinventing the wheel yet again!** I was thinking of using ConTeXt! > > [1] I was, am and will be a "programmer" and not a "software developer" or "software engineer." The term adequately depicts what I did/do while the others are simply too pretentious. Find the old article "Real Programmers Don't Use Pascal" in an archive somewhere -- I've been a "real programmer" and I suspect Hans is, too. :) > > Sorry for the rants but it is so frustrating to have to install so many different language support and documentation systems simply because I use FOSS tools exclusively. No Problem. regards Keith. ___________________________________________________________________________________ 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 : http://foundry.supelec.fr/projects/contextrev/ wiki : http://contextgarden.net ___________________________________________________________________________________