11 Mar
2008
11 Mar
'08
7:15 p.m.
On Tuesday 11 March 2008, Daniel-Constantin Mierla wrote:
Hi Daniel,
there is only one revision per module documentation, this was removed during
the cleanups that Edson did. But to keep this in the master document is only
not that useful, you're right. I think that your suggestion to use the same
revision like in the 'openser -V' output is reasonable. This way its easily
checkable that the documentation matches installed binaries.
Cheers,
Henning
[..]
This big revision string is probably a little bit overkill. Perhaps we
can use either: only the svn revision, or the date of the last change?
The former has more advantages for the developer/ writer, the last one is
probably better understandable for the reader.
At this time, there are revision numbers for each chapter (admin, devel,
faq, ...) and they reflect svn commit revision for that specif file.
Having up to 3 or 4 such numbers in same readme might be confusing.
keeping one in the master, will not reflect changes, as module.xml is
the less updated. Good alternative will be to find a way to add the svn
revision at generation time (as we get it now with compilation of
openser and it is reflected in openser -v). I think it is possible with
xml, to give a parameter value in the command line (needs investigation).