X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Ftabs.1.html;h=94abb2390f6f99461adb4fd599b89b9921a4b9ac;hb=61b684e2d53473d0262f28db0b0020e466bb8447;hp=34dc416ead2ea03553a8f4449d94edb87f31bc88;hpb=152c5a605234b7ea36ba3a03ec07e124bb6aac75;p=ncurses.git diff --git a/doc/html/man/tabs.1.html b/doc/html/man/tabs.1.html index 34dc416e..94abb239 100644 --- a/doc/html/man/tabs.1.html +++ b/doc/html/man/tabs.1.html @@ -1,6 +1,6 @@ - @@ -36,7 +36,7 @@
The tabs program clears and sets tab-stops on the terminal. This uses - the terminfo clear_all_tabs and set_tab capabilities. If either is + the terminfo clear_all_tabs and set_tab capabilities. If either is absent, tabs is unable to clear/set tab-stops. The terminal should be configured to use hard tabs, e.g., @@ -133,25 +133,61 @@
- X/Open defines several predefined lists of tab stops. + POSIX defines several predefined lists of tab stops. -a Assembler, IBM S/370, first format + 1,10,16,36,72 -a2 Assembler, IBM S/370, second format + 1,10,16,40,72 -c COBOL, normal format + 1,8,12,16,20,55 -c2 COBOL compact format + 1,6,10,14,49 -c3 COBOL compact format extended + 1,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 -f FORTRAN + 1,7,11,15,19,23 -p PL/I + 1,5,9,13,17,21,25,29,33,37,41,45,49,53,57,61 -s SNOBOL + 1,10,55 -u UNIVAC 1100 Assembler + 1,12,20,44 + + +
+ A few terminals provide the capability for changing their left/right + margins. The tabs program has an option to use this feature: + + +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. + + 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. + + 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. + + When setting or resetting the left-margin, tabs may reset the right- + margin.
@@ -164,7 +200,7 @@ capability needed to support the feature. o There is no counterpart in X/Open Curses Issue 7 for this utility, - unlike tput(1). + unlike tput(1). The -d (debug) and -n (no-op) options are extensions not provided by other implementations. @@ -176,38 +212,47 @@ 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. + 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, as a fallback. In an earlier + 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, - POSIX documents no limits on the number of tab stops. Documentation + 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 + 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 + 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 + 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 + implemented in PWB/Unix. Those provide the capability of setting abitrary tab stops.
infocmp(1m), tset(1), curses(3x), terminfo(5). - This describes ncurses version 6.2 (patch 20210109). + This describes ncurses version 6.3 (patch 20220917). @@ -224,6 +269,7 @@