From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 31174 invoked by alias); 20 Jan 2014 11:29:38 -0000 Mailing-List: contact ecos-discuss-help@ecos.sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: ecos-discuss-owner@ecos.sourceware.org Received: (qmail 31158 invoked by uid 89); 20 Jan 2014 11:29:37 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-0.1 required=5.0 tests=AWL,BAYES_05,RCVD_IN_DNSWL_NONE,SPF_NEUTRAL autolearn=no version=3.3.2 X-HELO: gateway06.websitewelcome.com Received: from gateway06.websitewelcome.com (HELO gateway06.websitewelcome.com) (67.18.125.13) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Mon, 20 Jan 2014 11:29:36 +0000 Received: by gateway06.websitewelcome.com (Postfix, from userid 5007) id 922CE6F4B2AD1; Mon, 20 Jan 2014 05:29:34 -0600 (CST) Received: from ham05.websitewelcome.com (unknown [184.173.222.181]) by gateway06.websitewelcome.com (Postfix) with ESMTP id 7BE056F4B2A90 for ; Mon, 20 Jan 2014 05:29:34 -0600 (CST) Received: by ham05.websitewelcome.com (Postfix, from userid 500) id 6852A3F6AB816; Mon, 20 Jan 2014 05:29:34 -0600 (CST) Received: from montecarlo.websitewelcome.com (montecarlo.websitewelcome.com [192.185.12.42]) by ham05.websitewelcome.com (Postfix) with ESMTP id 5A1013F6AACC5 for ; Mon, 20 Jan 2014 05:29:31 -0600 (CST) Received: from [213.115.176.230] (port=41169 helo=[192.168.0.232]) by montecarlo.websitewelcome.com with esmtpsa (TLSv1:DHE-RSA-CAMELLIA256-SHA:256) (Exim 4.80) (envelope-from ) id 1W5D2o-0007o3-6X; Mon, 20 Jan 2014 05:29:31 -0600 Message-ID: <52DD0898.3080308@siva.com.mk> Date: Mon, 20 Jan 2014 11:29:00 -0000 From: =?UTF-8?B?IklsaWphIEtvY2hvIFvQmNC70LjRmNCwINCa0L7Rh9C+XSI=?= User-Agent: Mozilla/5.0 (X11; Linux i686; rv:24.0) Gecko/20100101 Thunderbird/24.2.0 MIME-Version: 1.0 To: bob.brusa@gmail.com, ecos discuss References: <52D6CC97.9080303@gmail.com> In-Reply-To: <52D6CC97.9080303@gmail.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-BWhitelist: no X-Source-Sender: ([192.168.0.232]) [213.115.176.230]:41169 X-Source-Auth: ilijak+siva.mk X-Email-Count: 1 X-Source-Cap: c2l2YW1rO2JpYmltYW47bW9udGVjYXJsby53ZWJzaXRld2VsY29tZS5jb20= X-IsSubscribed: yes Subject: Re: [ECOS] How to read ecos docs given in sgml-format X-SW-Source: 2014-01/txt/msg00013.txt.bz2 Hi Bob I have a little comment on your remark regarding SGML format used by eCos documentation (AKA DocBook). On 15.01.2014 18:59, Bob Brusa wrote: > > > I could not find an alternative to the above (mean - converting sgml > to a pdf - sgml in a text editor or browser is ugly). It seems, no > reasonable reader exists for the sgml format. This lets me wunder why > the documentation is presented in this now arcane format. Why not > include these files as open data text (odt) as used by e. g. OpenOffice? It may look arcane to you, but it's widely used ref: http://docbook.org (though it would have been better if it was XML version). I would encourage you to try editing some eCos doc page (or even produce your own). It's not so hard, and you'll see the first advantage vs some kind of Office - you can use your favourite text editor. Other advantage is ability for versioning with common version control system. You'll discover more once you try it. Regards Ilija -- Before posting, please read the FAQ: http://ecos.sourceware.org/fom/ecos and search the list archive: http://ecos.sourceware.org/ml/ecos-discuss