Re: [ jEdit-devel ] [ jEdit-commits ] [ CtagsInterface plugin ] CtagsInterface jEdit plugin branch master updated. a8e0a1a5c752170a3fddf032df330369487577c0

[Dale A. <da...@gr...>]

Better solution with svn plugin (I assume you can do similar with git):

In svn browser, right click on last release tag, select "log", check "Stop
on copy". Output will tell you at what revision the tag was created.
(command line switch is --stop-on-copy)

In svn browser or project viewer, right click on trunk or project root,
select "log", set end revision to revision found above. Output will give
you changes since last release.

Copy the comments to the release announcement. It's accurate and no
separate change log file that you might forget to update. That's what I do,
anyway.

Dale


On Thu, May 3, 2012 at 4:13 PM, Alan Ezust <ala...@gm...> wrote:

> Shlomy,
>
> I realize you don't like maintaining a separate changelog for your
> plugins, and I also realize you don't bother including  many details
> into your plugin release announcements either.
>
> Perhaps if you did keep track of major changes somehow, it would be a
> lot easier for you to include that in your plugin release
> announcements. Anyway, that's how/why I maintain a changelog file for
> now.
>
> Until a better solution is found, I recommend everyone else do this too.
>
> On Thu, May 3, 2012 at 12:51 PM, Shlomy Reinstein <sre...@gm...>
> wrote:
> > One small comment: Personally, I don't like maintaining a separate
> changelog
> > file. I think the version control system is meant for that. The commit
> > message can be annotated with something like: <user>, so it can be parsed
> > later to build a user changelog. A commit log is something you never
> forget,
> > but a changelog file is overhead.
> > Most probably, SVN and Git can have a commit log template which can be
> > filled by the developer. Much older version control systems had this
> > capability.
> >
> > Thanks,
> > Shlomy
> >
> >
> > On Thu, May 3, 2012 at 10:39 PM, Jarek Czekalski <
> jar...@po...>
> > wrote:
> >>
> >> Hi Tom
> >>
> >> I have several tiny remarks about your commits.
> >>
> >> checkTagFileVFS - please provide at least short javadoc for the public
> >> methods you introduce. In this case probably VFS (Virtual File System)
> >> suffix is not suitable. Anyway javadoc would make it clear what the
> >> function does and how it may be extended or not. For example:
> >> /** Checks if the filename is valid as a tag file */
> >> I believe there may be cases where the name explains all, then no need
> >> to javadoc.
> >>
> >> Please update the changelog (CHANGES.txt) if you make noticeable
> changes.
> >>
> >> If you make interface changes or extensions it would be good to update
> >> docs also. If possible and applicable. Adding the ability of external
> >> tag files seems as a feature that should be mentioned in the docs.
> >>
> >> Whitespaces. As a first example: TagIndex line 189 - spaces instead of
> >> tabs. Whitespace plugin might help you keep indenting consistent.
> >>
> >> To some of the above comments you could say: well, I just did how it was
> >> before. But Shlomy was the only author of the plugin. Since it became
> >> multi-developer project, more attention should be paid to documentation
> >> and clarity of code and code changes. Core jedit serves as an example of
> >> good practices.
> >>
> >> Regards
> >> Jarek
> >>
> >>
> >>
> >> W dniu 05/03/2012 04:45 PM, Tom Power pisze:
> >> > This is an automated email from the git hooks/post-receive script. It
> >> > was
> >> >
> >>
> >>
> >>
> >>
> ------------------------------------------------------------------------------
> >> Live Security Virtual Conference
> >> Exclusive live event will cover all the ways today's security and
> >> threat landscape has changed and how IT managers can respond.
> Discussions
> >> will include endpoint security, mobile security and the latest in
> malware
> >> threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
> >> --
> >> -----------------------------------------------
> >> jEdit Developers' List
> >> jEd...@li...
> >> https://lists.sourceforge.net/lists/listinfo/jedit-devel
> >
> >
> >
> >
> ------------------------------------------------------------------------------
> > Live Security Virtual Conference
> > Exclusive live event will cover all the ways today's security and
> > threat landscape has changed and how IT managers can respond. Discussions
> > will include endpoint security, mobile security and the latest in malware
> > threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
> > --
> > -----------------------------------------------
> > jEdit Developers' List
> > jEd...@li...
> > https://lists.sourceforge.net/lists/listinfo/jedit-devel
> >
>
>
> ------------------------------------------------------------------------------
> Live Security Virtual Conference
> Exclusive live event will cover all the ways today's security and
> threat landscape has changed and how IT managers can respond. Discussions
> will include endpoint security, mobile security and the latest in malware
> threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
> --
> -----------------------------------------------
> jEdit Developers' List
> jEd...@li...
> https://lists.sourceforge.net/lists/listinfo/jedit-devel
>