Re: Finally - sane NEWS information!

[Dave Malcolm <david davemalcolm demon co uk>]

On Thu, 2004-02-19 at 10:33, Daniel Veillard wrote:
> On Thu, Feb 19, 2004 at 06:02:47PM +1100, Jeff Waugh wrote:
> > <quote who="Mark McLoughlin">
> > 
> > > Right, so I assume you must have some heuristic to figure the format of
> > > the NEWS entry so you can pull only the latest one. Just so we have an
> > > idea of how not to break it terribly, what is it ? :-)
> > 
> > It's absolutely stupid, but surprisingly robust:
> > 
> >   diff -u OLDS NEWS | sed '1,/@@/d;/@@/,//d;/^[^+]/d;s/^+//'
> > 
> > I have no idea why I didn't think of it earlier. ;-)
> 
>   Hum, I actually generate libxml2 and libxslt NEWS files (yes
> with XSLT of course) so even if coercing everybody into writing
> similar NEWS is not possible, do you have any sort of guidelines ?

Are you using a DTD of some kind?  IIRC Apache Forrest has a DTD for a
ChangeLog XML format with tags for Release, Change, Date, Person, etc.

Or we could cook up our own.

This is possibly overkill, though :-)

> I remember a passionate thread about this one year or such ago
> but what do we really want to show ? My diff generate something like:
> 
> ------------------------
> --- NEWS        25 Jan 2004 21:02:52 -0000      1.24
> +++ NEWS        12 Feb 2004 15:31:48 -0000      1.25
> @@ -15,6 +15,31 @@
>    Schemas
>                                                                                 
>                                                                                 
> +2.6.6: Feb 12 2004:
> +   - nanohttp and nanoftp: buffer overflow error on URI parsing (Igor and
> +    William) reported by Yuuichi Teranishi
> +   - bugfixes: make test and path issues, xmlWriter attribute serialization
> +    (William Brack), xmlWriter indentation (William), schemas validation
> +    (Eric Haszlakiewicz), XInclude dictionnaries issues (William and Oleg
> +    Paraschenko), XInclude empty fallback (William), HTML warnings (William),
> +    XPointer in XInclude (William), Python namespace serialization,
> +    isolat1ToUTF8 bound error (Alfred Mickautsch), output of parameter
> +    entities in internal subset (William), internal subset bug in push mode,
> +    <xs:all> fix (Alexey Sarytchev)
> +   - Build: fix for automake-1.8 (Alexander Winston), warnings removal
> +    (Philip Ludlam), SOCKLEN_T detection fixes (Daniel Richard), fix
> +    --with-minimum configuration.
> +   - XInclude: allow the 2001 namespace without warning.
> +   - Documentation: missing example/index.html (John Fleck), version
> +    dependancies (John Fleck)
> +   - reader API: structured error reporting (Steve Ball)
> +   - Windows compilation: mingw, msys (Mikhail Grushinskiy), function
> +    prototype (Cameron Johnson), MSVC6 compiler warnings, _WINSOCKAPI_
> +  patch
> +   - Parsers: added xmlByteConsumed(ctxt) API to get the byte offest in
> +    input.
> +
> +
>  2.6.5: Jan 25 2004:
>     - Bugfixes: dictionnaries for schemas (William Brack), regexp segfault
>      (William), xs:all problem (William), a number of XPointer bugfixes
> ------------------------
> 
>   Is that okay ? I can work on formatting (to some extend) at the XSLT
> level easilly.
> 
> Daniel