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

Minor man pages formatting issues

    XMLWordPrintable

Details

    • Bug
    • Status: Closed (View Workflow)
    • Trivial
    • Resolution: Fixed
    • 5.1.67, 5.2.14, 5.3.12, 5.5.36, 10.0.10
    • 5.5.38, 10.0.12
    • None
    • serg-test-sprint-1

    Description

      While packaging MariaDB I noticed that there are some minor issues in man pages:

      Syntax errors:

      mariadb-client-5.5: manpage-has-errors-from-man usr/share/man/man1/mysqladmin.1.gz 28: warning [p 1, 1.5i]: can't break line
      mariadb-client-5.5: manpage-has-errors-from-man usr/share/man/man1/mysqldump.1.gz 2047: warning [p 12, 1.3i, div `3tbd2,1', 0.2i]: can't break line
      mariadb-client-5.5: manpage-has-errors-from-man usr/share/man/man8/mysqlmanager.8.gz 1509: warning [p 11, 4.8i, div `3tbd7,1', 5.2i]: can't break line
      mariadb-server-5.5: manpage-has-errors-from-man usr/share/man/man1/mysqlbinlog.1.gz 1313: warning [p 9, 1.8i, div `3tbd3,2', 0.8i]: can't break line

      The above should be trivial to fix.

      Missing man pages:

      mariadb-server-5.5: binary-without-manpage usr/bin/aria_chk
      mariadb-server-5.5: binary-without-manpage usr/bin/aria_dump_log
      mariadb-server-5.5: binary-without-manpage usr/bin/aria_ftdump
      mariadb-server-5.5: binary-without-manpage usr/bin/aria_pack
      mariadb-server-5.5: binary-without-manpage usr/bin/aria_read_log
      mariadb-server-5.5: binary-without-manpage usr/bin/mysql_plugin
      mariadb-client-5.5: binary-without-manpage usr/bin/innochecksum
      mariadb-client-5.5: binary-without-manpage usr/bin/mysqlanalyze
      mariadb-client-5.5: binary-without-manpage usr/bin/mysqloptimize
      mariadb-client-5.5: binary-without-manpage usr/bin/mysqlrepair

      The tool help2man (https://www.gnu.org/software/help2man/) might be useful here to quickly create at least some kind of man pages for where they are missing. If some binary is a link to another program, it would be good to have it documented somewhere in the sources.

      Attachments

        Activity

          People

            serg Sergei Golubchik
            otto Otto Kekäläinen
            Votes:
            0 Vote for this issue
            Watchers:
            5 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Git Integration

                Error rendering 'com.xiplink.jira.git.jira_git_plugin:git-issue-webpanel'. Please contact your Jira administrators.