README-builds.html update

Magnus Ihse Bursie magnus.ihse.bursie at
Tue Feb 3 13:50:26 UTC 2015

On 2015-02-01 11:16, Martijn Verburg wrote:
> Hi all,
> I'm sitting at FOSDEM and was reminded that we hadn't yet made the effort
> to integrate the "How to build OpenJDK" material we've built up over on
> (the incubator site for Adoption Group activities) as
> well as tidying up some typos and HTML compatibility warnings in the doc.
> Updating a reasonably large document will mean a diff of:
> * Whitespace changes
> * HTML formatting changes
> * Actual content changes
> Would people prefer a patch for each type of change? Or are they happy for
> what will likely be a reasonably large diff, (which basically means
> eyeballing the end result).

With a suitable diff tool, hiding/showing whitespace changes is no big 
deal, so since it is only a single file I don't see the need for a 
separate patch for that.

If the formatting changes are much higher in number than actual content 
change, it might make sense to separate those. But just a few formatting 
changes among real content change is no problem.

In a somewhat related area: I've been toying with the idea of rewriting 
the build-readme in markdown instead, and just generate the html file. 
Updating proper, consistent html formatting for a document like this is 
quite painful, and we never seem to get it right. Does it sound like a 
good idea?


More information about the build-dev mailing list