]> git.ipfire.org Git - thirdparty/kea.git/commitdiff
[#4031] Convert some leftover docs from autotools to meson Kea-3.1.0
authorAndrei Pavel <andrei@isc.org>
Mon, 28 Jul 2025 07:31:47 +0000 (10:31 +0300)
committerAndrei Pavel <andrei@isc.org>
Mon, 28 Jul 2025 07:31:47 +0000 (10:31 +0300)
doc/devel/bison.dox
doc/sphinx/kea-messages.rst
doc/sphinx/mes2doc.py

index 5224e3e4277e201512d3f64d2f4c487989368b54..d6430930d018de7d603ac426c7787aa0c3e16fc3 100644 (file)
@@ -46,7 +46,7 @@ https://gitlab.isc.org/isc-projects/kea/wikis/designs/simple-parser-design.
 @section parserBisonIntro Flex/Bison Based Parser
 
 To solve the issue of phase 1 mentioned earlier, a new parser has been developed that is based on
-the "flex and "bison" tools. The following text uses DHCPv6 as an example, but the same principle
+the flex and bison tools. The following text uses DHCPv6 as an example, but the same principle
 applies to DHCPv4 and D2; CA will likely to follow. The new parser consists of two core elements
 with a wrapper around them.  The following descriptions are slightly oversimplified in order to
 convey the intent; a more detailed description is available in subsequent sections.
@@ -115,12 +115,6 @@ meson setup build
 meson compile -C build grammar
 @endcode
 
-Strictly speaking, the comment "make parser" is not necessary. If you updated the .ll or .yy file,
-the regular "make" command should pick those changes up. However, since one source file generates
-multiple output files and you are likely to be using a multi-process build (by specifying the "-j"
-switch on the "make" command), there may be odd side effects: explicitly rebuilding the files
-manually by using "make parser" avoids any trouble.
-
 One problem brought on by use of flex/bison is tool version dependency. If one developer uses
 version A of those tools and another developer uses B, the files generated by the different version
 may be significantly different. This causes all sorts of problems, e.g.  coverity/cpp-check issues
@@ -450,7 +444,7 @@ Here's the complete set of changes that were necessary.
                 ;
    @endcode
 
-5. Regenerate the flex/bison files by typing "make parser".
+5. Regenerate the flex/bison files by typing "meson compile parser".
 
 6. Run the unit-tests that you wrote before you touched any of the bison stuff. You did write them
    in advance, right?
index 29d2cebf432af548342d556ff77935f09cfd6d5a..1d8c3ffaa30fd1874a7b44152d8197d54761cf8a 100644 (file)
@@ -1,5 +1,5 @@
 ..
-    File generated by "doc/sphinx/mes2doc.py" or by "make -C doc/sphinx". Do not edit by hand.
+    File generated by "doc/sphinx/mes2doc.py" or by "meson compile mes-doc". Do not edit by hand.
 
 .. _kea-messages:
 
index e4eaf962d12d81bde032c6c6717376574e43c9e3..bbd71ef95733af4b90bd7a8fe5594edb443010c9 100755 (executable)
@@ -82,7 +82,7 @@ def read_input_files(files):
 
 def generate_rst(messages):
     rst = '..\n'
-    rst += '    File generated by "doc/sphinx/mes2doc.py" or by "make -C doc/sphinx". Do not edit by hand.\n\n'
+    rst += '    File generated by "doc/sphinx/mes2doc.py" or by "meson compile mes-doc". Do not edit by hand.\n\n'
 
     rst += '''.. _kea-messages: