eclipse-ee4j#24303 Fix links to the App development guide

Signed-off-by:Ondro Mihalyi <mihalyi@omnifish.ee>

docs/administration-guide/src/main/asciidoc/connectors.adoc

@@ -54,7 +54,7 @@ is a Jakarta EE component that enables applications to interact with EIS
 software. A connector module is used by {productName} to implement
 Java Message Service (JMS). Like other Jakarta EE modules, a connector
 module is installed when it is deployed. For instructions on creating a
-connector module, see "link:application-development-guide/connectors.html#developing-connectors[Developing Connectors]" in
+connector module, see "xref:application-development-guide.adoc#developing-connectors[Developing Connectors]" in
 {productName} Application Development Guide.
 * Connector Connection Pool. A connector connection pool is a group of
 reusable connections for a particular EIS. A connector connection pool

docs/administration-guide/src/main/asciidoc/jdbc.adoc

@@ -1059,12 +1059,12 @@ To integrate the JDBC driver into a {productName} domain, copy the
 JAR files into the domain-dir``/lib`` directory, then restart the server.
 This makes classes accessible to all applications or modules deployed on
 servers that share the same configuration. For more information about
-{productName} class loaders, see "link:application-development-guide/class-loaders.html#class-loaders[Class Loaders]" in
+{productName} class loaders, see "xref:application-development-guide.adoc#class-loaders[Class Loaders]" in
 {productName} Application Development Guide.
 
 If you are using an Oracle database with EclipseLink extensions, copy
 the JAR files into the domain-dir``/lib/ext`` directory, then restart the
-server. For details, see "link:application-development-guide/jpa.html#oracle-database-enhancements[Oracle Database
+server. For details, see "xref:application-development-guide.adoc#oracle-database-enhancements[Oracle Database
 Enhancements]" in {productName} Application
 Development Guide.
 

docs/administration-guide/src/main/asciidoc/jms.adoc

@@ -1393,7 +1393,7 @@ MW_HOME``/server/lib``.
 * It is also possible to deploy the Thin T3 client in a less global
 manner, so that it is specific to an individual application. For
 information on how to do this, see
-"link:application-development-guide/class-loaders.html#application-specific-class-loading[Application-Specific Class Loading]" in {productName} Application Development Guide.
+"xref:application-development-guide.adoc#application-specific-class-loading[Application-Specific Class Loading]" in {productName} Application Development Guide.
 
 [[configure-weblogic-jms-resources-for-integration]]
 

docs/administration-guide/src/main/asciidoc/lifecycle-modules.adoc

@@ -47,7 +47,7 @@ the containers.
 subsystems, and the server runtime environment.
 
 These events are defined in the `LifecycleEvent` class. For information
-on creating life cycle modules, see "link:application-development-guide/lifecycle-listeners.html#developing-lifecycle-listeners[Developing
+on creating life cycle modules, see "xref:application-development-guide.adoc#developing-lifecycle-listeners[Developing
 Lifecycle Listeners]" in {productName}
 Application Development Guide.
 

docs/application-deployment-guide/src/main/asciidoc/dd-elements.adoc

@@ -313,7 +313,7 @@ JAAS is available on the ACC. Defines the optional configuration for a
 JAAS authentication realm. Authentication realms require
 provider-specific properties, which vary depending on what a particular
 implementation needs. For more information about how to define realms,
-see "link:application-development-guide/securing-apps.html#realm-configuration[Realm Configuration]" in {productName} Application Development Guide.
+see "xref:application-development-guide.adoc#realm-configuration[Realm Configuration]" in {productName} Application Development Guide.
 
 [[superelements-8]]
 
@@ -378,7 +378,7 @@ Here is an example of the default file realm:
 Which properties an `auth-realm` element uses depends on the value of
 the `auth-realm` element's `name` attribute. The file realm uses `file`
 and `jaas-context` properties. Other realms use different properties.
