Deprecate `SegmentSize` on `Table` about ratatui HOT 3 CLOSED

Generally we go through a multi-stage process of deprecating functionality and then removing it at a later release (1-2 major versions). This allows users to do incremental upgrades and get notifications during build of items that are deprecated in each version. We also note these in the BREAKING CHANGES doc and in good comments on the commit that gets converted to a CHANGELOG entry.

The goal on this issue is to do the first part - make sure that things are documented in a way that any users that are using this functionality will be warned that it's going to change. Anything not in the public API can change faster than this (like private fields)

from ratatui.

This also means

/// Controls how to distribute extra space among the columns
segment_size: SegmentSize,

fn default() -> Self {
        Self {
            ...
            segment_size: SegmentSize::None,
        }
    }

will also be changed to (including all other usages of segment_size and SegmentSize)

/// Controls how to distribute extra space among the columns
flex: Flex,

fn default() -> Self {
        Self {
            ...
            flex: Flex::Start,
        }
    }

right? Or I understand wrongly.

from ratatui.

Yeah makes sense. Thanks for explaining! 🚀

from ratatui.