X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Ftabs.1.html;h=f49d6d1cdb4f5a79f060dec4c1372f2e97ac14c4;hp=cf8d9ab5bb6fc36ef76d15483a7af05523ef1821;hb=HEAD;hpb=2035f48ed0fc56ec4e5caf9b7c10e00ba43e160f diff --git a/doc/html/man/tabs.1.html b/doc/html/man/tabs.1.html index cf8d9ab5..5a548fab 100644 --- a/doc/html/man/tabs.1.html +++ b/doc/html/man/tabs.1.html @@ -1,6 +1,6 @@
-tabs(1) User commands tabs(1) @@ -47,11 +47,11 @@
- tabs - set tabs on a terminal + tabs - set terminal tab stops
- tabs [options]] [tabstop-list] + tabs [options] [tabstop-list]
@@ -97,7 +97,7 @@ -n This option tells tabs to check the options and run any debugging option, but not to modify the terminal settings. - -V reports the version of ncurses which was used in this program, and + -V reports the version of ncurses which was used in this program, and exits. The tabs program processes a single list of tab stops. The last option @@ -132,7 +132,7 @@ which is equivalent to the 1,6,11,16,21 example. -
+
POSIX defines several predefined lists of tab stops. -a Assembler, IBM S/370, first format @@ -164,99 +164,101 @@
- A few terminals provide the capability for changing their left/right - margins. The tabs program has an option to use this feature: + A few terminals expose a means of changing their left and right + margins. tabs supports this feature with an option. +m margin The effect depends on whether the terminal has the margin capabilities: o If the terminal provides the capability for setting the left - margin, tabs uses this, and adjusts the available width for - tab-stops. + margin, tabs uses this, and adjusts the available tab stop + widths. - o If the terminal does not provide the margin capabilities, tabs - imitates the effect, putting the tab stops at the appropriate - place on each line. The terminal's left-margin is not - modified. + o If the terminal does not provide the margin capabilities, tabs + imitates their effect, putting tab stops at appropriate places + on each line. The terminal's left margin is not modified. If the margin parameter is omitted, the default is 10. Use +m0 to - reset the left margin, i.e., to the left edge of the terminal's - display. Before setting a left-margin, tabs resets the margin to - reduce problems which might arise on moving the cursor before the - current left-margin. + reset the left margin, that is, to make it the left edge of the + terminal's display. Before setting a left margin, tabs resets the + margin to reduce problems that might arise from moving the cursor + to the left of the current left margin. - When setting or resetting the left-margin, tabs may reset the right- - margin. + When setting or resetting the left margin, tabs may also reset the + right margin. + + +
+ /usr/share/tabset + tab stop initialization database
- IEEE Std 1003.1/The Open Group Base Specifications Issue 7 - (POSIX.1-2008) describes a tabs utility. However + IEEE Std 1003.1/The Open Group Base Specifications Issue 7 + (POSIX.1-2008) describes a tabs utility. However, - o This standard describes a +m option, to set a terminal's left- - margin. Very few of the entries in the terminal database provide - the smgl (set_left_margin) or smglp (set_left_margin_parm) - capability needed to support the feature. + o this standard describes a +m option to set a terminal's left + margin. Very few of the entries in the terminal database provide + the set_left_margin (smgl) or set_left_margin_parm (smglp) + capabilities needed to support the feature. - o There is no counterpart in X/Open Curses Issue 7 for this utility, + o There is no counterpart in X/Open Curses Issue 7 for this utility, unlike tput(1). - The -d (debug) and -n (no-op) options are extensions not provided by - other implementations. - - A tabs utility appeared in PWB/Unix 1.0 (1977). There was a reduced - version of the tabs utility in Unix 7th edition and in 3BSD (1979). - The latter supported a single "-n" option (to cause the first tab stop - to be set on the left margin). That option is not documented by POSIX. - - The PWB/Unix tabs utility, which was included in System III (1980), - used built-in tables rather than the terminal database, to support a - half-dozen hardcopy terminal (printer) types. It also had built-in - logic to support the left-margin, as well as a feature for copying the - tab settings from a file. - - Later versions of Unix, e.g., SVr4, added support for the terminal - database, but kept the tables to support the printers. In an earlier - development effort, the tab-stop initialization provided by tset (1982) - and incorporated into tput uses the terminal database, - - The +m option was documented in the Base Specifications Issue 5 - (Unix98, 1997), and omitted in Issue 6 (Unix03, 2004) without - documenting the rationale, though an introductory comment "and - optionally adjusts the margin" remains, overlooked in the removal. The - documented tabs utility in Issues 6 and later has no mechanism for - setting margins. The +m option in this implementation differs from the - feature in SVr4 by using terminal capabilities rather than built-in - tables. - - POSIX documents no limits on the number of tab stops. Documentation - for other implementations states that there is a limit on the number of - tab stops (e.g., 20 in PWB/Unix's tabs utility). While some terminals - may not accept an arbitrary number of tab stops, this implementation - will attempt to set tab stops up to the right margin of the screen, if - the given list happens to be that long. - - The Rationale section of the POSIX documentation goes into some detail - about the ways the committee considered redesigning the tabs and tput - utilities, without proposing an improved solution. It comments that - - no known historical version of tabs supports the capability of - setting arbitrary tab stops. - - However, the Explicit Lists described in this manual page were - implemented in PWB/Unix. Those provide the capability of setting - abitrary tab stops. + The -d (debug) and -n (no-op) options are ncurses extensions not + provided by other implementations. -
- infocmp(1m), tset(1), curses(3x), terminfo(5). +
+ A tabs utility appeared in PWB/Unix 1.0 (1977). A reduced version + shipped in Seventh Edition Unix (early 1979) and in 3BSD (later the + same year); it supported a "-n" option to set the first tab stop at the + left margin. That option is not specified by POSIX. + + The PWB/Unix tabs utility returned in System III (1980), and used + built-in tables to support a half-dozen hardcopy terminal (printer) + types. It also had logic to support setting the left margin, as well + as a feature for copying the tab settings from a file. + + Versions of the program in later releases of AT&T Unix, such as SVr4, + added support for the terminal database, but retained the tables to + support the printers. By this time, System V tput had incorporated the + tab stop initialization feature of BSD's tset from 1982, but employed + the terminfo database to do so. + + The +m option was documented in the POSIX Base Specifications Issue 5 + (Unix98, 1997), then omitted in Issue 6 (Unix03, 2004) without express + motivation, though an introductory comment "and optionally adjusts the + margin" remains, overlooked in the removal. The tabs utility + documented in Issues 6 and later has no mechanism for setting margins. + The +m option in ncurses tabs differs from the SVr4 feature by using + terminal capabilities rather than built-in tables. - This describes ncurses version 6.4 (patch 20230909). + POSIX documents no limit on the number of tab stops. Other + implementations impose one; the limit is 20 in PWB/Unix's tabs utility. + While some terminals may not accept an arbitrary number of tab stops, + ncurses tabs attempts to set tab stops up to the right margin if the + list thereof is sufficiently long. + + The "Rationale" section of the Issue 6 tabs reference page details how + the committee considered redesigning the tabs and tput utilities, + without settling on an improved solution. It claims that + + "no known historical version of tabs supports the capability of + setting arbitrary tab stops." + + The feature described in subsection "Explicit Lists" above was + implemented in PWB/Unix, and permitted the setting of abitrary tab + stops nevertheless. + + +
+ infocmp(1m), tset(1), curses(3x), terminfo(5) -ncurses 6.4 2023-09-09 tabs(1) +ncurses 6.5 2024-04-20 tabs(1)