Some of the examples in the Hibernate ORM’s User Guide contain logical code lines with too many characters to fit in one actual line. Since example code is indented but continuation of wrapped lines isn’t, the result is confusing/suboptimal.

For example, example #2, in section 2.2.2. PhysicalNamingStrategy, contains the following logical line of code, which - no matter what the zoom level is - displays on 2 actual lines:

public Identifier toPhysicalTableName(Identifier name, JdbcEnvironment jdbcEnvironment) {

That example alone contains at least 3 more examples of poorly wrapped lines, as can be seen in the following screenshot:

At least the following can solve or mitigate:

1. Reducing the length (number of characters) of logical lines (splitting them manually)

2. Use a smaller font

3. Reduce the document’s huge lateral margins (the white zones around the smaller yellow margins )

4. Add visual indicators identifying wrapped lines