X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Ftabs.1.html;h=5f4818826477829b7f619b0314d76c7dde3f21d0;hp=d61176fc32467184fedfaf381aaf261f112e1842;hb=HEAD;hpb=0eedaa5673ff8181abe51e3a6fadca3820f90c46 diff --git a/doc/html/man/tabs.1.html b/doc/html/man/tabs.1.html index d61176fc..5a548fab 100644 --- a/doc/html/man/tabs.1.html +++ b/doc/html/man/tabs.1.html @@ -1,6 +1,6 @@ -tabs 1 2023-09-16 ncurses 6.4 User commands +tabs 1 2024-04-20 ncurses 6.5 User commands -

tabs 1 2023-09-16 ncurses 6.4 User commands

+

tabs 1 2024-04-20 ncurses 6.5 User commands

 tabs(1)                          User commands                         tabs(1)
 
@@ -51,7 +51,7 @@
 
 
 

SYNOPSIS

-       tabs [options]] [tabstop-list]
+       tabs [options] [tabstop-list]
 
 
 

DESCRIPTION

@@ -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.
 
 
-

Predefined Tab-Stops

+

Predefined Tab Stops

        POSIX defines several predefined lists of tab stops.
 
        -a   Assembler, IBM S/370, first format
@@ -164,99 +164,101 @@
 
 
 

Margins

-       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.
+
+
+

FILES

+       /usr/share/tabset
+              tab stop initialization database
 
 
 

PORTABILITY

-       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.
 
 
-

SEE ALSO

-       infocmp(1m), tset(1), curses(3x), terminfo(5).
+

HISTORY

+       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 20230923).
+       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.
+
+
+

SEE ALSO

+       infocmp(1m), tset(1), curses(3x), terminfo(5)
 
 
 
-ncurses 6.4                       2023-09-16                           tabs(1)
+ncurses 6.5                       2024-04-20                           tabs(1)