Skip to content

[DOC] Escape ampersand in LDAP group mapping example - #7679

Open
dnskr wants to merge 1 commit into
apache:masterfrom
dnskr:doc-escape-ampersand-in-LDAP-group-mapping-example
Open

[DOC] Escape ampersand in LDAP group mapping example#7679
dnskr wants to merge 1 commit into
apache:masterfrom
dnskr:doc-escape-ampersand-in-LDAP-group-mapping-example

Conversation

@dnskr

@dnskr dnskr commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

Why are the changes needed?

The change is needed to fix the following warning during the documentation build process:

./docs/deployment/engine_share_level.md:156: WARNING: Lexing literal_block 
'<property>\n  <name>hadoop.security.group.mapping</name>\n  <value>org.apache.hadoop.security.LdapGroupsMapping</value>\n</property>\n\n<property>\n  <name>hadoop.security.group.mapping.ldap.url</name>\n  <value>ldap://localhost:389</value>\n</property>\n\n<property>\n  <name>hadoop.security.group.mapping.ldap.base</name>\n  <value>dc=example,dc=com</value>\n</property>\n\n<property>\n  <name>hadoop.security.group.mapping.ldap.bind.user</name>\n  <value>cn=Manager,dc=example,dc=com</value>\n</property>\n\n<property>\n  <name>hadoop.security.group.mapping.ldap.bind.password</name>\n  <value>example</value>\n</property>\n\n<property>\n  <name>hadoop.security.group.mapping.ldap.search.filter.user</name>\n  <value>(&(objectClass=posixAccount)(cn={0}))</value>\n</property>\n\n<property>\n  <name>hadoop.security.group.mapping.ldap.search.filter.group</name>\n  <value>(objectClass=posixGroup)</value>\n</property>\n\n<property>\n  <name>hadoop.security.group.mapping.ldap.search.attr.member</name>\n  <value>memberuid</value>\n</property>\n\n<property>\n  <name>hadoop.security.group.mapping.ldap.search.attr.group.name</name>\n  <value>cn</value>\n</property>\n'
 as "xml" resulted in an error at token: '&'. Retrying in relaxed mode. [misc.highlighting_failure]

The default core-default.xml uses &amp; instead of & character, see here.

How was this patch tested?

Testing by building the documentation and checking there is no warning:

make clean html

The Share Level of Kyuubi Engines page after applying the fix:
image

Was this patch assisted by generative AI tooling?

No

Signed-off-by: Denis Krivenko <dnskrv88@gmail.com>
@dnskr dnskr added this to the v1.13.0 milestone Aug 29, 2026
@github-actions github-actions Bot added the kind:documentation Documentation is a feature! label Aug 29, 2026
@dnskr dnskr self-assigned this Aug 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kind:documentation Documentation is a feature!

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant