Re: 3.0.20 ChangeLog progress

Thanks Fabian,

Another question - should I specify each and every case of comment tidying or just add a general "various typo corrections and comprehensibility improvements"?

Ian

On 2013-01-08, at 11:21 AM, Fabian Keil wrote:

> Ian Silvester <[email protected]> wrote:
> 
>> So I've found the rather useful script cvs2cl.pl (from here: http://www.red-bean.com/cvs2cl/) that I'm hoping will reduce the pain of extracting and formatting the commit messages appropriately. It seems very flexible and, usefully, supports xml output and xsl formatting that I might be able to use to at least get the format of the messages exactly right, even though of course there'll be a bunch of deletion and comprehensibility improvements that need to follow.
> 
> In my experience rewording the commit messages takes most of the
> time and as pretty much every message that is kept has to be changed
> anyway I wouldn't worry too much about the initial formatting.
> 
>> I have a few questions so that I can try to get this right first time:
>> 
>> - I'm guessing that there's a limit to the ChangeLog line length so that the sgml conversion goes smoothly - what is the max line length allowed?
> 
> The conversion script doesn't have a hard limit, but it's preferable
> to keep the line length below 80 characters so the text version can
> be conveniently read without requiring a reader that does line wrapping.
> 
>> - is the indenting and hyphenation crucial? i.e. two spaces and a hyphen before an item, no spaces and a hyphen before a section heading?
> 
> The converter requires a somewhat consistent indentation to get
> the nesting right, the hyphen is used to detect items and the
> colon is required to detect list headers.
> 
> Keeping the current indentation and hyphenation is also desirable
> to keep the style somewhat consistent.
> 
> Fabian
> ------------------------------------------------------------------------------
> Master SQL Server Development, Administration, T-SQL, SSAS, SSIS, SSRS
> and more. Get SQL Server skills now (including 2012) with LearnDevNow -
> 200+ hours of step-by-step video tutorials by Microsoft MVPs and experts.
> SALE $99.99 this month only - learn more at:
> http://p.sf.net/sfu/learnmore_122512_______________________________________________
> Ijbswa-developers mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/ijbswa-developers


------------------------------------------------------------------------------
Master Java SE, Java EE, Eclipse, Spring, Hibernate, JavaScript, jQuery
and much more. Keep your Java skills current with LearnJavaNow -
200+ hours of step-by-step video tutorials by Java experts.
SALE $49.99 this month only -- learn more at:
http://p.sf.net/sfu/learnmore_122612