[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: steve(a)silug.org
        ReportedBy: mbooth(a)redhat.com
         QAContact: extras-qa(a)fedoraproject.org
                CC: steve(a)silug.org, berrange(a)redhat.com,
                    fedora-perl-devel-list(a)redhat.com
    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

-- 
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.