X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Ftabs.1;h=f6b797d777cd05c6157c27c69c5cc39bdb58be61;hp=f8b88195f5d71a22d8a7e052dfd76b365428e438;hb=21c8ffa0edf2e389f3f674f0c08009002c6f357d;hpb=412da50547b9612cc8e759c533fe256198ec2dd3;ds=sidebyside diff --git a/man/tabs.1 b/man/tabs.1 index f8b88195..f6b797d7 100644 --- a/man/tabs.1 +++ b/man/tabs.1 @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright (c) 2008 Free Software Foundation, Inc. * +.\" Copyright (c) 2008-2011,2013 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -26,19 +26,18 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: tabs.1,v 1.2 2008/11/15 23:03:45 tom Exp $ -.TH @TABS@ 1M "" +.\" $Id: tabs.1,v 1.11 2013/06/22 18:11:57 tom Exp $ +.TH @TABS@ 1 "" .ds n 5 .SH NAME -\fBtabs\fR - set tabs on a terminal +\fB@TABS@\fR \- set tabs on a terminal .SH SYNOPSIS -\fBtabs\fR [\fB-v\fR[\fIn\fR]] [\fB-ahuUV\fR] \fIfile...\fR -.br +\fB@TABS@\fR [\fIoptions\fR]] \fI[tabstop-list]\fR .SH DESCRIPTION .PP -The \fBtabs\fP program clears and sets tab-stops on the terminal. +The \fB@TABS@\fP program clears and sets tab-stops on the terminal. This uses the terminfo \fIclear_all_tabs\fP and \fIset_tab\fP capabilities. -If either is absent, \fBtabs\fP is unable to clear/set tab-stops. +If either is absent, \fB@TABS@\fP is unable to clear/set tab-stops. The terminal should be configured to use hard tabs, e.g., .sp .RS @@ -47,30 +46,37 @@ stty tab0 .SH OPTIONS .SS General Options .TP 5 -.BI -T "name" -Tell \fBtabs\fP which terminal type to use. -If this option is not given, \fBtabs\fP will use the \fB$TERM\fP +.BI \-T "name" +Tell \fB@TABS@\fP which terminal type to use. +If this option is not given, \fB@TABS@\fP will use the \fB$TERM\fP environment variable. If that is not set, it will use the \fIansi+tabs\fP entry. .TP 5 -.B -d +.B \-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. .TP 5 -.B -n -This option tells \fBtabs\fP to check the options and run any debugging +.B \-n +This option tells \fB@TABS@\fP to check the options and run any debugging option, but not to modify the terminal settings. +.TP +\fB\-V\fR +reports the version of ncurses which was used in this program, and exits. .PP -The \fBtabs\fP program processes a single list of tab stops. +The \fB@TABS@\fP program processes a single list of tab stops. The last option to be processed which defines a list is the one that determines the list to be processed. .SS Implicit Lists -Use a single number as an option, e.g., "\fB-5\fP" to set tabs at the given +Use a single number as an option, e.g., "\fB\-5\fP" 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. +.PP +Use "\fB\-0\fP" to clear all tabs. +.PP +Use "\fB\-8\fP" to set tabs to the standard interval. .SS Explicit Lists -An explicit list can be defined after the options (this does not use a "-"). +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, .sp @@ -89,38 +95,38 @@ which is equivalent to the 1,6,11,16,21 example. .SS Predefined Tab-Stops X/Open defines several predefined lists of tab stops. .TP 5 -.B -a +.B \-a Assembler, IBM S/370, first format .TP 5 -.B -a2 +.B \-a2 Assembler, IBM S/370, second format .TP 5 -.B -c +.B \-c COBOL, normal format .TP 5 -.B -c2 +.B \-c2 COBOL compact format .TP 5 -.B -c3 +.B \-c3 COBOL compact format extended .TP 5 -.B -f +.B \-f FORTRAN .TP 5 -.B -p +.B \-p PL/I .TP 5 -.B -s +.B \-s SNOBOL .TP 5 -.B -u +.B \-u UNIVAC 1100 Assembler .SH PORTABILITY .PP X/Open describes a \fB+m\fP option, to set a terminal's left-margin. -None of the entries in the terminal database provide this capability. +Very few of the entries in the terminal database provide this capability. .PP -The \fB-d\fP (debug) and \fB-n\fP (no-op) options are extensions not provided +The \fB\-d\fP (debug) and \fB\-n\fP (no-op) options are extensions not provided by other implementations. .PP Documentation for other implementations states that there is a limit on the @@ -135,9 +141,3 @@ right margin of the screen, if the given list happens to be that long. .PP This describes \fBncurses\fR version @NCURSES_MAJOR@.@NCURSES_MINOR@ (patch @NCURSES_PATCH@). -.\"# -.\"# The following sets edit modes for GNU EMACS -.\"# Local Variables: -.\"# mode:nroff -.\"# fill-column:79 -.\"# End: