[Hibernate-JIRA] Created: (HV-417) Add section on public API and it's changes to the reference guide

[Hibernate-JIRA] Created:...

[Hibernate-JIRA] Created: (HV-487)...

Gunnar Morling (JIRA)

Saturday, 15 January 2011 Sat, 15 Jan '11

3:54 p.m.

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Fix For: 4.2.0.Beta2 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310. -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://opensource.atlassian.com/projects/hibernate/secure/Administrators.... - For more information on JIRA, see: http://www.atlassian.com/software/jira

Show replies by date

Gunnar Morling (JIRA)

Saturday, 15 January Sat, 15 Jan

3:54 p.m.

New subject: [Hibernate-JIRA] Assigned: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Gunnar Morling reassigned HV-417: --------------------------------- Assignee: Gunnar Morling

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.Beta2 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

-- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://opensource.atlassian.com/projects/hibernate/secure/Administrators.... - For more information on JIRA, see: http://www.atlassian.com/software/jira

Gunnar Morling (JIRA)

4:03 p.m.

New subject: [Hibernate-JIRA] Commented: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Gunnar Morling commented on HV-417: ----------------------------------- Pushed a first draft to https://github.com/gunnarmorling/hibernate-validator/blob/HV-417/hibernat...

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.Beta2 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Gunnar Morling (JIRA)

4:08 p.m.

