This is an automated email from the ASF dual-hosted git repository. matrei pushed a commit to branch doc-links in repository https://gitbox.apache.org/repos/asf/grails-core.git
commit c8fb6af583a173d08926aa03a126ebf6de2a7aa0 Author: Mattias Reichel <[email protected]> AuthorDate: Mon Jan 26 21:03:37 2026 +0100 docs: fix links --- grails-doc/src/en/guide/GORM/quickStartGuide.adoc | 4 ++-- .../src/en/guide/GORM/quickStartGuide/basicCRUD.adoc | 16 ++++++++-------- .../src/en/guide/commandLine/creatingCustomCommands.adoc | 2 +- .../en/guide/conf/dataSource/multipleDatasources.adoc | 2 +- grails-doc/src/en/guide/conf/docengine.adoc | 2 +- 5 files changed, 13 insertions(+), 13 deletions(-) diff --git a/grails-doc/src/en/guide/GORM/quickStartGuide.adoc b/grails-doc/src/en/guide/GORM/quickStartGuide.adoc index 9dcddc0697..31337cad2f 100644 --- a/grails-doc/src/en/guide/GORM/quickStartGuide.adoc +++ b/grails-doc/src/en/guide/GORM/quickStartGuide.adoc @@ -17,7 +17,7 @@ specific language governing permissions and limitations under the License. //// -A domain class can be created with the <<ref-command-line-create-domain-class,create-domain-class>> command: +A domain class can be created with the link:{commandLineRef}create-domain-class.html[create-domain-class] command: [source,groovy] ---- @@ -49,7 +49,7 @@ class Person { } ---- -Once you have a domain class try and manipulate it with the <<ref-command-line-shell,shell>> or <<ref-command-line-console,console>> by typing: +Once you have a domain class try and manipulate it with the link:{commandLineRef}shell.html[shell] or link:{commandLineRef}console.html[console] by typing: [source,groovy] ---- diff --git a/grails-doc/src/en/guide/GORM/quickStartGuide/basicCRUD.adoc b/grails-doc/src/en/guide/GORM/quickStartGuide/basicCRUD.adoc index 8052be3c66..bd548f3fdd 100644 --- a/grails-doc/src/en/guide/GORM/quickStartGuide/basicCRUD.adoc +++ b/grails-doc/src/en/guide/GORM/quickStartGuide/basicCRUD.adoc @@ -23,7 +23,7 @@ Try performing some basic CRUD (Create/Read/Update/Delete) operations. === Create -To create a domain class use Map constructor to set its properties and call <<ref-domain-classes-save,save>>: +To create a domain class use Map constructor to set its properties and call link:{domainClassesRef}save.html[save]: [source,groovy] ---- @@ -31,7 +31,7 @@ def p = new Person(name: "Fred", age: 40, lastVisit: new Date()) p.save() ---- -The <<ref-domain-classes-save,save>> method will persist your class to the database using the underlying Hibernate ORM layer. +The link:{domainClassesRef}save.html[save] method will persist your class to the database using the underlying Hibernate ORM layer. === Read @@ -45,8 +45,8 @@ def p = Person.get(1) assert 1 == p.id ---- -This uses the <<ref-domain-classes-get,get>> method that expects a database identifier to read the `Person` object back from the database. -You can also load an object in a read-only state by using the <<ref-domain-classes-read,read>> method: +This uses the link:{domainClassesRef}get.html[get] method that expects a database identifier to read the `Person` object back from the database. +You can also load an object in a read-only state by using the link:{domainClassesRef}read.html[read] method: [source,groovy] ---- @@ -54,9 +54,9 @@ def p = Person.read(1) ---- In this case the underlying Hibernate engine will not do any dirty checking and the object will not be persisted. Note that -if you explicitly call the <<ref-domain-classes-save,save>> method then the object is placed back into a read-write state. +if you explicitly call the link:{domainClassesRef}save.html[save] method then the object is placed back into a read-write state. -In addition, you can also load a proxy for an instance by using the <<ref-domain-classes-load,load>> method: +In addition, you can also load a proxy for an instance by using the link:{domainClassesRef}load.html[load] method: [source,groovy] ---- @@ -70,7 +70,7 @@ throws an exception if no record is found for the specified id. === Update -To update an instance, change some properties and then call <<ref-domain-classes-save,save>> again: +To update an instance, change some properties and then call link:{domainClassesRef}save.html[save] again: [source,groovy] ---- @@ -83,7 +83,7 @@ p.save() === Delete -To delete an instance use the <<ref-domain-classes-delete,delete>> method: +To delete an instance use the link:{domainClassesRef}delete.html[delete] method: [source,groovy] ---- diff --git a/grails-doc/src/en/guide/commandLine/creatingCustomCommands.adoc b/grails-doc/src/en/guide/commandLine/creatingCustomCommands.adoc index 84ceb9249f..61d704de67 100644 --- a/grails-doc/src/en/guide/commandLine/creatingCustomCommands.adoc +++ b/grails-doc/src/en/guide/commandLine/creatingCustomCommands.adoc @@ -18,7 +18,7 @@ under the License. //// -You can create your own commands by running the <<ref-command-line-create-command,create-command>> command from the root of your project. For example the following command will create a command called `grails-app/commands/HelloWorldCommand`: +You can create your own commands by running the link:{commandLineRef}create-command.html[create-command] command from the root of your project. For example the following command will create a command called `grails-app/commands/HelloWorldCommand`: [source,groovy] ---- diff --git a/grails-doc/src/en/guide/conf/dataSource/multipleDatasources.adoc b/grails-doc/src/en/guide/conf/dataSource/multipleDatasources.adoc index 2d915ebf33..a3162df772 100644 --- a/grails-doc/src/en/guide/conf/dataSource/multipleDatasources.adoc +++ b/grails-doc/src/en/guide/conf/dataSource/multipleDatasources.adoc @@ -276,7 +276,7 @@ grails: The https://www.infoworld.com/article/2177690/distributed-transactions-in-spring-with-and-without-xa.html[Best Efforts 1PC pattern] is fairly general but can fail in some circumstances that the developer must be aware of. -This is a non-XA pattern that involves a synchronized single-phase commit of a number of resources. Because the <<ref-orgwiki-twophasecommit-2PC,2PC>> is not used, it can never be as safe as an <<ref-orgwiki-x-open-xa-XA,XA>> transaction, but is often good enough if the participants are aware of the compromises. +This is a non-XA pattern that involves a synchronized single-phase commit of a number of resources. Because the https://en.wikipedia.org/wiki/Two-phase_commit_protocol[2PC] is not used, it can never be as safe as an https://en.wikipedia.org/wiki/X/Open_XA[XA] transaction, but is often good enough if the participants are aware of the compromises. The basic idea is to delay the commit of all resources as late as possible in a transaction so that the only thing that can go wrong is an infrastructure failure (not a business-processing error). Systems that rely on Best Efforts 1PC reason that infrastructure failures are rare enough that they can afford to take the risk in return for higher throughput. If business-processing services are also designed to be idempotent, then little can go wrong in practice. diff --git a/grails-doc/src/en/guide/conf/docengine.adoc b/grails-doc/src/en/guide/conf/docengine.adoc index 1827faa9a6..d5dfbfb7c4 100644 --- a/grails-doc/src/en/guide/conf/docengine.adoc +++ b/grails-doc/src/en/guide/conf/docengine.adoc @@ -204,7 +204,7 @@ To link to reference items you can use a special syntax: [source,groovy] ---- -<<ref-controllers-renderPDF,renderPDF>> +link:{controllersRef}renderPDF.html[renderPDF] ---- In this case the category of the reference item is on the right hand side of the | and the name of the reference item on the left.
