From cocoon-dev-return-18605-apmail-xml-cocoon-dev-archive=xml.apache.org@xml.apache.org Sun Nov 11 16:18:45 2001 Return-Path: Delivered-To: apmail-xml-cocoon-dev-archive@xml.apache.org Received: (qmail 38206 invoked by uid 500); 11 Nov 2001 16:18:44 -0000 Mailing-List: contact cocoon-dev-help@xml.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: list-post: Reply-To: cocoon-dev@xml.apache.org Delivered-To: mailing list cocoon-dev@xml.apache.org Received: (qmail 38195 invoked from network); 11 Nov 2001 16:18:43 -0000 Message-ID: <3BEEA3C7.5040107@i-one.at> Date: Sun, 11 Nov 2001 17:13:59 +0100 From: "Bernhard Huber" User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:0.9.4) Gecko/20011019 Netscape6/6.2 X-Accept-Language: en-us MIME-Version: 1.0 To: cocoon-dev@xml.apache.org Subject: Re: documentation of components in */cocoon.xconf References: <01110516444301.01097@igacer> Content-Type: multipart/mixed; boundary="------------060104040506040806090408" X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N --------------060104040506040806090408 Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Hi, david I was making some effort to documentation of cocoon. As I was writing a transformer for URL rewritting I was trying to make some more formal approach to documentation of this cocoon component. (I was some what jealousy about the well document structs project.) I was extending the idea of faq2document.xsl approach. Perhaps the DTD for cocoon-components is not general enough, at the end cocoon-components should be for documenting, and generating deployment descriptors. I was only taking a quick look at xdoclet approach, which extends doclet. Using this approach you write more javadoc @tags in your java-source code, and special ant taks will generate xmlish-documents. Any ideas? I put a zip in the attachment containing the xml, and xsl files, including some template. I hope this helps, at least that more, and better documentation of cocoon is created. David Crossley wrote: >One of the big todo items before final release is to >document everything in cocoon.xconf >There are various xconf files: > documentation/cocoon.xconf > webapp/cocoon.xconf > webapp.site/cocoon.xconf > webapp.tutorial/WEB-INF/cocoon.xconf > >Before we all dive in and document our favourite component, >i thought that it would be a good idea to tidy these files to >make them more readable and consistent. There were a lot of >differences that were not necessary (e.g. indentation) >so i fixed that. I also added consistent structure for the >comment section for each block. I have not added anything >new - just aligned and tidied the files as a start. > >Now it can be more clearly seen that there are some differences >between the various xconf files. Anyway, we can each >attend to that, now that there is a consistent base. > >I am holding back on these commits, because today is RC2 >day. Should i do it now or later? >cheers, David > > >--------------------------------------------------------------------- >To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org >For additional commands, email: cocoon-dev-help@xml.apache.org > --------------060104040506040806090408 Content-Type: application/x-zip-compressed; name="cocoon-component-doc.zip" Content-Transfer-Encoding: base64 Content-Disposition: inline; filename="cocoon-component-doc.zip" UEsDBBQAAAAIACOGayuFFLILCAQAALcYAAAbAAAAY29tcG9uZW50LWRlc2MyZG9jdW1lbnQu eHNs7Vlbb9MwFH6ftP8QgsRbZgYS0kZakEBIkxBIbCBevcRdg5I4+LKu/x5fcrEdt066TgiJ vGR27O985zv2sU+XvnuoyugeEVrgehGfn72M3y1PT05P0gdaXlK2LRFdI8ROTyLxiLE1vRRf FvGaseYSgM1mc7Z5fYbJHTi/uLgAP68/gxsCa7rCpIr1LAtdgz9LkmhxlCdKkmULmOOMV6hm EUUZEwaNT2GcKY8GlE4pdRiqmhIyFFWQZetFDKRz0uG0Y9K2Rc8awRyRvi16WMFKtFRA97Dk KMErQbwU1BdxhqsG1wIA5AUVNrZJDSsUg2UK9LQeFzjA6S3Ot6YZiQ+bptwmHV0KjOnG8BRY tFNg+rjP755t7z89H0woAoyR4paLKdKPRayciHc4P3LZQhiAG9fNERLlVQXJNjYdHmalDN4a UsoOM0CynS9vtg0SoudL2QgEK2FisA5SbsICRgJWvghXJ1sZlsJMKx9KSOlkM5RkASuiYSk4 ISI5ohkpGrk750RF8v2GfvOCILk+Q04QY+hMpZROMBO7SrAIadWNO8DGNYOMh/ygatAB6D90 xg3At3l5fpSteNFXkdrOi/i63W4mEi/tZVgWVlv0/OJVE8E6W2OyiD/gelXccQLVCllazRTI oe50x4Dqk96K8ydBIkCelZ2ZqCCzTbpgPs5tP2UE13c7xO13aTvKh/Di+fmbl2+92BPzmTED eGjq3NlJ4UoH3OC4EKFoXSPGm3ipXkeLDpVogGro/9EwOgLRuKobLo5g9TpaNAqJBnLI4K5g TEn0f0OOr5wpPfT7aIJgBfdPKvKdwjtx61Kvo+nBJRpAD1DcCdE8RQSIPKKfRA3ru9j2r/pG 36lliYrcPXbMDa2Yi3GYItuc7N+sUR2JC/Xu08UVxHcdD51QToLRskjTY0KYrRHZFA7XSJ7Z X3DknKaNB9YHoL84GvhU1MeBca0zrgZuOp+vq/dEmKgndZipqZN0jBx7UsgaPVK84HrUqdyr ZJvlHSXDEhQuZIhDmz+9JLrcOpsFHoGGaOik5WXR5rPZJLgLOXAQf+rS9YDq17/zU8M/zc9f C1ubc8eN431fYFpADr6/2O+dHHmmdd/hm88jpx4YVR/dVUxXtd29bH8t4itq7TJkZObjcKAG wN2jd7qNtqSx8TPcbP0XwTnQbT2bT6tl89nirCAv2X7iuR60B9ou/vbur+4K0C+4oU6ct+S8 CX/30j4MvDDT6AzwCdDYSo7HIW5eN42fWaYs9y6Q3SzP9pUL5KpmiKxgFvrRQzIR6rWDu6Uz Wo0S4BMmgv4UvJUa6QE7eP0dtiq4eaI8VuenIWsanUr0bERvjkXnbh+0NlzrvZKMsifmJNur hO4c/hchuv8AUEsDBBQAAAAIACx8aysIit7oiwUAAJIkAAARAAAAZG9jdW1lbnQyaHRtbC54 c2zdWltzozYUfs9M/oNKpn1pHGwn3UlS7M0P6PSlfehbRxYCtBGICjmX7ua/9wgkEA6KL43t yfISBOJcPp3zHR050eennKMHKismilkwuRgHn+enJ6cn0VPFbyv1zGmVUapOTxBcMLeobuHN LMiUKm/D8PHx8eLx8kLINJzc3NyEf/3xW/inxEWVCJkHzVc96Y3wH0YjNHuXC41GcyMwFmSZ 00KhihIFCp1X6+VscjUCtVM1OormJceKohwrks2CUDunHY4ylXNzr0cUx+0IxoopTue1iAfM l3QkEjCZg9EAK8ylMqynBOE8au46WWFPWLQQ8TNS9Am+PBvXV4A4K+718PIGExKgBzseX39a TAOEzZiQenpnlxJljmXKYKGuQApNlDNsbh9ZrDJnnFGWZko/6MQsUiK4kKAhqa/AdV37jMuS P48seFXoOKfdsRiGLYhR6KKtH3mXwIZAuxJeha+E7isqmxU9Vkw22ls4tF6WFkJSY1fVfN8E kzwwNHX07hcYDyxa804x4pFXTYy0KGYPOsVSSBupk6PVovCCU3BZAuqzAPLUJNPN9Y8BIpTz qsSEFWn9To9LHMf1+KpLoUjJHpPEVspkPAYxXe6ZbHcmw/REaHJk/9JZ8PMkQAkmcIclw/w8 o/yBKkbweQXkTSVLwAhvHtfSFh4Ku+vIC6aEWqn7KVCaQ2Bh5xDca4ja4fsDFqkeD9dwbAqC Ydf5cLSsuulzsudjFEKwmNs3cs8XctPdQ+6Xw4bcRw20nWH6vgLtcvdAGx+D20YfmNt2Buz7 CrmrnUPu+sDcZkJu+mFDbnfAPmLI6a/2tZ1NhFCH2OkPpkyjvFkpd5sPhqS0oBLztj+2e/6D 7fNLLHEqcZkdqwsqW9ooLZt8WVaKJc/+CCy35KwC8LesVfZZqkcqvVS7fJVqToaup6npNfT3 xiFo31f4ieUpqiSZBSzHKTilLbxIdRY6n9sWfnoDorRdtCaArLt1KANzmPm7djR0DQr7RAD2 +Y3asU5bvlghTbbyAK05YjBzwv53r1h1Q77ZNkQqsZSkDRKntBHISqdLb6KmFyhX/kCZdN91 YaIX4fVJTFRK6g94/a5zfD3Nbu54wp7y1u8+OVlSwh0vDEreDzNxVh3guHAQkyX/Jvi3mBvK XnBB7v9ZClul6m+IKNvzMH9cN2i1c2Gf0JM1eHw2aBJnxpi+7nUHJHbmUDwM54F1esnXa2jm bCw7NlvEiJscjyolRZF6dlcX9cbKTOls0UeqczRq1T4pv6GtrDgGYQg1p5Nho/9gkdxwxpHq a618hb76O+muhvRobbpCa84WOyK41L54Fs68rZfPzmw/faMGuFy2OYEp6ZKsj0ENYW4hNuvE unxtz+5hDFBBgfh6Z25fAiTFo31obl+6XYCpJMOFBZnyu1IWNi/HrRzU9isDMCzmP51NPo1/ bZW65bWtMFugFA+jhMdxnIx3QUlvSyxE+ocOH0D2J5WdABpE552RKYaRsQu7MTKt3a59foOQ /xcYm5fWLqfaV6wgFGCXFMfPaFnR+OD1PsfyflkeqeI3VcZug97Kn9MtCh7NW6yZV6SvFnnW UMQdm+vB3G3uCexiGZXnKBeFqNuEeE0fDwythQyZsLdmvOl5jtWMs3QpDYRdy2nJuGvMvt7B nxfTV329gz8vvVppG7KrriG7CtrmdPONHSi0Yff/dPfP4sKtooqRlhY2t8Low4sqZ3HMqVfn vvqD4v5YQaR1W7wwyiRNNEL674s/3/CWiV4U4Juz6x/aNW0s7ssyLz0Wn8HaFiQT8t1sT4T0 wgO7YZlSiKi/FxxrFN9HZeNBp7TAOdVKWWy9IiLXzey8mWnbo+bZsDZdSvcVvVVJCWxUjhXA C3scaU5jh7K2ftT9mxE8/A9QSwMEFAAAAAgAFoVrK7x/S/6wCAAAxiMAABgAAABlbmNvZGVV UkxUcmFuc2Zvcm1lci54bWzdWe9z27YZ/p67/A8I+8V1JLJO1ruuR9FxE+3inZ26sbKt18vt IBKScKVIDgBle8v+9714AZIAKdpx4q3N9EUi8OL9+bwPQCg+vt7mZMeE5GUxC47CbwLCirTM eLGeBaeXP06/++7bP06PguPk8aPHj+Inr358ufj5Yk7ScluVBSsU+cVMzM/m5/M3C2fiIOOy yunNtKBbNukmpuqm8p7781KkE/L4ESEZk6nglQLfJvpZsH/UXLAtCElYQNMNo8sc1kpFVQ1D NpAJobXalELiKllvt1Tc4O/OSFoWK76uBdXaDz3zTNXVcU+cF1Wt+oNlrfaM1pKu2bEe+zrx c+MmhBx8dfHy1cnipC/k58kT2yc00LVPCDJKPsKglxNy4D0+NbpPFouz08vxRegzmiFfvZ3/ 9O707fzVqD3MNDnAr6fjbmHuAU5U0cOxCE0p9grpIZhwsIRDoFYxsaIps8+rUmypmhB2TbdV zp4OtXRLRjLu6PmIdCNQep65xv1VXmlMy9h+yCAAtqJ1riZey7TIH9VqC/BA2m6BYqN7LG/G 4GjOHD9GNFjnRjW41DHWLg2fjJlAkhmZtMwzMmvpiBxUINb2UjNrBsn8/GLxs9dkdgLzOuyp gRzbUp43gqfnF2eng96zpdO9vdW5gKqWtUjZoK22yOD784ArvMn3xkwL7USzX+zSXTLXuwp7 9/ZsIWghdY8wEUeeCC7y6S9RrnRvriePOlhjxpXepx0oMSnFOqSVLnuYlmlZFmGJGKN52NrF hgv3e+9r0ynQUXdYRZuELDZcEicQAo+IM1WSrIQmlAgd0A4wvRJcweYbmqWnilzxPNdi3bSe J6CKUKUEX9aKkR3NawYbIJVEVizlK84yo2HHKeFFmtcZM3tFBauYQKqBUcl3jFCwgE89GevE a6WqS+ukYLucUcAGL9rs6HhSmqd1ThW0uLYomITMSBa29Tj4mmwZdEGGSqHyvTThqNulNnmX TIBFNS/WvGBtmz0LjwgkYMPXGyYm5M90R9u5o/B5N2etDRTHbbcnp0KwnO0gqBBK2g6jlOn5 ZH4NLcb1aprHkR1EAWs0+Ys1/k14FEfNIErY3rfhxE5Pz4LX9VK7/wPkekNFFpgWngUwWvC/ b/TsC3oUFkwFkdEWueqMi4b5khYwGl0ECsFLYCtF5a8aZxyKIZRBDVQ758WvMLlhPurIlhY1 zN+Y8xcBiR50NyyvZAPOQipGM1KuAJ96dVtsR4813FdkNPACfah4xcAjFpqIIjekXtsOTxuz QHIFeauCJsWejB2EYWQBtxXiqCUGFGg2qeRN2SIm66btJtUOEPLDTbtzeS0GocLOCmnvRAkJ wsPoxUaw1Qf9g6bauQ8rAfLRC6CPIGwNRX1LezhFf05dm5syz3ThBVtDHwro50qYng0NAQ0n Ok0wDa0MyM8IXVMomSIMGoFAX2jQTzuioULwna41HdY0dF3DwqY19JYmC73pYPsYvnAdR8Na IygrixxSCpWeOL6tfG5q5VfQKtK1uSK0cDjRRASkyG1PpLTIOBzRGLbBPrrVn7mhRXBzA2xq WIRAylKWAb6BtDfURoDJdas2LFKvO62bOjUYS+m7LF2fpSF14lXJbgDMtds3EdtN3rEZ2x3d GWrhY9g/t0ejDbXVbbKoEYsnQujP7x2N0VBlbE4GSfzkFzwZwJthDH35fQsR268tTQQYHIB/ FnzeVmxaP3ZxlTTtFkfeMAq6gEriyHsEpyPPayfC9+9B2kbZFaCf7/9GAdx1AOOmhXAtpnag AAmm0zNxNZhyfonV/KBFGvr8X5dWp2m4tdy637j2H3K/8Six3W9IwLfrT91OTvZsEZOObi3A EH0dY/n82wrLOk0Zy6TZIzoww4P1PCMrUW59Fp6gcn3g7bQWpSJrHRyTzeGSF3DW7G8H4ZdC 4Tqgh6Tx+XXHBOCG9QLcAii0rPDFMnh4eGeTI+S13G9E424B9EWbgwU4SXGYabnZdOsWgI6E wQzgeYp3Uv/fBQIXPpigzW8dNP66R90+naXdd/XhLEo8mU57N5ONPveh4fVP5PI3oP4OQr6D he5HFLdi6O5EdpF7lx16dDrtUte7qm2W69vQ/TF2zvzt/IyY+128pl0yKDnrXiQdAAKBl6ne lZzT+kiu/LvaBGy8LAtIG944+XP+GtMCjnsnxQ3R/5AYF6USjG5DcmGuRwZ3LfrD/dcb0+HD Fxggh05vtxr3RNwzTW3cSPc4eFvp5/aqT+8EaAXsfSyl6K0DOYMGURJTPIPOglVZRksKTPCn Ms/LqydxRB09H9eaLSZcQHWo6cHJ3OrfF0/2vwAEFF1BpR4eTxeizOr0/nhawLEBjlb6BFea Q0TnBT62oHCOMye9az69VMvZOLcUjoV8tYKQED5DFZ8FHmsFtE7IFRykGPrpv5+AXKeEdEdF PH8tGStICkeuNZzfshqvPcdevh8EoMf2RpVns+d/kDKT2fNnzx8etQ44e7DFP3Za1O5B1Dvp XZe5qITW1xcgZHljTgR8re8vII1wynQv4uA0XDXqgHNod4nWjCLW4OyrSFVKjm+DUM4xoxyc F4rqvwSouRmky3LXviOaKJYsu4vdqoYbNSyR6vBWp9FjGTMdXC3BQi6a14l9fTiAawvWVz08 YX/ICjSu8U4cKWCjoC1655yu4H3UjZ2zmiQbMOgRE6KNGvBYVUfRYXsVqSXWrGBC3zrZ20om dkygb4HB8L+O/h2Cv/aK167qn+iuZa6svFQ3OZMbxpSMtL2sTJ/p8EBJfruS7ljoiYFLnOb8 n6y5ZG4DS5rjmBe4/gwbZ9A2owXr2u8S/4Dci0n4IstSbcjrxfmZAdpfgdz3svbvr3wS8J06 DukxYM8C32NnwVV3Xd1O37PiV72CN3XTVny7kEQmrrhkn2lxgLHGZN+AGfVScD843jt3LYKt ZkjO5ySmr05Hfv+oH6SP3B2n2VecsUT/6/gfUEsDBBQAAAAIAM2FayvIVn+quAQAALcdAAAW AAAAdGVtcGxhdGUtY29tcG9uZW50LnhtbO1ZTW/bRhC9G/B/2CgXNZaj5lAgBSgahqWDANtx YxWFYfiwoVYyUZLLLpeO1V/f2S9yP0hLsYUCLZRLxNmZt7Pz3gzlVXT2nGfoibAqpcVk8Onj zwNEioQu02I9Gcxvv5x+/vzLr6efBmfx8dHxUfRu+uVicXczQwnNS1qQgqN7tTC7nF3NrhfW wnCZVmWGN6cFzsmoXTjlm9J59tcrlozQ8RFCS1IlLC055DYSz4z8VaeM5OBUQQBOHgn+lkFs xTGvwaQPMkK45o+UVTKqqvMcs4383G6S0GKVrmuGBfoHZ3vC6/LMc0+Lsua+kda8w1pXeE3O hO2n2K2NXRA0fH9zMT1fnPtObp0cty6nAKvLCSqKdtjQqQkaOo8nCvt8sbic3/YHyZzlNuj9 19lvv8+/zqa9+8lKo6H876Q/LVl7kBPm+EPfCRUVnU7CBAuWlqQJYDlhK5wQ/byiLMd8hMgz zsuMnIQobUhPxS2cHcotheJlZm/uRjnUqJbR/bCEA5AVrjM+clqmUX4vqiZgT2gvSNFg99VN bdhbMyuPHgSdXC+CPTr62sXMk74t5JDpWdSTp2dVjyM0LMGt6SWzqoxodnWzuHOaTC/IuoY9 FfiRHKeZcZxf3VzOg97T1InezkUtgFVas4QEbZXLCd5dBxnhLD6obRppx2L6Rfa4i6fq4Ro+ R2NnRfq6Uy9ek4KA1ikbIc5wUYmeIvBQEZbiLP1bfCY8icZenIcl8WX56grElxaoSjmUqbQD u5KAgRmv6ixDSYarSjJgh4hlcWJxyFaaEgShqbR8I+j7I4yBtEJLCm/Tj9J77LtLqy1OA0Jr SQF/JLZ2EafiKGAG3CYfjR3ARI2k4yYpYYJ0QM1QX7LewLEaJxmjZB5PaaIy0LKnK29TNHsG 3aU5LjjORuiWq1fxFXgzKJaGkZC6OVpM0y0BaDQ2vjJQ942uSWT1w2RwBzKUHwdK+JPBRljk 58FYxY9tAHU6NSc04q18AjkprkSx2/N5zNmRnlrCV+BkoIU2MLk7PtoIZik+N16JrVGldDPz M74j8DWHMnRNG76XrZueo41BiFFN1iec1cSqt7VhEz32wzvErTBtgYeAbuUMdIjkkSH+BYTs gu3DRHrKWbiRHmmWCaELPeYE7WYwquFmBY7DyEg5xdG7ezkB7/9gQDZS8tM48BWaPDzEkJzy bbP1k/vRbHPK9pKug7NrugI/1PGL4q4IrC7RQeMG+qBxafpPadx++Yer0uPl18GzMB5eBgb6 0CgK7/AyOGj8oPH/88tAXrEYMPvBtIT889ToVF3IlJiBkRP2xq7o7oVgj9d3gQe15z7YAf3Q Cf9iJ7Tqde5CtNXTvby0NaHiXnRnef2ZwhsCxCoRtgjJvZVtbznai9qS0adU/Jyh8ADHDXGh 1N1tV1bQ6FxwYBKzJd4R+RK1hk51r60df4A+w5yM3426hgCbuZYijzt1mf4m8hTEtjmwnT5G EpI+CfoU4j74C3N7JYH6Rwft+apWNFwqqDeQ2XDmcSl/ZGio7CDBG+sUZiyqK1Hx9mqONLeM 3VQGxQpKZc7pI1vAXXXbUrXu2RVUbGt2+mvpfpP0QHfJ1Sa0Je74yLJLhv8BUEsBAhQAFAAA AAgAI4ZrK4UUsgsIBAAAtxgAABsAAAAAAAAAAQAgALaBAAAAAGNvbXBvbmVudC1kZXNjMmRv Y3VtZW50LnhzbFBLAQIUABQAAAAIACx8aysIit7oiwUAAJIkAAARAAAAAAAAAAEAIAC2gUEE AABkb2N1bWVudDJodG1sLnhzbFBLAQIUABQAAAAIABaFayu8f0v+sAgAAMYjAAAYAAAAAAAA AAEAIAC2gfsJAABlbmNvZGVVUkxUcmFuc2Zvcm1lci54bWxQSwECFAAUAAAACADNhWsryFZ/ qrgEAAC3HQAAFgAAAAAAAAABACAAtoHhEgAAdGVtcGxhdGUtY29tcG9uZW50LnhtbFBLBQYA AAAABAAEABIBAADNFwAAAAA= --------------060104040506040806090408 Content-Type: text/plain; charset=us-ascii --------------------------------------------------------------------- To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org For additional commands, email: cocoon-dev-help@xml.apache.org --------------060104040506040806090408--