New subject: [Hibernate-JIRA] Commented: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Gunnar Morling commented on HV-417: ----------------------------------- We might also consider to publish API change reports generated by JDiff (http://www.jdiff.org/). I ran it locally to see what changed from 4.0.2 to 4.1 and from 4.1 to 4.2. The result looks promising and I think this would be a valuable information for users considering upgrading to a new version.

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.Beta2 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Hardy Ferentschik (JIRA)

Monday, 17 January Mon, 17 Jan

4:45 a.m.

New subject: [Hibernate-JIRA] Commented: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Hardy Ferentschik commented on HV-417: -------------------------------------- Right, we need to adjust the OSGi configuration. At the very least {{org.hibernate.validator.cfg}} and {{org.hibernate.validator.cfg.defs}} needs to be added. Probably a good idea to double check the rest of the configuration. The OSGi configuration and the assembly (slightly unrelated) with its dependency sets are really a pain to maintain, because they rely on the fact that you remember to check and update them. Partly this is not avoidable I think and partly the maven plugins are failing us.

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.Beta2 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Hardy Ferentschik (JIRA)

4:56 a.m.

New subject: [Hibernate-JIRA] Commented: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Hardy Ferentschik commented on HV-417: -------------------------------------- Regarding JDiff I am undecided. The output is very verbose even though not so much has changed. Most of the changes originate from the programmatic constraint refactoring. I am not sure how useful it is in the long run. We would also have to consider how to integrate this. Did you use the maven jdiff maven plugin to generate the report or was this a once of effort? There is a plugin, but it seems quite old. Not much activity around JDiff itself either.

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.Beta2 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Gunnar Morling (JIRA)

4:43 p.m.

New subject: [Hibernate-JIRA] Commented: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Gunnar Morling commented on HV-417: ----------------------------------- I ran JDiff manually, but probably this can be automated in some way. The biggest problem will be that the previous API version needs to available during generation of the report. So one would probably have to check out the appropriate tag from Git or similar. Another option might be [clirr|http://clirr.sourceforge.net/], which for instance is used for generating [sl4j's compatibility report|http://www.slf4j.org/compatibility.html]. The output seems very compact and focused on the compatibility aspect. I'll try it out and report on the results.

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.Beta2 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Matt Doar (JIRA)

8 p.m.

New subject: [Hibernate-JIRA] Commented: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Matt Doar commented on HV-417: ------------------------------ I'm the original author of JDiff. It's pretty stable at the moment, with maybe one release per year. I know Ben at Atlassian has been looking at using it for API diff docs. clirr seems to generate a very abbreviated list of changes? ~Matt

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.Beta2 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Hardy Ferentschik (JIRA)

Tuesday, 18 January Tue, 18 Jan

6:05 a.m.

New subject: [Hibernate-JIRA] Commented: (HV-417) Add section on public API and it's changes to the reference guide

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.Beta2 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Gunnar Morling (JIRA)

4:56 p.m.

New subject: [Hibernate-JIRA] Commented: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Gunnar Morling commented on HV-417: ----------------------------------- Ok, then let's focus in this issue on the OSGi manifest and a section for the reference guide describing HV's public packages and the policies for their development. I'll remove the section "section-api-changes" from publicapi.xml, as this will be provided HV-423 in some way.

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.Beta2 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Hardy Ferentschik (JIRA)

Thursday, 24 February Thu, 24 Feb

3:39 a.m.

New subject: [Hibernate-JIRA] Updated: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Hardy Ferentschik updated HV-417: --------------------------------- Fix Version/s: (was: 4.2.0.Beta2) 4.2.0.CR1

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.CR1 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Kevin Pollet (JIRA)

Friday, 18 March Fri, 18 Mar

8:45 a.m.

New subject: [Hibernate-JIRA] Commented: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Kevin Pollet commented on HV-417: --------------------------------- I think the following things should be added to the OSGI manifest: * {{org.hibernate.validator.group}} should be part of the HV public packages * {{org.joda.time.*}} should be added as an imported package with optional resolution

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.CR1 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Kevin Pollet (JIRA)

Saturday, 19 March Sat, 19 Mar

5:30 a.m.

New subject: [Hibernate-JIRA] Commented: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Kevin Pollet commented on HV-417: --------------------------------- Gunnar, I think you've thought about that ;) * {{org.hibernate.validator.method}} and {{org.hibernate.validator.method.metadata}} should be part of the HV public packages.

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.CR1 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Gunnar Morling (JIRA)

5:49 a.m.

New subject: [Hibernate-JIRA] Commented: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Gunnar Morling commented on HV-417: ----------------------------------- I think I'd have considered those, but still good to be remembered that there is something to do here :-)

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.CR1 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Kevin Pollet (JIRA)

Monday, 23 May Mon, 23 May

5:09 p.m.

New subject: [Hibernate-JIRA] Commented: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Kevin Pollet commented on HV-417: --------------------------------- I've split this issue in two. This issue is now related to the new section in the reference guide (public API) and HV-475 to the OSGi manifest.

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.CR1 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Hardy Ferentschik (JIRA)

Thursday, 9 June Thu, 9 Jun

5:01 a.m.

New subject: [Hibernate-JIRA] Updated: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Hardy Ferentschik updated HV-417: --------------------------------- Fix Version/s: (was: 4.2.0.CR1) 4.2.0.Final

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.Final The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Hardy Ferentschik (JIRA)

7:03 a.m.

New subject: [Hibernate-JIRA] Resolved: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Hardy Ferentschik resolved HV-417. ---------------------------------- Resolution: Fixed

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.Final The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

Hardy Ferentschik (JIRA)

7:05 a.m.

New subject: [Hibernate-JIRA] Updated: (HV-417) Add section on public API and it's changes to the reference guide

[ http://opensource.atlassian.com/projects/hibernate/browse/HV-417?page=com... ] Hardy Ferentschik updated HV-417: --------------------------------- Fix Version/s: (was: 4.2.0.Final) 4.2.0.CR1

...

Add section on public API and it's changes to the reference guide ----------------------------------------------------------------- Key: HV-417 URL: http://opensource.atlassian.com/projects/hibernate/browse/HV-417 Project: Hibernate Validator Issue Type: Improvement Components: documentation Reporter: Gunnar Morling Assignee: Gunnar Morling Fix For: 4.2.0.CR1 The reference guide should make clear, which HV packages are public and which ones not. Also some rules for evolvement of the public packages should be specified. The packages comprising the programmatic configuration API should be part of the generated OSGi manifest. This is a follow-up to HV-310.

4859

days inactive

5004

days old

hibernate-issues@lists.jboss.org

Manage subscription

17 comments

4 participants

tags (0)

participants (4)

Gunnar Morling (JIRA)
Hardy Ferentschik (JIRA)
Kevin Pollet (JIRA)
Matt Doar (JIRA)

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

[Hibernate-JIRA] Created: (HV-417) Add section on public API and it's changes to the reference guide