Bug 1743062

Description of problem:

APIs in the two pm modules have ambiguity for users. This may make users confused.

Version-Release number of selected component (if applicable):

perl-Sys-Virt-5.6.0-1.module+el8.1.0+3908+8a8c5ed4

How reproducible:
100%

Steps to Reproduce:
1.  Below '$net' will be misunderstood with lib/Sys/Virt/Network.pm, but it actually refers to a networkport instead of network. So I strongly recommend we should use another meaningful name, like $netport.


# cat lib/Sys/Virt/NetworkPort.pm
...

=item my $uuid = $net->get_uuid()

=item my $uuid = $net->get_uuid_string()

=item my $xml = $net->get_xml_description()

=item $net->delete()

=item my $params = $net->get_parameters($flags=0);

=item $net->set_parameters($params, $flags=0);

2.  Below '$domss' will be misunderstood with lib/Sys/Virt/DomainSnapshot.pm, but it actually refers to a DomainCheckpoint instead of DomainSnapshot. So I strongly recommend we should use another meaningful name, like $domcp. And "domain's configuration" should be changed "domain checkpoint's configuration"

#cat lib/Sys/Virt/DomainCheckpoint.pm

=item my $xml = $domss->get_xml_description($flags)

Returns an XML document containing a complete description of
the domain's configuration. The C<$flags> parameter accepts the following constants


=item $domss->delete($flags)

=item $parentss = $domss->get_parent();

=item $res = $domss->has_metadata()

=item my @checkpoints = $domss->list_all_children($flags)



Actual results:
See above

Expected results:


Additional info: