From: Thomas Lamprecht <t.lamprecht@proxmox.com>
Date: Mon, 18 Jun 2018 09:55:40 +0000 (+0200)
Subject: reword print_text_table and print_api_list documentation
X-Git-Url: https://git.proxmox.com/?p=pve-common.git;a=commitdiff_plain;h=acd6f38373a6d337cc2c8453861b8f15ac57a534

reword print_text_table and print_api_list documentation

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
---

diff --git a/src/PVE/CLIHandler.pm b/src/PVE/CLIHandler.pm
index dc4ad35..1b95d9a 100644
--- a/src/PVE/CLIHandler.pm
+++ b/src/PVE/CLIHandler.pm
@@ -401,11 +401,12 @@ my $print_bash_completion = sub {
 
 # prints a formatted table with a title row.
 # $formatopts is an array of hashes, with the following keys:
-# 'key' - the key in the data-objects to use for this column
-# 'title' - the title to print above the column, defaults to 'key' - always gets printed in full
-# 'cutoff' - the maximal length of the data, overlong values will be truncated
-# 'default' - an optional default value for the column
-# the last column always gets printed in full
+# 'key' - key of $data element to print
+# 'title' - column title, defaults to 'key' - won't get cutoff
+# 'cutoff' - maximal (print) length of this column values, if set
+#            the last column will never be cutoff
+# 'default' - optional default value for the column
+# formatopts element order defines column order (left to right)
 sub print_text_table {
     my ($formatopts, $data) = @_;
     my ($formatstring, @keys, @titles, %cutoffs, %defaults, $last_col);
@@ -458,7 +459,7 @@ sub print_entry {
     }
 }
 
-# used to print the result of an API-listing - expects the API to return an array
+# prints the result of an API GET call returning an array
 # and to have the results key of the API call defined.
 sub print_api_list {
     my ($props_to_print, $data, $returninfo) = @_;