Uploaded image for project: 'MariaDB Server'
  1. MariaDB Server
  2. MDEV-7680

Many man pages are outdated, tagged MySQL 5.1

    Details

      Description

      A Debian user pointed out that the man pages seem outdated. Most of them are labeled MySQL 5.1 and at least some of them contain outdated information.

      See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=779992

      Man pages should be reviewed and updated to make sure they are as current as they can be.

        Gliffy Diagrams

          Attachments

            Activity

            Hide
            elenst Elena Stepanova added a comment -

            I can see that, at the very least, the pages are indeed marked as "Source: MySQL 5.1", even in 10.1. I'm not sure what should be the exact process of synchronizing them with up-to-date MariaDB documentation.

            Show
            elenst Elena Stepanova added a comment - I can see that, at the very least, the pages are indeed marked as "Source: MySQL 5.1", even in 10.1. I'm not sure what should be the exact process of synchronizing them with up-to-date MariaDB documentation.
            Hide
            greenman Ian Gilfillan added a comment -

            This is related to MDEV-6521 - if there was a way to export content from the KnowledgeBase, updated man pages could probably be generated quite easily.

            It's probably best for now to use the updated mysql versions, if that's possible.

            Show
            greenman Ian Gilfillan added a comment - This is related to MDEV-6521 - if there was a way to export content from the KnowledgeBase, updated man pages could probably be generated quite easily. It's probably best for now to use the updated mysql versions, if that's possible.
            Hide
            greenman Ian Gilfillan added a comment -

            These have been updated for 10.0. Not going to fix for 5.5, as there were a lot of 10.0-specific changes in the pages, and it's not worth going through to remove these for the old stable version.

            Show
            greenman Ian Gilfillan added a comment - These have been updated for 10.0. Not going to fix for 5.5, as there were a lot of 10.0-specific changes in the pages, and it's not worth going through to remove these for the old stable version.
            Hide
            otto Otto Kekäläinen added a comment -

            Ian Gilfillan Thanks! Yes, don't fix for 5.5. Only 10.0 and 10.1 are relevant. The bug in Debian is about 10.0 contents.

            Show
            otto Otto Kekäläinen added a comment - Ian Gilfillan Thanks! Yes, don't fix for 5.5. Only 10.0 and 10.1 are relevant. The bug in Debian is about 10.0 contents.
            Hide
            simon.mudd Simon J Mudd added a comment -

            Note: this is not just a bug in Debian documentation.

            • I see the same on RHEL/CentOS 6 rpms. My guess is it is a generic problem.

            I also agree that given 10.0 is the current release it does not make much sense in fixing this for older versions, so resolving this in 10.0 and later seems fine.

            Show
            simon.mudd Simon J Mudd added a comment - Note: this is not just a bug in Debian documentation. I see the same on RHEL/CentOS 6 rpms. My guess is it is a generic problem. I also agree that given 10.0 is the current release it does not make much sense in fixing this for older versions, so resolving this in 10.0 and later seems fine.

              People

              • Assignee:
                greenman Ian Gilfillan
                Reporter:
                otto Otto Kekäläinen
              • Votes:
                1 Vote for this issue
                Watchers:
                5 Start watching this issue

                Dates

                • Created:
                  Updated: