Bug #69340 MySQL Enterprise Backup --backup partial backup option is defined incorrectly

• Submitted: 28 May 2013 22:16
• Modified: 11 Jun 2013 22:35
• Reporter: Lynn Ferrante
• Status: Closed
• Category: MySQL Enterprise Backup Documentation
• Severity: S3 (Non-critical)
• Version: 3.8.1
• OS: Any
• Assigned to: Daniel So
• CPU Architecture: Any
• Tags: --databases, Backup, meb, Partial

[28 May 2013 22:16] Lynn Ferrante

Description:
MySQL Enterprise Backup command line option --databases is defined differently on different documentation pages:

On this page:
http://dev.mysql.com/doc/mysql-enterprise-backup/3.7/en/partial.html
it says

    MySQL Enterprise Backup can make several kinds of partial backup:
    *Including certain database directories but not others. *This
    operation involves the |--databases|
    <http://dev.mysql.com/doc/mysql-enterprise-backup/3.7/en/backup-partial-options.html#option...>
    and |--databases-list-file|
    <http://dev.mysql.com/doc/mysql-enterprise-backup/3.7/en/backup-partial-options.html#option...>
    options.

But on this page
http://dev.mysql.com/doc/mysql-enterprise-backup/3.7/en/backup-partial-options.html#option...
(get to this by clicking on --databases link above)
it says:

  *

    |--databases|=/|LIST|/

    *Filters the list of non-InnoDB tables to back up.* To filter InnoDB
    tables, use the |--include|
    <http://dev.mysql.com/doc/mysql-enterprise-backup/3.7/en/backup-partial-options.html#option...>
    option. The argument specifies a space-separated list of
    database/table names of the following form:

    "/|db_name|/[./|table_name|/]/|db_name1|/[./|table_name1|/] ...".

    By default, all databases are backed up.

They seem to have two separate meanings.  I believe the second one to be
the correct definition.  The first page should be corrected.  Thanks.

How to repeat:
This is a documentation bug 

Suggested fix:
USe same definition on both pages listed above (change http://dev.mysql.com/doc/mysql-enterprise-backup/3.7/en/partial.html )

[5 Jun 2013 22:35] Sveta Smirnova

Thank you fro the report.

Verified as described.

[11 Jun 2013 22:35] Daniel So

Made changes to descriptions of the "--databases" and "--databases-list-file" options at various places in the User's Guide, specifying that they are for selecting "non-InnoDB tables from selected databases."