-See "link:application-development-guide/securing-apps.html#realm-configuration[Realm Configuration]" in {productName} Application Development Guide.
+See "xref:application-development-guide.adoc#realm-configuration[Realm Configuration]" in {productName} Application Development Guide.
 
 [[backend-principal]]
 
@@ -1578,7 +1578,7 @@ xref:#fetched-with[`fetched-with`]
 === `cmp-resource`
 
 Specifies the database to be used for storing CMP beans. For more
-information about this element, see "link:application-development-guide/container_managed-persistence.html#configuring-the-cmp-resource[Configuring the
+information about this element, see "xref:application-development-guide.adoc#configuring-the-cmp-resource[Configuring the
 CMP Resource]" in {productName} Application
 Development Guide.
 
@@ -2573,7 +2573,7 @@ the database. If `false` (the default if this element is not present),
 does not create tables.
 
 This element can be overridden during deployment. See
-"link:application-development-guide/container_managed-persistence.html#generation-options-for-cmp[Generation Options for CMP]" in {productName} Application Development Guide.
+"xref:application-development-guide.adoc#generation-options-for-cmp[Generation Options for CMP]" in {productName} Application Development Guide.
 
 [[superelements-46]]
 
@@ -2680,7 +2680,7 @@ read. If the connection cannot be established, or if the value is not
 recognized, SQL-92 compliance is presumed.
 
 This element can be overridden during deployment. See
-"link:application-development-guide/container_managed-persistence.html#generation-options-for-cmp[Generation Options for CMP]" in {productName} Application Development Guide.
+"xref:application-development-guide.adoc#generation-options-for-cmp[Generation Options for CMP]" in {productName} Application Development Guide.
 
 [[superelements-48]]
 
@@ -2793,7 +2793,7 @@ engine looks in the `ServletContext` for an attribute with a name equal
 to the value specified for this property to determine whether a
 customized CacheKeyGenerator implementation is used. An application can
 provide a customized key generator rather than using the `default`
-helper. See "link:application-development-guide/webapps.html#the-cachekeygenerator-interface[The CacheKeyGenerator Interface]" in
+helper. See "xref:application-development-guide.adoc#the-cachekeygenerator-interface[The CacheKeyGenerator Interface]" in
 {productName} Application Development Guide.
 |===
 
@@ -2932,7 +2932,7 @@ undeployed. If `true`, drops tables from the database. If `false` (the
 default if this element is not present), does not drop tables.
 
 This element can be overridden during deployment. See
-"link:application-development-guide/container_managed-persistence.html#generation-options-for-cmp[Generation Options for CMP]" in {productName} Application Development Guide.
+"xref:application-development-guide.adoc#generation-options-for-cmp[Generation Options for CMP]" in {productName} Application Development Guide.
 
 [[superelements-56]]
 
@@ -3747,7 +3747,7 @@ subelement. The default subelement is as follows:
 Managed fields are multiple CMP or CMR fields that are mapped to the
 same column. A managed field can have any `fetched-with` subelement
 except `<default/>`. For additional information, see
-"link:application-development-guide/container_managed-persistence.html#managed-fields[Managed Fields]" in {productName} Application Development Guide.
+"xref:application-development-guide.adoc#managed-fields[Managed Fields]" in {productName} Application Development Guide.
 
 [[superelements-68]]
 
@@ -5567,7 +5567,7 @@ from which the message-driven bean consumes JMS messages. This
 information is alternatively specified within the
 xref:#activation-config[`activation-config`] subelement of the
 xref:#mdb-resource-adapter[`mdb-resource-adapter`] element. For more information about
-JMS resources, see "link:application-development-guide/jms.html#using-the-java-message-service[Using the Java Message Service]" in
+JMS resources, see "xref:application-development-guide.adoc#using-the-java-message-service[Using the Java Message Service]" in
 {productName} Application Development Guide.
 
 [[superelements-92]]
@@ -5627,7 +5627,7 @@ the JAR from the path in the JAR:
 ----
 
 For information about the allowed contents of a custom JNLP file, see
-"link:application-development-guide/java-clients.html#developing-java-clients[Developing Java Clients]" in {productName} Application Development Guide.
+"xref:application-development-guide.adoc#developing-java-clients[Developing Java Clients]" in {productName} Application Development Guide.
 
 [[superelements-93]]
 
@@ -8238,7 +8238,7 @@ Specifies the name of the realm used to process all authentication
 requests associated with this application. If this element is not
 specified or does not match the name of a configured realm, the default
 realm is used. For more information about realms, see
-"link:application-development-guide/securing-apps.html#realm-configuration[Realm Configuration]" in {productName} Application Development Guide.
+"xref:application-development-guide.adoc#realm-configuration[Realm Configuration]" in {productName} Application Development Guide.
 
 [[superelements-155]]
 
@@ -9109,7 +9109,7 @@ element is empty, the database schema file is automatically generated at
 deployment time. Otherwise, the `schema` element names a `.dbschema`
 file with a pathname relative to the directory containing the
 `sun-cmp-mappings.xml` file, but without the `.dbschema` extension. See
-"link:application-development-guide/container_managed-persistence.html#automatic-database-schema-capture[Automatic Database Schema Capture]" in {productName} Application Development Guide.
+"xref:application-development-guide.adoc#automatic-database-schema-capture[Automatic Database Schema Capture]" in {productName} Application Development Guide.
 
 [[superelements-176]]
 
@@ -9186,7 +9186,7 @@ Table C-131 `schema-generator-properties` Properties
 |Property |Default |Description
 |`use-unique-table-names` |`false` |Specifies that generated table names
 are unique within each {productName} domain. This property can be
-overridden during deployment. See "link:application-development-guide/container_managed-persistence.html#generation-options-for-cmp[Generation Options
+overridden during deployment. See "xref:application-development-guide.adoc#generation-options-for-cmp[Generation Options
 for CMP]" in {productName} Application
 Development Guide.
 
@@ -9407,7 +9407,7 @@ Table C-136 `security-map` Attributes
 === `security-role-mapping`
 
 Maps roles to users or groups in the currently active realm. See
-"link:application-development-guide/securing-apps.html#realm-configuration[Realm Configuration]" in {productName} Application Development Guide.
+"xref:application-development-guide.adoc#realm-configuration[Realm Configuration]" in {productName} Application Development Guide.
 
 The role mapping element maps a role, as specified in the EJB JAR
 `role-name` entries, to a environment-specific user or group. If it maps
@@ -10278,7 +10278,7 @@ xref:#sun-cmp-mapping[`sun-cmp-mapping`]
 === `table-name`
 
 Specifies the name of a database table. The table must be present in the
-database schema file. See "link:application-development-guide/container_managed-persistence.html#automatic-database-schema-capture[Automatic Database Schema
+database schema file. See "xref:application-development-guide.adoc#automatic-database-schema-capture[Automatic Database Schema
 Capture]" in {productName} Application
 Development Guide.
 

docs/deployment-planning-guide/src/main/asciidoc/concepts.adoc

@@ -414,7 +414,7 @@ Checking an SFSB's state for changes that need to be saved is called
 checkpointing. When enabled, checkpointing generally occurs after any
 transaction involving the SFSB is completed, even if the transaction
 rolls back. For more information on developing stateful session beans,
-see "link:application-development-guide/ejb.html#using-session-beans[Using Session Beans]" in {productName} Application Development Guide. For more information on
+see "xref:application-development-guide.adoc#using-session-beans[Using Session Beans]" in {productName} Application Development Guide. For more information on
 enabling SFSB failover, see "link:ha-administration-guide/session-persistence-and-failover.html#stateful-session-bean-failover[Stateful Session Bean
 Failover]" in {productName} High Availability
 Administration Guide.

docs/deployment-planning-guide/src/main/asciidoc/planning.adoc

@@ -880,7 +880,7 @@ the Message Queue broker cluster.
 For more information about configuring connection factories, see
 "link:administration-guide/jms.html#administering-jms-connection-factories-and-destinations[Administering JMS Connection Factories and
 Destinations]" in {productName} Administration
-Guide. For more information about MDBs, see "link:application-development-guide/ejb.html#using-message-driven-beans[Using
+Guide. For more information about MDBs, see "xref:application-development-guide.adoc#using-message-driven-beans[Using
 Message-Driven Beans]" in {productName}
 Application Development Guide.
 

docs/ha-administration-guide/src/main/asciidoc/instances.adoc

@@ -1335,7 +1335,7 @@ out of date in the cache.
   domain. Typically, these directories contain common JDBC drivers and
   other utility libraries that are shared by all applications in the domain. +
   The contents of these directories are loaded by the common class
-  loader. For more information, see "link:application-development-guide/class-loaders.html#using-the-common-class-loader[
+  loader. For more information, see "xref:application-development-guide.adoc#using-the-common-class-loader[
   Using the Common Class Loader]" in {productName} Application
   Development Guide.
   The class loader loads the contents of these directories in the following order:

docs/ha-administration-guide/src/main/asciidoc/rmi-iiop.adoc

@@ -163,7 +163,7 @@ load balancing is also supported.
 This procedure provides an overview of the steps necessary to enable
 RMI-IIOP load balancing and failover with the application client
 container (ACC). For additional information on the ACC, see
-"link:application-development-guide/java-clients.html#developing-clients-using-the-acc[Developing Clients Using the ACC]" in {productName} Application Development Guide.
+"xref:application-development-guide.adoc#developing-clients-using-the-acc[Developing Clients Using the ACC]" in {productName} Application Development Guide.
 
 Before You Begin
 
@@ -395,7 +395,7 @@ In this example, an EJB named `TheGreeter` is used.
 For instructions on developing and assembling an EJB for deployment to
 {productName}, refer to the following documentation:
 
-* "link:application-development-guide/ejb.html#using-enterprise-javabeans-technology[Using Enterprise JavaBeans Technology]" in {productName} Application Development Guide
+* "xref:application-development-guide.adoc#using-enterprise-javabeans-technology[Using Enterprise JavaBeans Technology]" in {productName} Application Development Guide
 * "link:application-deployment-guide/deploying-applications.html#ejb-module-deployment-guidelines[EJB Module Deployment Guidelines]" in {productName} Application Deployment Guide
 * "link:application-deployment-guide/deploying-applications.html#assembling-and-deploying-an-application-client-module[Assembling and Deploying an Application Client
 Module]" in {productName} Application Deployment Guide

docs/performance-tuning-guide/src/main/asciidoc/overview.adoc

@@ -522,7 +522,7 @@ http://java.sun.com/developer/technicalArticles/ebeans/sevenrules/[Seven
 Rules for Optimizing Entity Beans]
 (`http://java.sun.com/developer/technicalArticles/ebeans/sevenrules/`)
 * For details on profiling,
-see "link:application-development-guide/setting-up-dev-env.html#profiling-tools[
+see "xref:application-development-guide.adoc#profiling-tools[
 Profiling Tools]" in {productName} Application Development Guide.
 * To view a demonstration video showing how to use the {productName} Performance Tuner,
 see the http://www.youtube.com/watch?v=FavsE2pzAjc[

docs/performance-tuning-guide/src/main/asciidoc/tuning-apps.adoc

@@ -282,7 +282,7 @@ the server `CLASSPATH`. Put application-related classes into JAR files.
 the HTTP server is tuned in general. For more information, see
 xref:tuning-glassfish.adoc#http-service-settings[HTTP Service Settings].
 * Cache servlet results when possible. For more information, see
