[Bug 513987] New: man Sys::Virt: get_node_info onwards is confusing

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

Summary: man Sys::Virt: get_node_info onwards is confusing

https://bugzilla.redhat.com/show_bug.cgi?id=513987

Summary: man Sys::Virt: get_node_info onwards is confusing
           Product: Fedora
           Version: 11
          Platform: All
        OS/Version: Linux
            Status: NEW
          Severity: medium
          Priority: low
         Component: perl-Sys-Virt
        AssignedTo: [e-mail]
        ReportedBy: [e-mail]
         QAContact: [e-mail]
                CC: [e-mail], [e-mail],
                    [e-mail]
    Classification: Fedora
    Target Release: ---

Description of problem:
man Sys::Virt says:

my $info = $con->get_node_info()
           Returns a hash reference summarising the capabilities of the host
           node. The elements of the hash are as follows:

However, what follows does not appear to be a description of the hash. At that
same point, the convention for describing a method changes. $vmm is variously
referred to as $con or $conn. Unless, of course, these methods are genuinely
different in some way that isn't clear.

Version-Release number of selected component (if applicable):
perl-Sys-Virt-0.2.0-2.fc11.i586