Gavin King
429f5beff6
HHH-18948 move the EventMonitor SPI to its own namespace
2024-12-16 22:58:02 +01:00
Gavin King
46430a4698
remove additional modules which don't contain APIs from the generated Javadoc
...
These modules don't contain APIs which are called by users or implemented by
integrators. Including them in the generated Javadoc results in confusion
for users and makes the Javadoc much more difficult to navigate and consume.
In particular, we definitely don't want packages like these included in the
main Javadoc distribution for Hibernate ORM:
org.hibernate.testing.orm.domain.gambit
org.hibernate.testing.orm.domain.helpdesk
"Good documentation" isn't about having the maximum possible quantity of
documentation; it's about having documentation where people actually have a
hope of finding what they're looking for. In general, generated Javadoc is
entirely useless except when we've actually taken time to actually write
meaningful and readable prose. If all I need is a list of classes and their
methods, my IDE is quite capable of presenting that information to me.
Worse, documentation for things that aren't API appears to invite users to
interact with these things, which is precisely what we don't want them to do!
I'm leaving Envers alone, but I'm honestly not even sure if the Envers packages
belong here, since it doesn't look like anyone has actually spent much time
writing Javadoc for these packages. If Envers Javadoc is useful, it would be
better to put it in a separate Javadoc build, IMO.
2024-12-16 22:57:29 +01:00
Gavin King
831d4cdb47
tune the documentation CSS
2024-12-16 22:50:46 +01:00
Gavin King
af679e1d96
mention Hibernate JFR in the Short Guide
2024-12-16 02:01:56 +01:00
Nathan Xu
2df92c25b8
improve integration doc ( #9322 )
...
* improve integration doc
Co-authored-by: nathan.xu <nathan.xu@procor.com>
Co-authored-by: Gavin King <gavin@hibernate.org>
2024-12-14 17:06:35 +01:00
Gavin King
c88b1e8cc9
links to settings from doc
...
(oops!)
2024-12-10 21:31:28 +01:00
Gavin King
8f11eb56a3
links to settings from doc
2024-12-10 21:25:09 +01:00
Gavin King
02cf728bcb
median function documentation, improve test
2024-12-07 17:01:15 +01:00
Gavin King
1a5db3bf42
HHH-18892 add hex() function
2024-12-03 23:16:28 +01:00
Gavin King
c73a12ced6
HHH-18892 document hash function support
2024-12-03 21:10:19 +01:00
Gavin King
cf5b2955db
add links to connection pool doc
2024-12-03 08:53:11 +01:00
Gavin King
5efd37a4d8
HHH-18902 completely remove Vibur
...
it has not been updated in 5 years
2024-12-03 08:35:29 +01:00
Gavin King
90ff5e712a
HHH-18902 completely remove Proxool
...
it has not been updated in 20 years!
2024-12-03 08:35:29 +01:00
Gavin King
05852b706f
more cleanups to dependencies ( #9354 )
2024-12-01 13:37:51 +01:00
Gavin King
38fb68a57c
correctly describe automatic quoting in doc
2024-11-29 14:06:25 +01:00
Gavin King
79aa178047
HHH-16516 rework CamelCaseToUnderscoresNamingStrategy and handle quoted identifiers
2024-11-28 14:36:32 +01:00
Gavin King
5383c81d18
fix capitalization in a title
2024-11-25 23:39:34 +00:00
Gavin King
030e1fdc25
simplify code examples by using conveniences of HibernatePersistenceConfiguration
2024-11-24 11:22:06 +01:00
Gavin King
89fee1cf42
add CAUTION to doc
2024-11-23 17:30:22 +01:00
Gavin King
a294048dd1
HHH-14119 test showing parameter padding works with criteria literals
2024-11-23 14:52:06 +01:00
Gavin King
cdf88f6a31
talk about events and about EntityListeners in the intro doc
2024-11-23 14:52:06 +01:00
Jan Schatteman
f65f393a01
Fix a couple of typo's
...
Signed-off-by: Jan Schatteman <jschatte@redhat.com>
2024-11-22 20:51:09 +01:00
Gavin King
82060f282d
Update documentation/src/main/asciidoc/introduction/Configuration.adoc
...
Co-authored-by: Yoann Rodière <yoann@hibernate.org>
2024-11-21 22:53:43 +01:00
Gavin King
697d820a7f
add some documentation about date/time config settings
...
and also add some links
2024-11-21 22:53:43 +01:00
Steve Ebersole
21095565bc
HHH-7913 - Schema replacement in <subselect> / @Subselect
2024-11-21 06:53:51 -06:00
Gavin King
779d9c94c9
document the syntax sugar
2024-11-17 15:02:08 +01:00
Gavin King
8f85e6ca47
mention SQL arrays in HQL documentation
2024-11-16 23:35:09 +01:00
Gavin King
632485f8b1
revise new doc section
2024-11-16 21:21:52 +01:00
Gavin King
ce48367607
new doc section on date/time types
2024-11-16 19:05:43 +01:00
Gavin King
439c90f501
add links between chapters
2024-11-16 19:05:43 +01:00
Gavin King
d6e1c9b2a8
add an example use of hibernate.type.preferred_instant_jdbc_type
2024-11-15 20:00:49 +01:00
Gavin King
f3482078c1
clarifications in section on collection mapping
...
(to agree with blog)
2024-11-12 15:07:40 +01:00
Gavin King
a2c714e8f8
add a forward link
2024-11-12 12:29:19 +01:00
Gavin King
4669827465
add a link to the new blog post
2024-11-12 12:29:19 +01:00
Gavin King
ec4310a6de
HHH-18843 remove deprecated @OrderBy
2024-11-11 19:16:48 +01:00
Gavin King
d5e829d26c
add section on quoted identifiers to doc
...
Signed-off-by: Gavin King <gavin@hibernate.org>
2024-11-10 09:37:09 +01:00
Gavin King
68abe5aa70
proofread the Short Guide
...
Signed-off-by: Gavin King <gavin@hibernate.org>
2024-11-08 21:25:19 +01:00
Steve Ebersole
2ea226999d
HHH-18728 - Allow mixed discriminator-value mappings for ANY
...
HHH-18729 - Allow custom strategy for implicit discriminator-value determination for ANY
2024-11-06 20:05:36 -07:00
Marco Belladelli
0378e591cc
HHH-17612 HHH-18762 Migration guide and Envers documentation updates
2024-11-01 11:52:56 -05:00
Christian Beikov
e1a8990358
HHH-18759 Add xmltable() set-returning function
2024-10-31 18:04:05 +01:00
Christian Beikov
854a982927
HHH-18758 Add json_table() set-returning function
2024-10-31 18:04:05 +01:00
Gavin King
7bf6004ef8
fix broken code examples, and make 'em more readable
...
Signed-off-by: Gavin King <gavin@hibernate.org>
2024-10-24 18:59:13 +02:00
Gavin King
7002ee8d0d
shorter method name in doc example
...
Signed-off-by: Gavin King <gavin@hibernate.org>
2024-10-24 14:07:22 +02:00
Gavin King
93c18dafae
more doc updates for JPA 3.2
...
Signed-off-by: Gavin King <gavin@hibernate.org>
2024-10-24 01:26:28 +02:00
Gavin King
1fa10e3b53
update prefaces
...
Signed-off-by: Gavin King <gavin@hibernate.org>
2024-10-23 21:24:47 +02:00
Gavin King
6480154cd7
more updates for JPA 3.2
...
Signed-off-by: Gavin King <gavin@hibernate.org>
2024-10-23 21:24:47 +02:00
Christian Beikov
82b20a0e90
HHH-18731 Add generate_series() set-returning function
2024-10-23 18:29:20 +02:00
Gavin King
5bd244dd20
whitespace fix
...
Signed-off-by: Gavin King <gavin@hibernate.org>
2024-10-23 17:25:36 +02:00
Gavin King
7f3c73b438
update processor chapter for JPA 3.2
...
Signed-off-by: Gavin King <gavin@hibernate.org>
2024-10-23 16:32:54 +02:00
Gavin King
517056140f
split a rant into two rants
...
Signed-off-by: Gavin King <gavin@hibernate.org>
2024-10-23 16:12:25 +02:00