-"link:application-development-guide/webapps.html#developing-web-applications[Developing Web Applications]" in {productName} Application Development Guide.
+"xref:application-development-guide.adoc#developing-web-applications[Developing Web Applications]" in {productName} Application Development Guide.
 * If an application does not contain any EJB components, deploy the
 application as a WAR file, not an EAR file.
 
@@ -324,7 +324,7 @@ with the `server.policy` file. If you are sure that no malicious code
 will be run on the server and you do not use authentication within your
 application, then you can disable the security manager.
 
-See "link:application-development-guide/securing-apps.html#enabling-and-disabling-the-security-manager[Enabling and Disabling the Security Manager]" in
+See "xref:application-development-guide.adoc#enabling-and-disabling-the-security-manager[Enabling and Disabling the Security Manager]" in
 {productName} Application Development Guide for
 instructions on enabling or disabling the security manager. If using the
 {productName} Administration Console, navigate to the
@@ -710,7 +710,7 @@ or a single EJB component. When specified at the application level, all
 beans in the application use pass-by-reference semantics when passing
 arguments to their remote interfaces. When specified at the bean level,
 all calls to the remote interface of the bean use pass-by-reference
-semantics. See "link:application-development-guide/ejb.html#value-added-features[Value Added Features]" in {productName} Application Development Guide for more
+semantics. See "xref:application-development-guide.adoc#value-added-features[Value Added Features]" in {productName} Application Development Guide for more
 details about the pass-by-reference flag.
 
 To specify that an EJB component will use pass by reference semantics,

docs/reference-manual/src/main/asciidoc/add-library.adoc

@@ -70,7 +70,7 @@ asadmin-options::
 
 +
 For more information about these directories, see
-"link:application-development-guide/class-loaders.html#class-loaders[Class Loaders]"
+"xref:application-development-guide.adoc#class-loaders[Class Loaders]"
 in {productName} Application Development Guide.
 
 `--upload`::
@@ -133,6 +133,6 @@ xref:asadmin.adoc#asadmin[`asadmin`(1M)]
 xref:list-libraries.adoc#list-libraries[`list-libraries`(1)],
 xref:remove-library.adoc#remove-library[`remove-library`(1)]
 
-"link:application-development-guide/class-loaders.html#class-loaders[Class Loaders]" in {productName} Application Development Guide
+"xref:application-development-guide.adoc#class-loaders[Class Loaders]" in {productName} Application Development Guide
 
 

docs/reference-manual/src/main/asciidoc/create-lifecycle-module.adoc

@@ -122,6 +122,6 @@ xref:asadmin.adoc#asadmin[`asadmin`(1M)]
 xref:delete-lifecycle-module.adoc#delete-lifecycle-module[`delete-lifecycle-module`(1)],
 xref:list-lifecycle-modules.adoc#list-lifecycle-modules[`list-lifecycle-modules`(1)]
 
-"link:application-development-guide/lifecycle-listeners.html#developing-lifecycle-listeners[Developing Lifecycle Listeners]" in {productName} Application Development Guide
+"xref:application-development-guide.adoc#developing-lifecycle-listeners[Developing Lifecycle Listeners]" in {productName} Application Development Guide
 
 

docs/reference-manual/src/main/asciidoc/create-virtual-server.adoc

@@ -161,7 +161,7 @@ The default value is `true`.
   `contextXmlDefault`;;
     Specifies the location, relative to domain-dir, of the `context.xml`
     file for this virtual server, if one is used. For more information
-    about the `context.xml` file, see "link:application-development-guide/webapps.html#GSDVG00416[Using a
+    about the `context.xml` file, see "xref:application-development-guide.adoc#GSDVG00416[Using a
     context.xml File]" in {productName}
     Application Development Guide and The Context Container
     (`http://tomcat.apache.org/tomcat-5.5-doc/config/context.html`).