From: Mario Blättermann Date: Sun, 21 Mar 2021 11:50:16 +0000 (+0100) Subject: Asciidoc: Remove already imported text-utils *roff man pages X-Git-Tag: v2.37-rc1~34^2~35 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=78fec3e5bab7237c2c6afcaf120f6926efeb95e4;p=thirdparty%2Futil-linux.git Asciidoc: Remove already imported text-utils *roff man pages --- diff --git a/text-utils/col.1 b/text-utils/col.1 deleted file mode 100644 index cdd5c02d18..0000000000 --- a/text-utils/col.1 +++ /dev/null @@ -1,158 +0,0 @@ -.\" Copyright (c) 1990 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Michael Rendell. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)col.1 6.8 (Berkeley) 6/17/91 -.\" -.TH COL "1" "July 2014" "util-linux" "User Commands" -.SH NAME -col \- filter reverse line feeds from input -.SH SYNOPSIS -.B col -[options] -.SH DESCRIPTION -.B col -filters out reverse (and half-reverse) line feeds so the output is in the -correct order, with only forward and half-forward line feeds. It also replaces -any whitespace characters with tabs where possible. This can be useful in -processing the output of -.BR nroff (1) -and -.BR tbl (1). -.PP -.B col -reads from standard input and writes to standard output. -.SH OPTIONS -.TP -\fB\-b\fR, \fB\-\-no\-backspaces\fR -Do not output any backspaces, printing only the last character written to -each column position. -.TP -\fB\-f\fR, \fB\-\-fine\fR -Permit half-forward line feeds. -Normally characters destined for a half-line boundary are printed on the -following line. -.TP -\fB\-h\fR, \fB\-\-tabs\fR -Output tabs instead of multiple spaces. -.TP -\fB\-l\fR, \fB\-\-lines\fR \fInumber\fR -Buffer at least -.I number -lines in memory. By default, 128 lines are buffered. -.TP -\fB\-p\fR, \fB\-\-pass\fR -Force unknown control sequences to be passed through unchanged. Normally -.B col -will filter out any control sequences other than those -recognized and interpreted by itself, which are listed below. -.TP -\fB\-x\fR, \fB\-\-spaces\fR -Output multiple spaces instead of tabs. -.TP -\fB\-V\fR, \fB\-\-version\fR -Display version information and exit. -.TP -\fB\-H\fR, \fB\-\-help\fR -Display help text and exit. -.SH CONFORMING TO -The -.B col -utility conforms to the Single UNIX Specification, Version 2. The -.B \-l -option is an extension to the standard. -.SH NOTES -The control sequences for carriage motion that -.B col -understands and their decimal values are listed in the following table: -.PP -.RS -.PD 0 -.TP 18 -.B ESC\-7 -reverse line feed (escape then 7) -.TP -.B ESC\-8 -half reverse line feed (escape then 8) -.TP -.B ESC\-9 -half forward line feed (escape then 9) -.TP -.B backspace -moves back one column (8); ignored in the first column -.TP -.B newline -forward line feed (10); also does carriage return -.TP -.B carriage return -(13) -.TP -.B shift in -shift to normal character set (15) -.TP -.B shift out -shift to alternate character set (14) -.TP -.B space -moves forward one column (32) -.TP -.B tab -moves forward to next tab stop (9) -.TP -.B vertical tab -reverse line feed (11) -.PD -.RE -.PP -All unrecognized control characters and escape sequences are discarded. -.PP -.B col -keeps track of the character set as characters are read and makes sure the -character set is correct when they are output. -.PP -If the input attempts to back up to the last flushed line, -.B col -will display a warning message. -.SH HISTORY -A -.B col -command appeared in Version 6 AT&T UNIX. -.SH SEE ALSO -.BR expand (1), -.BR nroff (1), -.BR tbl (1) -.SH AVAILABILITY -The col command is part of the util-linux package and is available from -.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ -Linux Kernel Archive -.UE . diff --git a/text-utils/colcrt.1 b/text-utils/colcrt.1 deleted file mode 100644 index 46c612bb7f..0000000000 --- a/text-utils/colcrt.1 +++ /dev/null @@ -1,105 +0,0 @@ -.\" Copyright (c) 1980, 1990, 1993 -.\" The Regents of the University of California. All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)colcrt.1 8.1 (Berkeley) 6/30/93 -.\" -.TH COLCRT "1" "September 2011" "util-linux" "User Commands" -.SH NAME -colcrt \- filter nroff output for CRT previewing -.SH SYNOPSIS -.B colcrt -[options] -.RI [ file ...] -.SH DESCRIPTION -.B colcrt -provides virtual half-line and reverse line feed sequences for terminals -without such capability, and on which overstriking is destructive. -Half-line characters and underlining (changed to dashing `\-') are placed on -new lines in between the normal output lines. -.SH OPTIONS -.TP -\fB\-\fR, \fB\-\-no\-underlining\fR -Suppress all underlining. This option is especially useful for previewing -.I allboxed -tables from -.BR tbl (1). -.TP -\fB\-2\fR, \fB\-\-half\-lines\fR -Causes all half-lines to be printed, effectively double spacing the output. -Normally, a minimal space output format is used which will suppress empty -lines. The program never suppresses two consecutive empty lines, however. -The -.B \-2 -option is useful for sending output to the line printer when the output -contains superscripts and subscripts which would otherwise be invisible. -.TP -\fB\-V\fR, \fB\-\-version\fR -Display version information and exit. -.TP -\fB\-h\fR, \fB\-\-help\fR -Display help text and exit. -.SH HISTORY -The -.B colcrt -command appeared in 3.0BSD. -.SH BUGS -Should fold underlines onto blanks even with the -.B '\-' -option so that a true underline character would show. -.PP -Can't back up more than 102 lines. -.PP -General overstriking is lost; as a special case '|' overstruck with '\-' or -underline becomes '+'. -.PP -Lines are trimmed to 132 characters. -.PP -Some provision should be made for processing superscripts and subscripts in -documents which are already double-spaced. -.SH EXAMPLES -A typical use of -.B colcrt -would be: -.PP -.RS -.B tbl exum2.n \&| nroff \-ms \&| colcrt \- \&| more -.RE -.SH SEE ALSO -.BR col (1), -.BR more (1), -.BR nroff (1), -.BR troff (1), -.BR ul (1) -.SH AVAILABILITY -The colcrt command is part of the util-linux package and is available from -.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ -Linux Kernel Archive -.UE . diff --git a/text-utils/colrm.1 b/text-utils/colrm.1 deleted file mode 100644 index 979137f716..0000000000 --- a/text-utils/colrm.1 +++ /dev/null @@ -1,75 +0,0 @@ -.\" Copyright (c) 1980, 1990 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)colrm.1 6.6 (Berkeley) 3/14/91 -.\" -.TH COLRM "1" "September 2011" "util-linux" "User Commands" -.SH NAME -colrm \- remove columns from a file -.SH SYNOPSIS -.B colrm -.RI [ first \ [ last ]] -.SH DESCRIPTION -.B colrm -removes selected columns from a file. Input is taken from standard input. -Output is sent to standard output. -.PP -If called with one parameter the columns of each line will be removed -starting with the specified -.I first -column. If called with two parameters the columns from the -.I first -column to the -.I last -column will be removed. -.PP -Column numbering starts with column 1. -.SH OPTIONS -.TP -\fB\-V\fR, \fB\-\-version\fR -Display version information and exit. -.TP -\fB\-h\fR, \fB\-\-help\fR -Display help text and exit. -.SH HISTORY -The -.B colrm -command appeared in 3.0BSD. -.SH SEE ALSO -.BR awk (1p), -.BR column (1), -.BR expand (1), -.BR paste (1) -.SH AVAILABILITY -The colrm command is part of the util-linux package and is available from -.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ -Linux Kernel Archive -.UE . diff --git a/text-utils/column.1 b/text-utils/column.1 deleted file mode 100644 index d10fc7efbb..0000000000 --- a/text-utils/column.1 +++ /dev/null @@ -1,192 +0,0 @@ -.\" Copyright (c) 1989, 1990, 1993 -.\" The Regents of the University of California. All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)column.1 8.1 (Berkeley) 6/6/93 -.\" -.TH COLUMN 1 "February 2019" "util-linux" "User Commands" -.SH NAME -column \- columnate lists -.SH SYNOPSIS -.BR column " [options]" -.RI [ file ...] -.SH DESCRIPTION -The -.B column -utility formats its input into multiple columns. The util support three modes: -.TP -.B columns are filled before rows -This is the default mode (required by backward compatibility). -.TP -.B rows are filled before columns -This mode is enabled by option \fB\-x, \-\-fillrows\fP -.TP -.B table -Determine the number of columns the input contains and create a table. This -mode is enabled by option \fB\-t, \-\-table\fP and columns formatting is -possible to modify by \fB\-\-table-*\fP options. Use this mode if not sure. -.PP -Input is taken from \fIfile\fR, or otherwise from standard input. Empty lines -are ignored and all invalid multibyte sequences are encoded by \\x convention. -.SH OPTIONS -The argument \fIcolumns\fP for \fB\-\-table-*\fP options is comma separated -list of the column names as defined by \fB\-\-table-columns\fP or it's column -number in order as specified by input. It's possible to mix names and numbers. -.IP "\fB\-J, \-\-json\fP" -Use JSON output format to print the table, the option -\fB\-\-table\-columns\fP is required and the option \fB\-\-table\-name\fP is recommended. -.IP "\fB\-c, \-\-output\-width\fP \fIwidth\fP" -Output is formatted to a width specified as number of characters. The original -name of this option is \-\-columns; this name is deprecated since v2.30. Note that input -longer than \fIwidth\fP is not truncated by default. -.IP "\fB\-d, \-\-table\-noheadings\fP" -Do not print header. -This option allows the use of logical column names on the command line, -but keeps the header hidden when printing the table. -.IP "\fB\-o, \-\-output\-separator\fP \fIstring\fP" -Specify the columns delimiter for table output (default is two spaces). -.IP "\fB\-s, \-\-separator\fP \fIseparators\fP" -Specify the possible input item delimiters (default is whitespace). -.IP "\fB\-t, \-\-table\fP" -Determine the number of columns the input contains and create a table. -Columns are delimited with whitespace, by default, or with the characters -supplied using the \fB\-\-output\-separator\fP option. -Table output is useful for pretty-printing. -.IP "\fB\-N, \-\-table-columns\fP \fInames\fP" -Specify the columns names by comma separated list of names. The names are used -for the table header or to address column in option arguments. -.IP "\fB\-l, \-\-table-columns-limit\fP \fInumber\fP" -Specify maximal number of the input columns. -The last column will contain all remaining line data if the limit is smaller -than the number of the columns in the input data. -.IP "\fB\-R, \-\-table-right\fP \fIcolumns\fP" -Right align text in the specified columns. -.IP "\fB\-T, \-\-table-truncate\fP \fIcolumns\fP" -Specify columns where text can be truncated when necessary, otherwise -very long table entries may be printed on multiple lines. -.IP "\fB\-E, \-\-table-noextreme\fP \fIcolumns\fP" -Specify columns where is possible to ignore unusually long (longer than -average) cells when calculate column width. The option has impact to the width -calculation and table formatting, but the printed text is not affected. - -The option is used for the last visible column by default. - -.IP "\fB\-e, \-\-table\-header\-repeat\fP" -Print header line for each page. -.IP "\fB\-W, \-\-table-wrap\fP \fIcolumns\fP" -Specify columns where is possible to use multi-line cell for long text when -necessary. -.IP "\fB\-H, \-\-table-hide\fP \fIcolumns\fP" -Don't print specified columns. The special placeholder '\-' may be used to -hide all unnamed columns (see \-\-table-columns). -.IP "\fB\-O, \-\-table-order\fP \fIcolumns\fP" -Specify columns order on output. -.IP "\fB\-n, \-\-table-name\fP \fIname\fP" -Specify the table name used for JSON output. The default is "table". -.IP "\fB\-L, \-\-keep\-empty\-lines\fP" -Preserve whitespace-only lines in the input. The default is ignore empty lines -at all. This option’s original name was \-\-table-empty-lines but is now -deprecated because it gives the false impression that the option only applies -to table mode. -.IP "\fB\-r, \-\-tree\fP \fIcolumn\fP" -Specify column to use tree-like output. Note that the circular dependencies and -other anomalies in child and parent relation are silently ignored. -.IP "\fB\-i, \-\-tree\-id\fP \fIcolumn\fP" -Specify column with line ID to create child-parent relation. -.IP "\fB\-p, \-\-tree\-parent\fP \fIcolumn\fP" -Specify column with parent ID to create child-parent relation. -.IP "\fB\-x, \-\-fillrows\fP" -Fill rows before filling columns. -.IP "\fB\-V\fR, \fB\-\-version\fR" -Display version information and exit. -.IP "\fB\-h, \-\-help\fP" -Display help text and exit. -.SH ENVIRONMENT -The environment variable \fBCOLUMNS\fR is used to determine the size of -the screen if no other information is available. -.SH HISTORY -The column command appeared in 4.3BSD-Reno. -.SH BUGS -Version 2.23 changed the -.B \-s -option to be non-greedy, for example: -.PP -.EX -\fBprintf "a:b:c\\n1::3\\n" | column \-t \-s ':'\fR -.EE -.PP -Old output: -.EX -a b c -1 3 -.EE -.PP -New output (since util-linux 2.23): -.EX -a b c -1 3 -.EE -.PP -Historical versions of this tool indicated that "rows are filled before -columns" by default, and that the -.B \-x -option reverses this. This wording did not reflect the actual behavior, and it -has since been corrected (see above). Other implementations of -.B column -may continue to use the older documentation, but the behavior should be -identical in any case. -.SH EXAMPLES -Print fstab with header line and align number to the right: -.EX -\fBsed 's/#.*//' /etc/fstab | column \-\-table \-\-table-columns SOURCE,TARGET,TYPE,OPTIONS,PASS,FREQ \-\-table-right PASS,FREQ\fR -.EE -.PP -Print fstab and hide unnamed columns: -.EX -\fBsed 's/#.*//' /etc/fstab | column \-\-table \-\-table-columns SOURCE,TARGET,TYPE \-\-table-hide \-\fR -.EE -.PP -Print a tree: -.EX -\fBecho \-e '1 0 A\\n2 1 AA\\n3 1 AB\\n4 2 AAA\\n5 2 AAB' | column \-\-tree-id 1 \-\-tree-parent 2 \-\-tree 3\fR -1 0 A -2 1 |-AA -4 2 | |-AAA -5 2 | `-AAB -3 1 `-AB -.EE -.SH SEE ALSO -.BR colrm (1), -.BR ls (1), -.BR paste (1), -.BR sort (1) -.SH AVAILABILITY -The column command is part of the util-linux package and is available from -https://www.kernel.org/pub/linux/utils/util-linux/. diff --git a/text-utils/hexdump.1 b/text-utils/hexdump.1 deleted file mode 100644 index 99b9d06361..0000000000 --- a/text-utils/hexdump.1 +++ /dev/null @@ -1,382 +0,0 @@ -.\" Copyright (c) 1989, 1990, 1993 -.\" The Regents of the University of California. All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)hexdump.1 8.2 (Berkeley) 4/18/94 -.\" -.TH HEXDUMP "1" "April 2013" "util-linux" "User Commands" -.SH NAME -hexdump \- display file contents in hexadecimal, decimal, octal, or ascii -.SH SYNOPSIS -.B hexdump -.RI [options] " file" ... -.SH DESCRIPTION -The -.B hexdump -utility is a filter which displays the specified files, or -standard input if no files are specified, in a user-specified -format. -.SH OPTIONS -Below, the \fIlength\fR and \fIoffset\fR arguments may be followed by the multiplicative -suffixes KiB (=1024), MiB (=1024*1024), and so on for GiB, TiB, PiB, EiB, ZiB and YiB -(the "iB" is optional, e.g., "K" has the same meaning as "KiB"), or the suffixes -KB (=1000), MB (=1000*1000), and so on for GB, TB, PB, EB, ZB and YB. -.TP -\fB\-b\fR, \fB\-\-one\-byte\-octal\fR -\fIOne-byte octal display\fR. Display the input offset in hexadecimal, -followed by sixteen space-separated, three-column, zero-filled bytes of input -data, in octal, per line. -.TP -\fB\-c\fR, \fB\-\-one\-byte\-char\fR -\fIOne-byte character display\fR. Display the input offset in hexadecimal, -followed by sixteen space-separated, three-column, space-filled characters of -input data per line. -.TP -\fB\-C\fR, \fB\-\-canonical\fR -\fICanonical hex+ASCII display\fR. Display the input offset in hexadecimal, -followed by sixteen space-separated, two-column, hexadecimal bytes, followed -by the same sixteen bytes in -.B %_p -format enclosed in -.RB ' | ' -characters. -Invoking the program as -.B hd -implies this option. -.TP -\fB\-d\fR, \fB\-\-two\-bytes\-decimal\fR -\fITwo-byte decimal display\fR. Display the input offset in hexadecimal, -followed by eight space-separated, five-column, zero-filled, two-byte units -of input data, in unsigned decimal, per line. -.TP -\fB\-e\fR, \fB\-\-format\fR \fIformat_string\fR -Specify a format string to be used for displaying data. -.TP -\fB\-f\fR, \fB\-\-format\-file\fR \fIfile\fR -Specify a file that contains one or more newline-separated format strings. -Empty lines and lines whose first non-blank character is a hash mark (\&#) -are ignored. -.TP -\fB\-L\fR, \fB\-\-color\fR[=\fIwhen\fR] -Accept color units for the output. The optional argument \fIwhen\fP -can be \fBauto\fR, \fBnever\fR or \fBalways\fR. If the \fIwhen\fR argument is omitted, -it defaults to \fBauto\fR. The colors can be disabled; for the current built-in default -see the \fB\-\-help\fR output. See also the \fBColors\fR subsection and -the \fBCOLORS\fR section below. -.TP -\fB\-n\fR, \fB\-\-length\fR \fIlength\fR -Interpret only -.I length -bytes of input. -.TP -\fB\-o\fR, \fB\-\-two\-bytes\-octal\fR -\fITwo-byte octal display\fR. Display the input offset in hexadecimal, -followed by eight space-separated, six-column, zero-filled, two-byte -quantities of input data, in octal, per line. -.TP -\fB\-s\fR, \fB\-\-skip\fR \fIoffset\fR -Skip -.I offset -bytes from the beginning of the input. -.TP -\fB\-v\fR, \fB\-\-no\-squeezing\fR -The -.B \-v -option causes -.B hexdump -to display all input data. Without the -.B \-v -option, any number of groups of output lines which would be identical to the -immediately preceding group of output lines (except for the input offsets), -are replaced with a line comprised of a single asterisk. -.TP -\fB\-x\fR, \fB\-\-two\-bytes\-hex\fR -\fITwo-byte hexadecimal display\fR. Display the input offset in hexadecimal, -followed by eight space-separated, four-column, zero-filled, two-byte -quantities of input data, in hexadecimal, per line. -.TP -.BR \-V , " \-\-version" -Display version information and exit. -.TP -.BR \-h , " \-\-help" -Display help text and exit. -.PP -For each input file, -.B hexdump -sequentially copies the input to standard output, transforming the data -according to the format strings specified by the -.B \-e -and -.B \-f -options, in the order that they were specified. -.SH FORMATS -A format string contains any number of format units, separated by whitespace. -A format unit contains up to three items: an iteration count, a byte count, -and a format. -.PP -The iteration count is an optional positive integer, which defaults to one. -Each format is applied iteration count times. -.PP -The byte count is an optional positive integer. If specified it defines the -number of bytes to be interpreted by each iteration of the format. -.PP -If an iteration count and/or a byte count is specified, a single slash must -be placed after the iteration count and/or before the byte count to -disambiguate them. Any whitespace before or after the slash is ignored. -.PP -The format is required and must be surrounded by double quote (" ") marks. -It is interpreted as a fprintf-style format string (see -.BR fprintf (3), -with the following exceptions: -.TP -1. -An asterisk (*) may not be used as a field width or precision. -.TP -2. -A byte count or field precision -.I is -required for each -.B s -conversion character (unlike the -.BR fprintf (3) -default which prints the entire string if the precision is unspecified). -.TP -3. -The conversion characters -.BR h , \ l , \ n , \ p , -.RB and \ q -are not supported. -.TP -4. -The single character escape sequences described in the C standard are -supported: -.PP -.RS 13 -.PD 0 -.TP 21 -NULL -\e0 -.TP - -\ea -.TP - -\eb -.TP - -\ef -.TP - -\en -.TP - -\er -.TP - -\et -.TP - -\ev -.PD -.RE -.SS Conversion strings -The -.B hexdump -utility also supports the following additional conversion strings. -.TP -.B \&_a[dox] -Display the input offset, cumulative across input files, of the next byte to -be displayed. The appended characters -.BR d , -.BR o , -and -.B x -specify the display base as decimal, octal or hexadecimal respectively. -.TP -.B \&_A[dox] -Identical to the -.B \&_a -conversion string except that it is only performed once, when all of the -input data has been processed. -.TP -.B \&_c -Output characters in the default character set. Non-printing characters are -displayed in three-character, zero-padded octal, except for those -representable by standard escape notation (see above), which are displayed as -two-character strings. -.TP -.B \&_p -Output characters in the default character set. Non-printing characters are -displayed as a single -.RB ' \&. '. -.TP -.B \&_u -Output US ASCII characters, with the exception that control characters are -displayed using the following, lower-case, names. Characters greater than -0xff, hexadecimal, are displayed as hexadecimal strings. -.RS 10 -.TS -tab(|); -l l l l l l. -000 nul|001 soh|002 stx|003 etx|004 eot|005 enq -006 ack|007 bel|008 bs|009 ht|00A lf|00B vt -00C ff|00D cr|00E so|00F si|010 dle|011 dc1 -012 dc2|013 dc3|014 dc4|015 nak|016 syn|017 etb -018 can|019 em|01A sub|01B esc|01C fs|01D gs -01E rs|01F us|0FF del -.TE -.RE -.SS Colors -When put at the end of a format specifier, hexdump highlights the -respective string with the color specified. Conditions, if present, are -evaluated prior to highlighting. -.PP -.B \&_L[color_unit_1,\:color_unit_2,\:...,\:color_unit_n] -.PP -The full syntax of a color unit is as follows: -.PP -.B [!]COLOR\:[:VALUE]\:[@OFFSET_START[-END]] -.TP -.B ! -Negate the condition. Please note that it only makes sense to negate a -unit if both a value/\:string and an offset are specified. In that case -the respective output string will be highlighted if and only if the -value/\:string does not match the one at the offset. -.TP -.B COLOR -One of the 8 basic shell colors. -.TP -.B VALUE -A value to be matched specified in hexadecimal, or octal base, or as a -string. Please note that the usual C escape sequences are not -interpreted by hexdump inside the color_units. -.TP -.B OFFSET -An offset or an offset range at which to check for a match. Please note -that lone OFFSET_START uses the same value as END offset. -.SS Counters -The default and supported byte counts for the conversion characters -are as follows: -.TP -.BR \&%_c , \ \&%_p , \ \&%_u , \ \&%c -One byte counts only. -.TP -.BR \&%d , \ \&%i , \ \&%o , \ \&%u , \ \&%X , \ \&%x -Four byte default, one, two and four byte counts supported. -.TP -.BR \&%E , \ \&%e , \ \&%f , \ \&%G , \ \&%g -Eight byte default, four byte counts supported. -.PP -The amount of data interpreted by each format string is the sum of the data -required by each format unit, which is the iteration count times the byte -count, or the iteration count times the number of bytes required by the -format if the byte count is not specified. -.PP -The input is manipulated in -.IR blocks , -where a block is defined as the largest amount of data specified by any -format string. Format strings interpreting less than an input block's worth -of data, whose last format unit both interprets some number of bytes and does -not have a specified iteration count, have the iteration count incremented -until the entire input block has been processed or there is not enough data -remaining in the block to satisfy the format string. -.PP -If, either as a result of user specification or -.B hexdump -modifying the iteration count as described above, an iteration count is -greater than one, no trailing whitespace characters are output during the -last iteration. -.PP -It is an error to specify a byte count as well as multiple conversion -characters or strings unless all but one of the conversion characters or -strings is -.B \&_a -or -.BR \&_A . -.PP -If, as a result of the specification of the -.B \-n -option or end-of-file being reached, input data only partially satisfies a -format string, the input block is zero-padded sufficiently to display all -available data (i.e., any format units overlapping the end of data will -display some number of the zero bytes). -.PP -Further output by such format strings is replaced by an equivalent number of -spaces. An equivalent number of spaces is defined as the number of spaces -output by an -.B s -conversion character with the same field width and precision as the original -conversion character or conversion string but with any -.RB ' \&+ ', -\' \', -.RB ' \&# ' -conversion flag characters removed, and referencing a NULL string. -.PP -If no format strings are specified, the default display is very similar to -the \fB\-x\fR output format (the \fB\-x\fR option causes more space to be -used between format units than in the default output). -.SH EXIT STATUS -.B hexdump -exits 0 on success and >0 if an error occurred. -.SH CONFORMING TO -The -.B hexdump -utility is expected to be IEEE Std 1003.2 ("POSIX.2") compatible. -.SH EXAMPLES -Display the input in perusal format: -.nf - "%06.6_ao " 12/1 "%3_u " - "\et\et" "%_p " - "\en" -.fi -.PP -Implement the \-x option: -.nf - "%07.7_Ax\en" - "%07.7_ax " 8/2 "%04x " "\en" -.fi -.PP -MBR Boot Signature example: Highlight the addresses cyan and the bytes at -offsets 510 and 511 green if their value is 0xAA55, red otherwise. -.nf - "%07.7_Ax_L[cyan]\en" - "%07.7_ax_L[cyan] " 8/2 " %04x_L[green:0xAA55@510-511,!red:0xAA55@510-511] " "\en" -.fi -.SH COLORS -Implicit coloring can be disabled by an empty file \fI/etc/terminal-colors.d/hexdump.disable\fR. - -See -.BR terminal-colors.d (5) -for more details about colorization configuration. -.SH AVAILABILITY -The hexdump command is part of the util-linux package and is available from -.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ -Linux Kernel Archive -.UE . diff --git a/text-utils/line.1 b/text-utils/line.1 deleted file mode 100644 index a7667910ed..0000000000 --- a/text-utils/line.1 +++ /dev/null @@ -1,17 +0,0 @@ -.\" This page is in the public domain -.TH LINE 1 "July 2002" "util-linux" "User Commands" -.SH NAME -line \- read one line -.SH SYNOPSIS -.B line -.SH DESCRIPTION -The utility -.B line -copies one line (up to a newline) from standard input to standard output. -It always prints at least a newline and returns an exit status of 1 -on EOF or read error. -.SH SEE ALSO -.BR read (1p) -.SH AVAILABILITY -The line command is part of the util-linux package and is available from -https://www.kernel.org/pub/linux/utils/util-linux/. diff --git a/text-utils/more.1 b/text-utils/more.1 deleted file mode 100644 index 2444fae766..0000000000 --- a/text-utils/more.1 +++ /dev/null @@ -1,258 +0,0 @@ -.\" Copyright (c) 1988, 1990 The Regents of the University of California. -.\" Copyright (c) 1988 Mark Nudleman -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)more.1 5.15 (Berkeley) 7/29/91 -.\" -.\" Copyright (c) 1992 Rik Faith (faith@cs.unc.edu) -.\" -.TH MORE "1" "March 2020" "util-linux" "User Commands" -.SH NAME -more \- file perusal filter for crt viewing -.SH SYNOPSIS -.B more -[options] -.IR file ... -.SH DESCRIPTION -.B more -is a filter for paging through text one screenful at a time. This version is -especially primitive. Users should realize that -.BR less (1) -provides -.BR more (1) -emulation plus extensive enhancements. -.SH OPTIONS -Options are also taken from the environment variable -.B MORE -(make sure to precede them with a dash -.RB ( \- )) -but command-line options will override those. -.TP -.BR \-d , " \-\-silent" -Prompt with "[Press space to continue, 'q' to quit.]", -and display "[Press 'h' for instructions.]" instead of ringing -the bell when an illegal key is pressed. -.TP -.BR \-l , " \-\-logical" -Do not pause after any line containing a -.B \&\(haL -(form feed). -.TP -.BR \-f , " \-\-no\-pause" -Count logical lines, rather than screen lines (i.e., long lines are not folded). -.TP -.BR \-p , " \-\-print\-over" -Do not scroll. Instead, clear the whole screen and then display the text. -Notice that this option is switched on automatically if the executable is -named -.BR page . -.TP -.BR \-c , " \-\-clean\-print" -Do not scroll. Instead, paint each screen from the top, clearing the -remainder of each line as it is displayed. -.TP -.BR \-s , " \-\-squeeze" -Squeeze multiple blank lines into one. -.TP -.BR \-u , " \-\-plain" -Suppress underlining. This option is silently ignored as backwards -compatibility. -.TP -\fB\-n\fR, \fB\-\-lines \fInumber\fR -Specify the -.I number -of lines per screenful. The -.I number -argument is a positive decimal integer. The -.B \-\-lines -option shall override any values obtained from any other source, such as -number of lines reported by terminal. -.TP -.BI \- number -A numeric option means the same as -.B \-\-lines -option argument. -.TP -.BI + number -Start displaying each file at line -.IR number . -.TP -.BI +/ string -The -.I string -to be searched in each file before starting to display it. -.TP -\fB\-\-help\fR -Display help text and exit. -.TP -\fB\-V\fR, \fB\-\-version\fR -Display version information and exit. -.SH COMMANDS -Interactive commands for -.B more -are based on -.BR vi (1). -Some commands may be preceded by a decimal number, called k in the -descriptions below. In the following descriptions, -.B \(haX -means -.BR control-X . -.PP -.RS -.PD 1 -.TP 10 -.BR h \ or \ ? -Help; display a summary of these commands. If you forget all other -commands, remember this one. -.TP -.B SPACE -Display next k lines of text. Defaults to current screen size. -.TP -.B z -Display next k lines of text. Defaults to current screen size. Argument -becomes new default. -.TP -.B RETURN -Display next k lines of text. Defaults to 1. Argument becomes new default. -.TP -.BR d \ or \ \&\(haD -Scroll k lines. Default is current scroll size, initially 11. Argument -becomes new default. -.TP -.BR q \ or \ Q \ or \ INTERRUPT -Exit. -.TP -.B s -Skip forward k lines of text. Defaults to 1. -.TP -.B f -Skip forward k screenfuls of text. Defaults to 1. -.TP -.BR b \ or \ \&\(haB -Skip backwards k screenfuls of text. Defaults to 1. Only works with files, -not pipes. -.TP -.B ' -Go to the place where the last search started. -.TP -.B = -Display current line number. -.TP -.B \&/pattern -Search for kth occurrence of regular expression. Defaults to 1. -.TP -.B n -Search for kth occurrence of last regular expression. Defaults to 1. -.TP -.BR !command \ or \ :!command -Execute -.I command -in a subshell. -.TP -.B v -Start up an editor at current line. The editor is taken from the environment -variable -.B VISUAL -if defined, or -.B EDITOR -if -.B VISUAL -is not defined, or defaults -to -.B vi -if neither -.B VISUAL -nor -.B EDITOR -is defined. -.TP -.B \&\(haL -Redraw screen. -.TP -.B :n -Go to kth next file. Defaults to 1. -.TP -.B :p -Go to kth previous file. Defaults to 1. -.TP -.B :f -Display current file name and line number. -.TP -.B \&. -Repeat previous command. -.RE -.SH ENVIRONMENT -The -.B more -command respects the following environment variables, if they exist: -.TP -.B MORE -This variable may be set with favored options to -.BR more . -.TP -.B SHELL -Current shell in use (normally set by the shell at login time). -.TP -.B TERM -The terminal type used by \fBmore\fR to get the terminal -characteristics necessary to manipulate the screen. -.TP -.B VISUAL -The editor the user prefers. Invoked when command key -.I v -is pressed. -.TP -.B EDITOR -The editor of choice when -.B VISUAL -is not specified. -.SH HISTORY -The -.B more -command appeared in 3.0BSD. This man page documents -.B more -version 5.19 (Berkeley 6/29/88), which is currently in use in the Linux -community. Documentation was produced using several other versions of the -man page, and extensive inspection of the source code. -.SH AUTHORS -Eric Shienbrood, UC Berkeley -.br -Modified by Geoff Peck, UCB to add underlining, single spacing -.br -Modified by John Foderaro, UCB to add \-c and MORE environment variable -.SH SEE ALSO -.BR less (1), -.BR vi (1) -.SH AVAILABILITY -The more command is part of the util-linux package and is available from -.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ -Linux Kernel Archive -.UE . diff --git a/text-utils/pg.1 b/text-utils/pg.1 deleted file mode 100644 index 347dd70714..0000000000 --- a/text-utils/pg.1 +++ /dev/null @@ -1,238 +0,0 @@ -.\" Copyright 2001 Gunnar Ritter -.TH PG 1 "July 2014" "util-linux" "User Commands" -.SH NAME -pg \- browse pagewise through text files -.SH SYNOPSIS -.B pg -.RB [ \-\fIamount\fP ] -.RB [ \-p -.IR prompt ] -.RB [ \-cefnrs ] -.RB [ +\fIline\fP ] -.RB [ +/\fIpattern\fP/ ] -.RI [ file ...] -.SH DESCRIPTION -.B pg -displays a text file on a -.SM CRT -one screenful at once. -After each page, a prompt is displayed. The user may then either press the -newline key to view the next page or one of the keys described below. -.PP -If no filename is given on the command line, -.B pg -reads from standard input. -If standard output is not a terminal, -.B pg -acts like -.BR cat (1) -but precedes each file with its name if there is more than one. -.PP -If input comes from a pipe, -.B pg -stores the data in a buffer file while reading, -to make navigation possible. -.SH OPTIONS -.B pg -accepts the following options: -.TP -.BI + number -Start at the given line number. -.TP -.BI +/ pattern / -Start at the line containing the Basic Regular Expression -.I pattern -given. -.TP -.BI \- number -The number of lines per page. By default, this is the number of -.SM CRT -lines minus one. -.TP -.B \-c -Clear the screen before a page is displayed, -if the terminfo entry for the terminal provides this capability. -.TP -.B \-e -Do not pause and display -.SM (EOF) -at the end of a file. -.TP -.B \-f -Do not split long lines. -.TP -.B \-n -Without this option, commands must be terminated by a newline character. -With this option, -.B pg -advances once a command letter is entered. -.TP -.BI \-p \ string -Instead of the normal prompt -.IR : , -.I string -is displayed. -If -.I string -contains -.BR %d , -its first occurrence is replaced by the number of the current page. -.TP -.B \-r -Disallow the shell escape. -.TP -.B \-s -Print messages in -.I standout -mode, -if the terminfo entry for the terminal provides this capability. -.TP -.BR \-V , " \-\-version" -Display version information and exit. -.TP -.BR \-h , " \-\-help" -Display help text and exit. -.SH COMMANDS -The following commands may be entered at the prompt. Commands preceded by -.I i -in this document accept a number as argument, positive or negative. -If this argument starts with -.B + -or -.BR \- , -it is interpreted relative to the current position in the input file, -otherwise relative to the beginning. -.TP -.IB i -Display the next or the indicated page. -.TP -\fIi\fR\fBd\fR or \fB\(haD\fR -Display the next halfpage. If -.I i -is given, it is always interpreted relative to the current position. -.TP -.IB i l -Display the next or the indicated line. -.TP -.IB i f -Skip a page forward. -.I i -must be a positive number and is always interpreted relative -to the current position. -.TP -\fIi\fR\fBw\fR or \fIi\fR\fBz\fR -As -.B -except that -.I i -becomes the new page size. -.TP -.BR . " or " \(haL -Redraw the screen. -.TP -.B $ -Advance to the last line of the input file. -.TP -.IB i / pattern / -Search forward until the first or the \fIi\fR-th -occurrence of the Basic Regular Expression -.I pattern -is found. The search starts -after the current page and stops at the end of the file. -No wrap-around is performed. -.I i -must be a positive number. -.TP -\fIi\fR\fB?\fR\fIpattern\fR\fB?\fR or \fIi\fR\fB\(ha\fR\fIpattern\fR\fB\(ha\fR -Search backward until the first or the \fIi\fR-th -occurrence of the Basic Regular Expression -.I pattern -is found. The search starts -before the current page and stops at the beginning of the file. -No wrap-around is performed. -.I i -must be a positive number. -.PP -The search commands accept an added letter. If -.B t -is given, the line containing the pattern is displayed at the top of the -screen, which is the default. -.B m -selects the middle and -.B b -the bottom of the screen. -The selected position is used in following searches, too. -.TP -.IB i n -Advance to the next file or -.I i -files forward. -.TP -.IB i p -Reread the previous file or -.I i -files backward. -.TP -.BI s \ filename -Save the current file to the given -.I filename. -.TP -.B h -Display a command summary. -.TP -.BI ! command -Execute -.I command -using the shell. -.TP -.BR q " or " Q -Quit. -.PP -If the user presses the interrupt or quit key while -.B pg -reads from the -input file or writes on the terminal, -.B pg -will immediately display the prompt. -In all other situations these keys will terminate -.BR pg . -.SH ENVIRONMENT -The following environment variables -affect the behavior of -.BR pg : -.TP -.B COLUMNS -Overrides the system-supplied number of columns if set. -.TP -.BR LANG ,\ LC_ALL ,\ LC_COLLATE ,\ LC_CTYPE ,\ LC_MESSAGES -See -.BR locale (7). -.TP -.B LINES -Overrides the system-supplied number of lines if set. -.TP -.B SHELL -Used by the -.BR ! " command." -.TP -.B TERM -Determines the terminal type. -.SH NOTES -.B pg -expects the terminal tabulators to be set every eight positions. -.PP -Files that include -.SM NUL -characters cannot be displayed by -.BR pg . -.SH SEE ALSO -.BR cat (1), -.BR more (1), -.BR sh (1p), -.BR terminfo (5), -.BR locale (7), -.BR regex (7), -.BR term (7) -.SH AVAILABILITY -The pg command is part of the util-linux package and is available from -https://www.kernel.org/pub/linux/utils/util-linux/. diff --git a/text-utils/rev.1 b/text-utils/rev.1 deleted file mode 100644 index 3b45bfa6a7..0000000000 --- a/text-utils/rev.1 +++ /dev/null @@ -1,63 +0,0 @@ -.\" Copyright (c) 1985, 1992 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)rev.1 6.3 (Berkeley) 3/21/92 -.\" -.TH REV "1" "September 2011" "util-linux" "User Commands" -.SH NAME -rev \- reverse lines characterwise -.SH SYNOPSIS -.B rev -[option] -.RI [ file ...] -.SH DESCRIPTION -The -.B rev -utility copies the specified files to standard output, reversing the order of -characters in every line. If no files are specified, standard input is read. -.PP -This utility is a line-oriented tool and it uses in-memory allocated buffer -for a whole wide-char line. If the input file is huge and without line breaks -than allocate the memory for the file may be unsuccessful. -.SH OPTIONS -.TP -\fB\-V\fR, \fB\-\-version\fR -Display version information and exit. -.TP -\fB\-h\fR, \fB\-\-help\fR -Display help text and exit. -.SH SEE ALSO -.BR tac (1) -.SH AVAILABILITY -The rev command is part of the util-linux package and is available from -.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ -Linux Kernel Archive -.UE . diff --git a/text-utils/ul.1 b/text-utils/ul.1 deleted file mode 100644 index 860087593b..0000000000 --- a/text-utils/ul.1 +++ /dev/null @@ -1,113 +0,0 @@ -.\" Copyright (c) 1980, 1991, 1993 -.\" The Regents of the University of California. All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)ul.1 8.1 (Berkeley) 6/6/93 -.\" -.TH UL "1" "September 2011" "util-linux" "User Commands" -.SH NAME -ul \- do underlining -.SH SYNOPSIS -.BR ul " [options]" -.RI [ file ...] -.SH DESCRIPTION -.B ul -reads the named files (or standard input if none are given) and translates -occurrences of underscores to the sequence which indicates underlining for -the terminal in use, as specified by the environment variable -.BR TERM . -The -.I terminfo -database is read to determine the appropriate sequences for underlining. If -the terminal is incapable of underlining but is capable of a standout mode, -then that is used instead. If the terminal can overstrike, or handles -underlining automatically, -.B ul -degenerates to -.BR cat (1). -If the terminal cannot underline, underlining is ignored. -.SH OPTIONS -.TP -\fB\-i\fR, \fB\-\-indicated\fR -Underlining is indicated by a separate line containing appropriate dashes -`\-'; this is useful when you want to look at the underlining which is -present in an -.B nroff -output stream on a crt-terminal. -.TP -\fB\-t\fR, \fB\-T\fR, \fB\-\-terminal\fR \fIterminal\fR -Override the environment variable -.B TERM -with the specified -.I terminal -type. -.TP -\fB\-V\fR, \fB\-\-version\fR -Display version information and exit. -.TP -\fB\-h\fR, \fB\-\-help\fR -Display help text and exit. -.SH ENVIRONMENT -The following environment variable is used: -.TP -.B TERM -The -.B TERM -variable is used to relate a tty device with its device capability -description (see -.BR terminfo (5)). -.B TERM -is set at login time, either by the default terminal type specified in -.I /etc/ttys -or as set during the login process by the user in their -.B login -file (see -.BR setenv (3)). -.SH HISTORY -The -.B ul -command appeared in 3.0BSD. -.SH BUGS -.B nroff -usually outputs a series of backspaces and underlines intermixed with the -text to indicate underlining. No attempt is made to optimize the backward -motion. -.SH SEE ALSO -.BR colcrt (1), -.BR login (1), -.BR man (1), -.BR nroff (1), -.BR setenv (3), -.BR terminfo (5) -.SH AVAILABILITY -The ul command is part of the util-linux package and is available from -.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ -Linux Kernel Archive -.UE .