X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Ftabs.1.html;h=6bb29cd8629d1736d5051a9a076e9c4ff1ed65ff;hp=54ae4fc1bd8efb53942744f84208d783842bbd96;hb=f9994a48d2f74b613a0adb19d3917f724d4d1312;hpb=bca50d0d8592defee6c584fdedd25f4b1a31345b diff --git a/doc/html/man/tabs.1.html b/doc/html/man/tabs.1.html index 54ae4fc1..6bb29cd8 100644 --- a/doc/html/man/tabs.1.html +++ b/doc/html/man/tabs.1.html @@ -1,6 +1,7 @@ - @@ -34,7 +35,7 @@
-Tname - Tell tabs which terminal type to use. If this option is not - given, tabs will use the $TERM environment variable. If that is + Tell tabs which terminal type to use. If this option is not + given, tabs will use the $TERM environment variable. If that is not set, it will use the ansi+tabs entry. - -d The debugging option shows a ruler line, followed by two data - lines. The first data line shows the expected tab-stops marked - with asterisks. The second data line shows the actual tab-stops, + -d The debugging option shows a ruler line, followed by two data + lines. The first data line shows the expected tab-stops marked + with asterisks. The second data line shows the actual tab-stops, marked with asterisks. - -n This option tells tabs to check the options and run any debugging + -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 exits. The tabs program processes a single list of tab stops. The last option - to be processed which defines a list is the one that determines the + to be processed which defines a list is the one that determines the list to be processed.
- Use a single number as an option, e.g., "-5" to set tabs at the given - interval (in this case 1, 6, 11, 16, 21, etc.). Tabs are repeated up + Use a single number as an option, e.g., "-5" to set tabs at the given + interval (in this case 1, 6, 11, 16, 21, etc.). Tabs are repeated up to the right margin of the screen. Use "-0" to clear all tabs. @@ -102,15 +116,15 @@
- An explicit list can be defined after the options (this does not use a - "-"). The values in the list must be in increasing numeric order, and - greater than zero. They are separated by a comma or a blank, for exam- - ple, + An explicit list can be defined after the options (this does not use a + "-"). The values in the list must be in increasing numeric order, and + greater than zero. They are separated by a comma or a blank, for + example, tabs 1,6,11,16,21 tabs 1 6 11 16 21 - Use a "+" to treat a number as an increment relative to the previous + Use a "+" to treat a number as an increment relative to the previous value, e.g., tabs 1,+5,+5,+5,+5 @@ -141,12 +155,13 @@
- IEEE Std 1003.1/The Open Group Base Specifications Issue 7 + 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-mar- - gin. Very few of the entries in the terminal database provide this - capability. + 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 There is no counterpart in X/Open Curses Issue 7 for this utility, unlike tput(1). @@ -154,17 +169,45 @@ The -d (debug) and -n (no-op) options are extensions not provided by other implementations. - Documentation for other implementations states that there is a limit on - the number of tab stops. While some terminals may not accept an arbi- - trary 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. + 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 terminal 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, as a fallback. In an earlier + development effort, the tab-stop initialization provided by tset (1982) + and incorporated into tput uses the terminal database, + + 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.
- tset(1), infocmp(1m), curses(3x), terminfo(5). + infocmp(1m), tset(1), curses(3x), terminfo(5). - This describes ncurses version 6.0 (patch 20180106). + This describes ncurses version 6.2 (patch 20211002).