@
SILdoc(`Promotes the ZFS dataset.
Params:
string name: the name of the dataset to promote.
Errors:
NameInvalid: if the dataset name is invalid.
NameTooLong: if the dataset name is too longor if the dataset's origin has a snapshot that, if transferred to the dataset, would get a too long name.
NotClone: if the dataset is not a clone.
FilesystemNotFound: if the dataset does not exist.
SnapshotExists: if the dataset already has a snapshot with the same name as one of the origin's snapshots.
`)