X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Ftabs.1.html;h=0833c81a9f7d6126797d9428dfc3454ec79610f2;hp=5d837319e05686f813693b068a52734874bc5573;hb=a816c8dae437106bbf1661304240ff568ae3efef;hpb=81304798ee736c467839c779c9ca5dca48db7bea
diff --git a/doc/html/man/tabs.1.html b/doc/html/man/tabs.1.html
index 5d837319..0833c81a 100644
--- a/doc/html/man/tabs.1.html
+++ b/doc/html/man/tabs.1.html
@@ -1,6 +1,6 @@
@@ -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 20210626).
+ This describes ncurses version 6.3 (patch 20211021).
@@ -224,6 +269,7 @@
Implicit Lists
Explicit Lists
Predefined Tab-Stops
+Margins
PORTABILITY