Uploaded image for project: 'WiredTiger'
  1. WiredTiger
  2. WT-9504

Fix documentation output for specially constructed join statistics strings

    • Type: Icon: Bug Bug
    • Resolution: Fixed
    • Priority: Icon: Minor - P4 Minor - P4
    • 6.1.0-rc0, WT11.1.0
    • Affects Version/s: None
    • Component/s: None
    • Labels:
      None

      Currently in the docs under "Statistics for join cursors" we get:

      #define  WT_STAT_JOIN_MAIN_ACCESS
        : accesses to the main table

      which in addition to being missing "join" before the colon, doesn't document that what actually comes through is "join: table:mytable: accesses to the main table".

      This is because the magic that sets up the substitution of the table/index name into the stat name is a little bit too much magic and the code that generates the descriptions into wiredtiger.in can't cope with it.

      I tried to fix this naively as part of WT-9492, but that didn't work (did not understand everything that was going on at the time) and had to revert the change there.

      I have a new change that rearranges it all slightly so that the docs come out better.

        1. join-stats.diff
          5 kB
          David Holland

            Assignee:
            donald.anderson@mongodb.com Donald Anderson
            Reporter:
            dholland+wt@sauclovia.org David Holland
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: