[prev in list] [next in list] [prev in thread] [next in thread]
List: openser-devel
Subject: Re: [sr-dev] Updating a *LOT* of READMEs
From: "Olle E. Johansson" <oej () edvina ! net>
Date: 2016-05-31 15:20:34
Message-ID: 0D002E99-2DB7-4D34-A19D-03CA1EA7AD13 () edvina ! net
[Download RAW message or body]
[Attachment #2 (multipart/alternative)]
> On 31 May 2016, at 17:18, Daniel-Constantin Mierla <miconda@gmail.com> wrote:
>
>
>
> On 31/05/16 17:16, Olle E. Johansson wrote:
> > [...]
> > > The plan is to generate them on kamailio.org <http://kamailio.org/> and push \
> > > them based on cron.d, so the devs will only change the xml files. I discussed a \
> > > bit with Victor Seva at kamailio.org <http://kamailio.org/> to do this, but we \
> > > haven't gotten there yet.
> > >
> > That may be clever. There was way too many differences.
> >
> A lot of diffs are because various OSes use different whitespacing for xml \
> stylesheets and special chars. This is what we try to avoid, by generating them in \
> a single place.
I know. I went through all files and only committed when there was real changes, not \
that stuff. And there where a lot of sections missing and other editorial changes, \
not just the URL to the bug tracker.
I wonder if that depends on default settings or version of docbook tools. It is very \
strange. Maybe a more detailed style sheet would remove a lot of those. Just guessing \
:-)
/O
>
> Cheers,
> Daniel
> >
> > /O
> >
> > > Cheers,
> > > Daniel
> > >
> > > On 31/05/16 16:54, Olle E. Johansson wrote:
> > > > Hi!
> > > >
> > > > I noticed that the link to the bug tracker was wrong in our Docbook XML \
> > > > entities and re-generated all READMEs.
> > > > To my surprise, a lot of them contains new parameters, new text and new \
> > > > functions - stuff that was committed to the XML files, but not to the text \
> > > > file README. I noticed while going through all the diff’s.
> > > > Prepare for a long series of commits. And when you update the XML docs, \
> > > > please update the README.
> > > > In worst case, I may have to do this twice, so that our 4.4 docs are also \
> > > > current with the code and the XML files.
> > > > Thanks,
> > > > /O
> > > > _______________________________________________
> > > > sr-dev mailing list
> > > > sr-dev@lists.sip-router.org <mailto:sr-dev@lists.sip-router.org>
> > > > http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev \
> > > > <http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev>
> > >
> > > --
> > > Daniel-Constantin Mierla
> > > http://www.asipto.com <http://www.asipto.com/> - http://www.kamailio.org \
> > > <http://www.kamailio.org/> http://twitter.com/#!/miconda \
> > > <http://twitter.com/#%21/miconda> - http://www.linkedin.com/in/miconda \
> > > <http://www.linkedin.com/in/miconda>_______________________________________________
> > > sr-dev mailing list
> > > sr-dev@lists.sip-router.org <mailto:sr-dev@lists.sip-router.org>
> > > http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev \
> > > <http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev>
> >
>
> --
> Daniel-Constantin Mierla
> http://www.asipto.com <http://www.asipto.com/> - http://www.kamailio.org \
> <http://www.kamailio.org/> http://twitter.com/#!/miconda \
> <http://twitter.com/#!/miconda> - http://www.linkedin.com/in/miconda \
> <http://www.linkedin.com/in/miconda>
[Attachment #5 (unknown)]
<html><head><meta http-equiv="Content-Type" content="text/html \
charset=windows-1252"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: \
space; -webkit-line-break: after-white-space;" class=""><br class=""><div><blockquote \
type="cite" class=""><div class="">On 31 May 2016, at 17:18, Daniel-Constantin Mierla \
<<a href="mailto:miconda@gmail.com" class="">miconda@gmail.com</a>> \
wrote:</div><br class="Apple-interchange-newline"><div class="">
<meta content="text/html; charset=windows-1252" http-equiv="Content-Type" \
class="">
<div bgcolor="#FFFFFF" text="#000000" class=""><p class=""><br class="">
</p>
<br class="">
<div class="moz-cite-prefix">On 31/05/16 17:16, Olle E. Johansson
wrote:<br class="">
</div>
<blockquote cite="mid:9127AE4B-5CD3-432D-A0FF-9F9A122FB1F7@edvina.net" \
type="cite" class="">[...] <div class="">
<blockquote type="cite" class="">
<div class="">
<div bgcolor="#FFFFFF" text="#000000" class=""><p class="">The plan is to \
generate them on <a moz-do-not-send="true" href="http://kamailio.org/" \
class="">kamailio.org</a> and push them based on cron.d, so the devs will only \
change the xml files. I
discussed a bit with Victor Seva at <a moz-do-not-send="true" \
href="http://kamailio.org/" class="">kamailio.org</a> to do this, but we haven't \
gotten there yet.</p> <div class=""><br class="">
</div>
</div>
</div>
</blockquote>
That may be clever. There was way too many differences.</div>
<br class="">
</blockquote>
A lot of diffs are because various OSes use different whitespacing
for xml stylesheets and special chars. This is what we try to avoid,
by generating them in a single place.<br class=""></div></div></blockquote>I \
know. I went through all files and only committed when there was real changes, not \
that stuff. And there where a lot of sections missing</div><div>and other editorial \
changes, not just the URL to the bug tracker.</div><div><br class=""></div><div>I \
wonder if that depends on default settings or version of docbook tools. It is very \
strange. Maybe a more detailed</div><div>style sheet would remove a lot of those. \
Just guessing :-)</div><div><br class=""></div><div>/O</div><div><br \
class=""><blockquote type="cite" class=""><div class=""><div bgcolor="#FFFFFF" \
text="#000000" class=""> <br class="">
Cheers,<br class="">
Daniel<br class="">
<blockquote cite="mid:9127AE4B-5CD3-432D-A0FF-9F9A122FB1F7@edvina.net" \
type="cite" class=""> <div class=""><br class="">
</div>
<div class="">/O<br class="">
<br class="">
<blockquote type="cite" class="">
<div class="">
<div bgcolor="#FFFFFF" text="#000000" class=""><p class="">Cheers,<br \
class=""> Daniel<br class="">
</p>
<br class="">
<div class="moz-cite-prefix">On 31/05/16 16:54, Olle E.
Johansson wrote:<br class="">
</div>
<blockquote cite="mid:4A937CE1-5ECE-4CD9-AD24-291FE78CA3A7@edvina.net" \
type="cite" class=""> <pre class="" wrap="">Hi!
I noticed that the link to the bug tracker was wrong in our Docbook XML entities and \
re-generated all READMEs.
To my surprise, a lot of them contains new parameters, new text and new functions - \
stuff that was committed to the XML files, but not to the text file README. I noticed \
while going through all the diff’s.
Prepare for a long series of commits. And when you update the XML docs, please update \
the README.
In worst case, I may have to do this twice, so that our 4.4 docs are also current \
with the code and the XML files.
Thanks,
/O
_______________________________________________
sr-dev mailing list
<a moz-do-not-send="true" class="moz-txt-link-abbreviated" \
href="mailto:sr-dev@lists.sip-router.org">sr-dev@lists.sip-router.org</a> <a \
moz-do-not-send="true" class="moz-txt-link-freetext" \
href="http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev">http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev</a>
</pre>
</blockquote>
<br class="">
<pre class="moz-signature" cols="72">--
Daniel-Constantin Mierla
<a moz-do-not-send="true" class="moz-txt-link-freetext" \
href="http://www.asipto.com/">http://www.asipto.com</a> - <a moz-do-not-send="true" \
class="moz-txt-link-freetext" \
href="http://www.kamailio.org/">http://www.kamailio.org</a> <a moz-do-not-send="true" \
class="moz-txt-link-freetext" \
href="http://twitter.com/#%21/miconda">http://twitter.com/#!/miconda</a> - <a \
moz-do-not-send="true" class="moz-txt-link-freetext" \
href="http://www.linkedin.com/in/miconda">http://www.linkedin.com/in/miconda</a></pre>
</div>
_______________________________________________<br class="">
sr-dev mailing list<br class="">
<a moz-do-not-send="true" href="mailto:sr-dev@lists.sip-router.org" \
class="">sr-dev@lists.sip-router.org</a><br class=""> <a \
class="moz-txt-link-freetext" \
href="http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev">http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev</a><br \
class=""> </div>
</blockquote>
</div>
<br class="">
</blockquote>
<br class="">
<pre class="moz-signature" cols="72">--
Daniel-Constantin Mierla
<a class="moz-txt-link-freetext" \
href="http://www.asipto.com/">http://www.asipto.com</a> - <a \
class="moz-txt-link-freetext" \
href="http://www.kamailio.org/">http://www.kamailio.org</a> <a \
class="moz-txt-link-freetext" \
href="http://twitter.com/#!/miconda">http://twitter.com/#!/miconda</a> - <a \
class="moz-txt-link-freetext" \
href="http://www.linkedin.com/in/miconda">http://www.linkedin.com/in/miconda</a></pre>
</div>
</div></blockquote></div><br class=""></body></html>
_______________________________________________
sr-dev mailing list
sr-dev@lists.sip-router.org
http://lists.sip-router.org/cgi-bin/mailman/listinfo/sr-dev
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic