Hello,
it is no longer needed to generate the readme from xml docs and push it
to git. There is a script running on
kamailio.org checking every 15 min
(iirc) for changes, generates the readmes and pushes them to git. They
appear as a commit from 'Kamailio Dev'.
The main reason was that xml docbook settings for whitespacing, line
length and section numbering are different from OS to OS and a small
change in xml file could result in a totally different look for readme
if the readme was not generated on the same system like previous
version. Backporting is no longer easier in such case.
Anyhow, it is good to generate readme locally in case you did lot of
changes and there might be syntax errors. Once you see it is generated
correctly, just delete it locally and check it out again. Say I
generated the readme for acc module to be sure it is ok, then I just do:
rm src/modules/acc/README
git checkout src/modules/acc/README
Probably can be done in a single step with the last git command or some
alternative.
Cheers,
Daniel
On 26.04.17 10:09, Charles Chance wrote:
Hello,
Quick question...
I always have done so far out of routine, but wondered if it was
actually necessary to manually rebuild the readme (and commit) after a
change to an xml doc?
Cheers,
Charles
Sipcentric Ltd. Company registered in England & Wales no.
7365592. Registered office: Faraday Wharf, Innovation Birmingham
Campus, Holt Street, Birmingham Science Park, Birmingham B7 4BB.
_______________________________________________
Kamailio (SER) - Development Mailing List
sr-dev(a)lists.kamailio.org
https://lists.kamailio.org/cgi-bin/mailman/listinfo/sr-dev
--
Daniel-Constantin Mierla
www.twitter.com/miconda --
www.linkedin.com/in/miconda
Kamailio Advanced Training - May 22-24 (USA) -
www.asipto.com
Kamailio World Conference - May 8-10, 2017 -
www.kamailioworld.com