21 dec 2012 kl. 08:15 skrev Olle E. Johansson <[email protected]>: > > 20 dec 2012 kl. 21:53 skrev Daniel-Constantin Mierla <[email protected]>: > >> >> On 12/20/12 9:14 PM, Olle E. Johansson wrote: >>> 20 dec 2012 kl. 21:07 skrev Daniel-Constantin Mierla <[email protected]>: >>> >>>> Hello, >>>> >>>> On 12/20/12 9:00 PM, Olle E. Johansson wrote: >>>>> sl Minor README updates (file name changes) >>>>> >>>>> --- >>>>> >>>>> modules/sl/README | 154 >>>>> ++++++++++---------- >>>>> modules/sl/doc/sl.xml | 16 +- >>>>> modules/sl/doc/{functions.xml => sl_functions.xml} | 0 >>>>> modules/sl/doc/{params.xml => sl_params.xml} | 0 >>>>> modules/sl/doc/{stats.xml => sl_stats.xml} | 0 >>>> is this rename necessary for some reason? I see you started doing it to >>>> many modules. >>>> >>>> The point is that it breaks the script that generates the alphabetic >>>> indexes. >>> Ouch. Different modules seems to have different naming and XML formatting >>> ideas >> The name patterns were two so far (I normalized them when I built the >> indexing script): >> >> 1) old kamailio style: modname.xml, modname_admin.xml, modname_devel.xml and >> modname_faq.xml. The first two are most common, modname.xml with the header, >> modname_admin.xml with top description, functions/params/mi cmds/etc.. >> usable from config >> >> 2) old ser style: modname.xml, functions.xml, params.xml, etc... Each file >> contains parts of what is modname_admin.xml in kamailio style >> > Right. > >>> >>> Another reason is that I want to aggregate the files and produce a combined >>> documentation set and the way I have been playing with doesn't work with >>> the same file names - like "params.xml" for multiple modules. Since many >>> modules had modname_params.xml >> >> I don't recall modname_params.xml being used so far (modules/ and modules_k/ >> were indexed so far for sure), which modules had it? > I think I came up with that based on functions and others. Made sense. But I > could combine them into <name>_admin.xml >> >>> I decided to start moving the xml file names to a standard way. >> >> At the end I wouldn't be against of having a (new) 'standard' way, but it >> has to be defined with some clear patterns/rules, because what you started >> to use as new name was not a 'standard' pattern so far. > Ok. What's the proposal? I would prefer kamailio style file names and <book> > as the main item in the <modname>.xml file.
The Kamailio way is better, when comparing HTML output. Any other opinions? /O _______________________________________________ sr-dev mailing list [email protected] http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev
