RestoreSessionWithDifferentSources Documentation Errors

[JustinPrivitera]

Docs for RestoreSessionWithDifferentSources are wrong.

• typo under mapping : tuple: "mapping" is misspelled as "maping"
• more importantly, the example is incorrect. The example uses the RestoreSession example instead.

[JustinPrivitera]

Also, the mapping argument seems wrong to me. Look at this example of how the function is actually used:

visit/src/test/tests/session/restorewithsources.py

Lines 24 to 26 in b847230

	RestoreSessionWithDifferentSources(tests_path("session","restorewithsources.session"),
	0,
	silo_data_path("rect3d.silo") )

Mapping doesn't appear to be a tuple but is instead just a string with the name of the new data file. That should be corrected as well in the documentation.

[biagas]

I believe the tuple is needed if there are multiple source data files used in the session file (eg multiple plots, each from a different database/file.)

[JustinPrivitera]

Ah that makes sense. I couldn't find any examples of that in our repo. I think whoever adds a correct example to the docs ought to have two examples, one for the simple case and one for the more complicated case.

[JustinPrivitera]

Description is also wrong, it is a copy of the RestoreSession Description.