docs: cpp-tagfiles is antora extension

doc/antora.yml

@@ -23,4 +23,8 @@ ext:
       command: node doc/generate-files.mjs
     scan:
       dir: doc/build/generated-files
+  cpp-tagfiles:
+    files:
+      - file: ./doc/tagfiles/boost-system-doxygen.tag.xml
+        base_url: https://www.boost.org/doc/libs/master/libs/system/doc/html/
 

doc/local-playbook.yml

@@ -34,6 +34,7 @@ antora:
     - require: '@antora/lunr-extension' # https://gitlab.com/antora/antora-lunr-extension
       index_latest_only: true
     - '@antora/collector-extension'
+    - require: ./lib/cpp-tagfiles.js
 asciidoc:
   attributes:
     # Enable pagination
@@ -42,5 +43,4 @@ asciidoc:
     remove-sidenav: ''
   extensions:
     - ./lib/boost-link-inline-macro.js
-    - ./lib/cpp.js
     - '@asciidoctor/tabs'

doc/modules/ROOT/pages/grammar/rules.adoc

@@ -11,7 +11,7 @@
 = Parse Rules
 
 A __Rule__ is an object which tries to match the beginning of an input character buffer against a particular syntax.
-It returns a `result` containing a value if the match was successful, or an `error_code` if the match failed.
+It returns a cpp:boost::system::result[] containing a value if the match was successful, or an `error_code` if the match failed.
 Rules are not invoked directly.
 Instead they are passed as values to a `parse` function, along with the input character buffer to process.
 The first overload requires that the entire input string match, otherwise else an error occurs.

doc/modules/ROOT/pages/quicklook.adoc

@@ -63,7 +63,7 @@ You can parse the string by calling this function:
 include::example$unit/snippets.cpp[tag=code_urls_parsing_2,indent=0]
 ----
 
-The function `parse_uri` returns an object of type ``result`<`url_view`>` which is a container resembling a variant that holds either an error or an object.
+The function `parse_uri` returns an object of type cpp:result<url_view>[] which is a container resembling a variant that holds either an error or an object.
 A number of functions are available to parse different types of URL.
 
 We can immediately call `result::value` to obtain a `url_view`.

doc/tagfiles/boost-system-doxygen.tag.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
+<tagfile>
+  <compound kind="file">
+    <name>boost/system/result</name>
+    <filename>system.html#ref_boostsystemresult_hpp</filename>
+    <namespace>boost::system</namespace>
+  </compound>
+  <compound kind="namespace">
+    <name>boost::system</name>
+    <filename></filename>
+    <class kind="class">boost::system::result</class>
+  </compound>
+  <compound kind="class">
+    <name>boost::system::result</name>
+    <filename>system.html#ref_resultt_e</filename>
+  </compound>
+</tagfile>