[#423] Eliminate asciidoctor warning messages when generating documentation...

Maxim Thomas

14.24.2024 63f46981fcd6974fbaed6335205d22f5135b4e9e

[#423] Eliminate asciidoctor warning messages when generating documentation (#429)

 opendj-doc-generated-ref/pom.xml

@@ -565,6 +565,9 @@
                                            <fileset dir="${basedir}/src/main/asciidoc/man-pages" includes="**/*" />
                                            <fileset dir="${project.build.directory}/asciidoc/source/man-pages" includes="**/*" />
                                        </copy>
                                        <delete>
                                            <fileset dir="${project.build.directory}/asciidoc/source/man-pages" includes="man-*-subcommands-ref*" />
                                        </delete>
                                    </tasks>
                                </configuration>
                            </execution>

 opendj-doc-generated-ref/src/main/asciidoc/admin-guide/chap-admin-tools.adoc

@@ -320,7 +320,7 @@
The `make-ldif` command is designed to help generate test data that mimics data expected in production, but without compromising real, potentially private information.

+
For details see xref:../reference/admin-tools-ref.adoc#make-ldif-1[make-ldif(1)] in the __Reference__.
For details see xref:../reference/admin-tools-ref.adoc#makeldif-1[makeldif(1)] in the __Reference__.

`manage-account`::
Lock and unlock user accounts, and view and manipulate password policy state information.

 opendj-doc-generated-ref/src/main/asciidoc/admin-guide/chap-import-export.adoc

@@ -40,7 +40,7 @@
[#generating-ldif]
=== Generating Test Data

When you install OpenDJ, you have the option of importing sample data that is generated during the installation. This procedure demonstrates how to generate LDIF by using the `make-ldif` command, described in xref:../reference/admin-tools-ref.adoc#make-ldif-1[make-ldif(1)] in the __Reference__.
When you install OpenDJ, you have the option of importing sample data that is generated during the installation. This procedure demonstrates how to generate LDIF by using the `make-ldif` command, described in xref:../reference/admin-tools-ref.adoc#makeldif-1[makeldif(1)] in the __Reference__.

[#generate-ldif]
.To Generate Test LDIF Data

 opendj-doc-generated-ref/src/main/asciidoc/admin-guide/chap-tuning.adoc

@@ -112,7 +112,7 @@

In your test environment, you set up OpenDJ as you will later in production, and then conduct experiments to determine how best to meet the requirements defined in the SLA.

Use the `make-ldif` command, described in xref:../reference/admin-tools-ref.adoc#make-ldif-1[make-ldif(1)] in the __Reference__, to generate sample data that match what you expect to find in production.
Use the `make-ldif` command, described in xref:../reference/admin-tools-ref.adoc#makeldif-1[makeldif(1)] in the __Reference__, to generate sample data that match what you expect to find in production.

The OpenDJ LDAP Toolkit provides command-line tools to help with basic performance testing:


 opendj-doc-generated-ref/src/main/asciidoc/man-pages/man-dsjavaproperties.adoc

@@ -25,7 +25,7 @@
:mansource: OpenDJ

== Name
dsjavaproperties — apply OpenDJ Java home and JVM settings
dsjavaproperties - apply OpenDJ Java home and JVM settings

== Synopsis
`dsjavaproperties`

 opendj-doc-generated-ref/src/main/asciidoc/man-pages/man-makeldif-template.adoc

@@ -23,7 +23,7 @@
:mansource: OpenDJ

== Name
makeldif-template — template file for the make-ldif command
makeldif-template - template file for the make-ldif command

== Synopsis

@@ -267,4 +267,4 @@

== See Also

xref:#make-ldif-1[make-ldif(1)], the OpenDJ directory server template file `/path/to/opendj/config/MakeLDIF/example.template`
xref:#makeldif-1[makeldif(1)], the OpenDJ directory server template file `/path/to/opendj/config/MakeLDIF/example.template`

 opendj-doc-generated-ref/src/main/asciidoc/man-pages/man-windows-service.adoc

@@ -25,7 +25,7 @@
:mansource: OpenDJ

== Name
windows-service — register OpenDJ as a Windows Service
windows-service - register OpenDJ as a Windows Service

== Synopsis
`windows-service` {options}

 opendj-doc-generated-ref/src/main/asciidoc/reference/appendix-rest2ldap.adoc

 opendj-doc-generated-ref/src/main/asciidoc/server-dev-guide/chap-ldap-operations.adoc

@@ -260,7 +260,7 @@
The `make-ldif` command is designed to help generate test data that mimics data expected in production, but without compromising real, potentially private information.

+
For details see xref:../reference/admin-tools-ref.adoc#make-ldif-1[make-ldif(1)] in the __Reference__.
For details see xref:../reference/admin-tools-ref.adoc#makeldif-1[makeldif(1)] in the __Reference__.

`manage-account`::
Lock and unlock user accounts, and view and manipulate password policy state information.