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

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@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