提交 7deb0864 编写于 作者: B Ben S

Comment corrections

上级 ec0539d3
...@@ -113,22 +113,30 @@ impl Details { ...@@ -113,22 +113,30 @@ impl Details {
struct Row { struct Row {
/// Vector of cells to display. /// Vector of cells to display.
cells: Option<Vec<Cell>>, ///
/// Most of the rows will be files that have had their metadata
/// successfully queried and displayed in these cells, so this will almost
/// always be `Some`. It will be `None` for a row that's only displaying
/// an attribute or an error.
cells: Option<Vec<Cell>>,
// Did You Know?
// A Vec<Cell> and an Option<Vec<Cell>> actually have the same byte size!
/// This file's name, in coloured output. The name is treated separately /// This file's name, in coloured output. The name is treated separately
/// from the other cells, as it never requires padding. /// from the other cells, as it never requires padding.
name: Cell, name: Cell,
/// How many directories deep into the tree structure this is. Directories /// How many directories deep into the tree structure this is. Directories
/// on top have depth 0. /// on top have depth 0.
depth: usize, depth: usize,
/// Vector of this file's extended attributes, if that feature is active. /// Vector of this file's extended attributes, if that feature is active.
attrs: Vec<Attribute>, attrs: Vec<Attribute>,
/// Whether this is the last entry in the directory. This flag is used /// Whether this is the last entry in the directory. This flag is used
/// when calculating the tree view. /// when calculating the tree view.
last: bool, last: bool,
/// Whether this file is a directory and has any children. Also used when /// Whether this file is a directory and has any children. Also used when
/// calculating the tree view. /// calculating the tree view.
...@@ -136,6 +144,8 @@ struct Row { ...@@ -136,6 +144,8 @@ struct Row {
} }
impl Row { impl Row {
/// Gets the 'width' of the indexed column, if present. If not, returns 0.
fn column_width(&self, index: usize) -> usize { fn column_width(&self, index: usize) -> usize {
match self.cells { match self.cells {
Some(ref cells) => cells[index].length, Some(ref cells) => cells[index].length,
...@@ -398,7 +408,7 @@ impl<U> Table<U> where U: Users { ...@@ -398,7 +408,7 @@ impl<U> Table<U> where U: Users {
Cell::paint(style, &*group_name) Cell::paint(style, &*group_name)
} }
/// Print the table to standard output, consuming it in the process. /// Render the table as a vector of Cells, to be displayed on standard output.
pub fn print_table(&self, xattr: bool, show_children: bool) -> Vec<Cell> { pub fn print_table(&self, xattr: bool, show_children: bool) -> Vec<Cell> {
let mut stack = Vec::new(); let mut stack = Vec::new();
let mut cells = Vec::new(); let mut cells = Vec::new();
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册