21 Dec
2012
21 Dec
'12
5:01 a.m.
21 dec 2012 kl. 08:15 skrev Olle E. Johansson <oej(a)edvina.net>et>:
20 dec 2012 kl. 21:53 skrev Daniel-Constantin Mierla <miconda(a)gmail.com>om>:
I think I came up with that based
on functions and others. Made sense. But I could combine them into <name>_admin.xml
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
On 12/20/12 9:14 PM, Olle E. Johansson wrote:
Right.
20 dec 2012 kl. 21:07 skrev Daniel-Constantin
Mierla <miconda(a)gmail.com>om>:
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
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
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 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.