MySQL Bugs: #101534: Small changes needed in Documentation

Bug #101534	Small changes needed in Documentation
Submitted:	10 Nov 2020 8:40	Modified:	12 Nov 2020 14:04
Reporter:	pon suresh pandian soundara rajan	Email Updates:
Status:	Closed	Impact on me:	None
Category:	MySQL Server: Documentation	Severity:	S3 (Non-critical)
Version:	MySQL 8.0.22	OS:	Any (centos)
Assigned to:		CPU Architecture:	x86

Description:
Hi Team,

I am testing the mysql shell utilities I found one mistake in MySQL documentation.

Doc Link - https://dev.mysql.com/doc/mysql-shell/8.0/en/mysql-shell-utilities-dump-instance-schema.ht...

In MySQL documentation they mentioned dumpschemas in example : (shell-py> util.dump_schemas)

But actual name is (util.dumpSchemas) 
 
MySQL  localhost:3306 ssl  cart  JS > util.dump_schemas(["cart"], "/home/vagrant/production_backup",{dryRun: true,threads :3})
Invalid object member dump_schemas (AttributeError)

Then I try like this,It's working fine.

MySQL  localhost:3306 ssl  cart  JS > util.dump
dumpInstance()  dumpSchemas()   dumpTables()
 

MySQL  localhost:3306 ssl  cart  JS > util.dumpSchemas(["cart"], "/home/vagrant/production_backup",{dryRun: true,threads :3})
Acquiring global read lock
Global read lock acquired
All transactions have been started

Kindly make the necessary changes in Documentation .

Thanks,

Pon Suresh

How to repeat:
MySQL  localhost:3306 ssl  cart  JS > util.dump
dumpInstance()  dumpSchemas()   dumpTables()

Suggested fix:
Kindly update to (util.dumpSchemas) in documentation.

Hello pon suresh pandian,

Thank you for the report and feedback.

regards,
Umesh

Posted by developer:
 
Thank you for the comment. The example that did not work is actually in Python mode (with shell-py as the prompt), where naming uses underscores. I see you tried it in Javascript mode. It was not clear from the topic that the example was in Python mode, as there was only the prompt to indicate it and that could be overlooked easily. So I have now added before each example what mode is used, in order to clarify. Thanks for helping us to improve the documentation.