moved to separate man page repo

This commit is contained in:
Gitea 2020-12-21 21:03:22 -06:00
parent 8af20d2e9c
commit 97a08b7556
22 changed files with 0 additions and 815 deletions

50
asa.1
View file

@ -1,50 +0,0 @@
.TH ASA 1
.SH NAME
asa \- interpret carriage-control characters
.SH SYNOPSIS
.B asa
.IR file
.SH DESCRIPTION
.B asa
maps carriage-control characters from a text file to line-printer
control sequences. The first character of every line is removed from
the input, with the following actions being performed.
.PP
If the character removed is:
.PP
.nf
.RS
<space> \- The rest of the line is output without change
.PP
0 \- A <newline> is output, then the rest of the input line.
.PP
1 \- A <formfeed> is output, then the rest of the input line.
.PP
+ \- A <carriage return> is output, then the rest of the input line.
.RE
.fi
.PP
If asa encounters any other characters, it behaves as if it
encountered <space>.
.SH OPTIONS
None
.SH EXAMPLES
.nf
.RS
a.out | asa | lp
.RE
.fi
.PP
formats the FORTRAN output of
.B a.out
and directs it to the printer.
.SH SEE ALSO
.BR fort77 (1),
.BR lp (1)
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2019 Katlynn Richey
.PP
This software is free software. Feel free to modify it and/or pass
it around.

View file

@ -1,42 +0,0 @@
.TH BASENAME 1
.SH NAME
basename \- return non-directory portion of a pathname
.SH SYNOPSIS
.B basename
.IR string
[\fIsuffix\fR]
.SH DESCRIPTION
.B basename
strips a pathname of everything but the string following the last
slash and prints the result. If the pathname has a trailing slash,
it is removed, and it prints everything past the slash before it. If
a suffix is included, it will remove the suffix from the basename
before printing it.
.SH OPTIONS
None
.SH EXAMPLES
.PP
.nf
.RS
basename /usr/share/include/stdio.h
.RE
.fi
.PP
Prints out "stdio.h"
.PP
.nf
.RS
basename /usr/share/include/stdio.h .h
.RE
.fi
.PP
Prints out "stdio"
.SH SEE ALSO
.BR dirname (1)
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2019 Katlynn Richey
.PP
This software is free software. Feel free to modify it and/or pass
it around.

59
cat.1
View file

@ -1,59 +0,0 @@
.TH CAT 1
.SH NAME
cat \- concatenate and print files
.SH SYNOPSIS
.B cat
[\fB\-u\fR]
.IR file ...
.SH DESCRIPTION
.B cat
reads in files one at a time and prints the contents to standard
output. If \- is read, \fBcat\fR reads from standard input.
.SH OPTIONS
.TP
.BR \-u
Writes bytes from the input files to standard output without delay
as each is read. Writing with this flag is unbuffered.
.SH EXAMPLES
cat file
.PP
.nf
.RS
writes the contents of file to standard output
.RE
.fi
.PP
cat file1 file2 > all_files
.PP
.nf
.RS
concatenates the files \fBfile1\fR and \fBfile2\fR and writes the
result to \fBall_files\fR.
.RE
.fi
.PP
cat file2 >> file1
.PP
.nf
.RS
appends the contents of \fBfile2\fR into \fBfile1\fR
.RE
.fi
.PP
cat header_text - > table
.PP
.nf
.RS
writes the contents of \fBheader_text\fR into \fBtable\fR then
reads from standard input and writes it into \fBtable\fR
.RE
.fi
.SH SEE ALSO
.BR more (1)
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2019 Katlynn Richey
.PP
This software is free software. Feel free to modify it and/or pass
it around.

20
cksum.1
View file

@ -1,20 +0,0 @@
.TH CKSUM 1
.SH NAME
cksum \- write file checksums and sizes
.SH SYNOPSIS
.B cksum
.IR file ...
.SH DESCRIPTION
.B cksum
calculates and outputs to standard output a cyclic redundancy check
for each file it takes in, in addition to the number of octets in
each file.
.SH OPTIONS
None
.SH AUTHOR
Written by Kat
.SH COPYRIGHT
Copyright (C) 2019 Katlynn Richey
.PP
This software is free software. Feel free to modify it and/or pass
it around.

48
cmp.1
View file

@ -1,48 +0,0 @@
.TH CMP 1
.SH NAME
cmp \- compare two files
.SH SYNOPSIS
.B cmp
[\fB\-l\fR|\fB\-s\fR]
.IR file1
.IR file2
.SH DESCRIPTION
.B cmp
compares two files. If the two files are identical, \fBcmp\fR writes
no output. Otherwise, by default, it outputs the byte and line
number of the first difference.
.PP
If the two files are of different lengths, \fBcmp\fR also writes the
name of the shorter file to stderr.
.SH OPTIONS
.TP
.BR \-l
.TP
Outputs the byte number and differing byte for each difference
.BR \-s
Suppresses all output, even when the files differ. If the two files
are of differing lengths, it also suppresses that notice. A
difference in the two files is indicated through exit status only.
.SH EXIT STATUS
.TP
.BR 0
The files are identical.
.TP
.BR 1
The files are different or are of different lengths.
.TP
.BR 2
Tried to use stdin as both files.
.TP
.BR 3
Not enough file operands.
.TP
.BR 4
Could not open one or both files.
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2020 The FENIX Project
.PP
This software is free software. Feel free to modify it and/or pass
it around.

View file

@ -1,45 +0,0 @@
.TH DIRNAME 1
.SH NAME
dirname \- return directory portion of a pathname
.SH SYNOPSIS
.B dirname
.IR string
.SH DESCRIPTION
.B dirname
strips a pathname of everything following the last slash and prints
the result. If the pathname has a trailing slash, it is removed and
it strips everything past the slash before it.
.SH OPTIONS
None
.SH EXAMPLES
.PP
.nf
.RS
dirname /usr/share/include/stdio.h
.RE
.fi
.PP
Prints out "/usr/share/include"
.PP
.nf
.RS
dirname stdio.h
.RE
.fi
.PP
Prints out "."
.PP
.nf
.RS
dirname //
.RE
.fi
.PP
Prints out "/"
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2019 Katlynn Richey
.PP
This software is free software. Feel free to modify it and/or pass
it around.

54
echo.1
View file

@ -1,54 +0,0 @@
.TH ECHO 1
.SH NAME
echo \- print text to stdout
.SH SYNOPSIS
.B echo
.IR string
.SH DESCRIPTION
.B echo
writes any arguments it receives to standard output, followed by a
single <newline>. If it receives no arguments, it only outputs a
single <newline>.
In strings contained in quotes, \fBecho\fR recognises the following
character sequences:
.TP
.B \ea
Beeps the PC speaker (writes an <alert>).
.TP
.B \eb
Writes a <backspace>.
.TP
.B \ec
Makes \fBecho\fR not print a newline following the output.
.TP
.B \ef
Writes a <formfeed>.
.TP
.B \en
Writes a <newline>.
.TP
.B \er
Writes a <carriage return>.
.TP
.B \et
Writes a <tab>.
.TP
.B \ev
Writes a <vertical tab>.
.TP
.B \e\e
Writes a <backslash> (\e).
.TP
.B \e0\fInum\fR
Writes the character corresponding to the 8-bit octal number
\fInum\fR
.SH OPTIONS
None
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2019 Katlynn Richey
.PP
This software is free software. Feel free to modify it and/or pass
it around.

View file

@ -1,58 +0,0 @@
.TH EXPAND 1
.SH NAME
expand \- convert tabs to spaces
.SH SYNOPSIS
.B expand
[\fB\-t\fR \fItablist\fR]
.IR file ...
.SH DESCRIPTION
.B expand
writes files to the standard output with any <tab> characters
replaced with one or more <space> characters to pad to the next tab
stop. By default, there is a tab stop every 8 characters.
.SH OPTIONS
.TP
.BR -t " " \fItablist\FR
Takes in one or more space-separated numbers to set the number of
spaces between each tab stop.
.SH EXAMPLES
.nf
.RS
expand file
.RE
.fi
.PP
replaces <tab> characters in file with enough <space> characters to
pad to a tab stop every 8 columns.
.PP
.nf
.RS
expand -t 10 file
.RE
.fi
.PP
replaces <tab> characters in file with enough <space> characters to
pad to a tab stop every 10 columns.
.PP
.nf
.RS
expand -t 10 5 8 file
.RE
.fi
.PP
replaces the first <tab> in every line of file with enough <space>
characters to pad to a tab stop on column 10, the second <tab> with
enough <space> characters to pad to a tab stop 5 columns after the
first tab stop, then the third <tab> with enough <space> characters
to pad to a tab stop 8 columns after the second tab stop. Any
further <tab> characters on a line will be replaced with a single
<space>.
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2019 Katlynn Richey
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBexpand\fR implementation is a part of the fenutils package.

27
false.1
View file

@ -1,27 +0,0 @@
.TH TRUE 1
.SH NAME
false \- consistently fails
.SH SYNOPSIS
.B false
.SH DESCRIPTION
.B false
never succeeds. It always returns 1. It does literally nothing else
It has no options. It has no operands. It doesn't use stdin, stdout,
or stderr. It doesn't rely on environment variables. It doesn't use
files. It's guaranteed to always fail or we'll give you a full
refund. It just returns one.
.PP
According to the POSIX standard, this program should always exit
some non-zero value. That is literally all this program does. It
returns anything but 0.
.SH OPTIONS
None
.SH AUTHOR
"Written" by Kat.
.SH COPYRIGHT
Copyright (C) 2019 Katlynn Richey
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBfalse\fR implementation is a part of the fenutils package.

36
head.1
View file

@ -1,36 +0,0 @@
.TH HEAD 1
.SH HEAD
head \- copy the first part of files
.SH SYNOPSIS
.B head
[\fB\-n\fR \fInumber\fR]
.IR "file" ...
.SH DESCRIPTION
.B head
copies input files to the standard output, ending at a designated point.
.PP
Copying ends at the the point indicated by the \fB\-n\fR option.
If \fB\-n\fR is omitted, \fBhead\fR will default to 10.
.SH OPTIONS
.TP
.BR \-n " " \fInumber\fR
Specifies the number of lines to copy to standard output.
.SH EXAMPLES
An example example:
.PP
.nf
.RS
head -- *
.RE
.fi
.PP
Copies the first ten lines of all files to standard output.
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2019 The FENIX Project
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBhead\fR implementation is a part of the fenutils package.

23
link.1
View file

@ -1,23 +0,0 @@
.TH LINK 1
.SH NAME
link \- call link(3)
.SH SYNOPSIS
.B link
.IR "file1 file2"
.SH DESCRIPTION
.B link
performs the function call
.B link\fR(\fIfile1\fR \fIfile2\fR);
This creates a hard link from \fIfile2\fR to \fIfile1\fR.
For more information, see link(3).
.SH OPTIONS
None
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2019 Katlynn Richey
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBlink\fR implementation is a part of the fenutils package.

44
ln.1
View file

@ -1,44 +0,0 @@
.TH LN 1
.SH NAME
ln \- link files
.SH SYNOPSIS
.B ln
[\fB\-fs\fR] [\fB\-L\fR|\fB\-P\fR]
.IR "source_file" \fI"target_file"\fR
.PP
.B ln
[\fB\-fs\fR] [\fB\-L\fR|\fB\-P\fR]
.IR "source_file..." \fI"target_dir"\fR
.SH DESCRIPTION
.B ln
creates links to a file or files. If the \fB\-s\fR option is
specified, a symbolic link is created. Otherwise, a hard link is
created. If multiple source files are given, links to each file are
created in the target directory.
.SH OPTIONS
A listing of options
.TP
.BR \-f
Overwrite any existing files with the same name as the link to be
created.
.TP
.BR \-s
Create symbolic links instead of hard links. If specified, any
instances of \fB\-L\fR and \fB\-P\fR are ignored.
.TP
.BR \-L
If a source file is a symbolic link, create a link to the file
referenced by the symbolic link.
.TP
.BR \-P
If a source file is a symbolic link, create a link to the symbolic
link.
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2019 Katlynn Richey
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBln\fR implementation is a part of the fenutils package.

View file

@ -1,20 +0,0 @@
.TH LOGNAME 1
.SH NAME
logname \- return the user's login name
.SH SYNOPSIS
.B logname
.SH DESCRIPTION
.B logname
simply writes the user's login name to standard output. That's it. It's
basically just a call to getlogin(3). Pretty simple.
.SH OPTIONS
None
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2020 The FENIX Project
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBlogname\fR implementation is part of the fenutils package.

View file

@ -1,38 +0,0 @@
.TH MKFIFO 1
.SH NAME
mkfifo - create named pipes
.SH SYNOPSIS
.B mkfifo
[\fB\-m\fR \fImode\fR]
.IR file ...
.SH DESCRIPTION
.B mkfifo
creates named pipes (FIFOs) with the given \fIname\fRs. The creation mode can
be specified with the mode argument either as an octal number or as a symbolic
mode (e.g. ugo+rw). Note that the mode argument with be combined with the
default process file mode creation mask as given by umask (i.e. if the mask
is 022, an mode of 0777 will become 0755).
.SH OPTIONS
.TP
.BR "\-m " \fImode\fR
Set the file permission bits of the created pipe to the given mode value.
For symbolic mode strings (e.g. ugo+rx), '+' and '-' are interpretted relative
to an initial mode of \fIugo=rw\fR (0666).
.SH EXAMPLES
.nf
.RS
mkfifo -m 0774 pipe.in
.RE
.fi
.PP
Creates a named pipe with name \fBpipe.in\fR with mode \fI0774^$(umask)\fR.
(I.E. if umask is 023, the mode of \fBpipe.in\fR will be 0754.)
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2020 The FENIX Project
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBmkfifo\fR implementation is a part of the fenutils package.

31
pwd.1
View file

@ -1,31 +0,0 @@
.TH PWD 1
.SH PWD
pwd \- print working directory path
.SH SYNOPSIS
.B pwd
[\fB\-L\fR|\fB\-P\fR]
.SH DESCRIPTION
.B pwd
writes the pathname of the current working directory to
standard output.
.SH OPTIONS
.TP
.BR \-L
Retains any symbolic links in the current pathname. For instance,
if "a" is a symbolic link to "b", then "a" will be the name shown
if "a" was used in navigating to the current directory.
.TP
.BR \-P
Removes any symbolic links and shows the physical pathname. For
instance, if "a" is a symbolic link to "b", then "b" will be the
name shown, even if "a" was used in navigating to the current
directory
.SH AUTHOR
Written by Kat
.SH COPYRIGHT
Copyright (C) 2019 Katlynn Richey
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBpwd\fR implementation is a part of the fenutils package.

26
rmdir.1
View file

@ -1,26 +0,0 @@
.TH RMDIR 1
.SH NAME
rmdir \- remove empty directories
.SH SYNOPSIS
.B rmdir
[\fB\-p\fR]
.IR dir ...
.SH DESCRIPTION
.B rmdir
removes specified directory entries. It will only remove empty directories.
It will not remove directories that still contain stuff. For that, see rm(1)
.SH OPTIONS
.TP
.BR \-p
Remove all directories in pathname. e.g. If the directory argument is
\fBproject/subproject/dir\fR, rmdir will first remove dir, then remove
subproject, then remove project.
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2020 The FENIX Project
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBrmdir\fR implementation is a part of the fenutils package.

22
sleep.1
View file

@ -1,22 +0,0 @@
.TH SLEEP 1
.SH NAME
sleep \- rest for a specified interval
.SH SYNOPSYS
.B sleep
.IR time
.SH DESCRIPTION
.B sleep
suspends execution for no less than the number of seconds given by the
\fItime\fR parameter. That's it. It just stops for a bit, a bit close to,
though not necessarily exactly, the amount of time you specify.
.SH OPTIONS
None
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2020 The FENIX Project
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBsleep\fR implementation is a part of the fenutils package.

39
tee.1
View file

@ -1,39 +0,0 @@
.TH TEE 1
.SH NAME
tee \- write from stdin to file
.SH SYNOPSIS
.B tee
[\fB\-ai\fR]
[\fIfile\fR ...]
.SH DESCRIPTION
.B tee
copies standard input to standard output and to any files given on the command
line. It writes to files by default, clearing any existing files specified.
.SH OPTIONS
.TP
.BR \-a
Append output to files, rather than clobbering existing files.
.TP
.BR \-i
Ignore SIGINT (^C). If you use this, use Ctrl-D (^D) to send an
EOF in order to exit!
.SH EXIT STATUS
The following exit values are returned:
.TP
.BR 0
The program successfully wrote all files.
.TP
.BR 1
Could not open or create a file.
.TP
.BR 2
Failed to write to one or more files.
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2020 The FENIX Project
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBtee\fR implementation is part of the fenutils package.

26
true.1
View file

@ -1,26 +0,0 @@
.TH TRUE 1
.SH NAME
true \- successfully succeeds
.SH SYNOPSIS
.B true
.SH DESCRIPTION
.B true
returns successfully. It always returns 0. It does literally nothing
else. It has no options. It has no operands. It doesn't use stdin,
stdout, or stderr. It doesn't rely on environment variables. It
doesn't use files. It's guaranteed to never fail or we'll give you
a full refund. It just returns zero.
.PP
Hell, if you look at the POSIX standard, exit status literally just
says "Zero". That is literally all this program does. It returns 0.
.SH OPTIONS
None
.SH AUTHOR
"Written" by Kat.
.SH COPYRIGHT
Copyright (C) 2019 Katlynn Richey
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBtrue\fR implementation is a part of the fenutils package.

20
tty.1
View file

@ -1,20 +0,0 @@
.TH TTY 1
.SH NAME
tty \- return user's terminal name
.SH SYNOPSIS
.B tty
.SH DESCRIPTION
.B tty
writes the name of the device connected to standard output. It also
returns 0 if the device is a tty. Otherwise it returns 1.
.SH OPTIONS
None
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2019 Katlynn Richey
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBtty\fR implementation is a part of the fenutils package.

49
uname.1
View file

@ -1,49 +0,0 @@
.TH PWD 1
.SH NAME
uname \- print system name
.SH SYNOPSYS
.B uname
[\fB-amnrsv\fR]
.SH DESCRIPTION
.B uname
prints out the operating system name to standard output. Various options
correspond to various characteristics that can also be printed.
.SH OPTIONS
.TP
.BR \-a
Behaves as though \fB-mnrsv\fR were specified.
.TP
.BR \-m
Print the name of the hardware on which the system is running (e.g. x86).
.TP
.BR \-n
Print the name of this node on the network (i.e. the system's hostname).
.TP
.BR \-r
Print the current operating system release.
.TP
.BR \-s
Print the name of the operating system
.TP
.BR \-v
Print the current operating system version.
.SH EXIT STATUS
The following exit values are returned:
.TP
.BR 0
The program successfully did its thing.
.TP
.BR 1
Could not get the requested information.
.TP
.BR 2
Could not allocate space to store the requested information.
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2020 The FENIX Project
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBuname\fR implementation is a part of the fenutils package.

38
wc.1
View file

@ -1,38 +0,0 @@
.TH WC 1
.SH NAME
wc \- word, line, and byte/character count
.SH SYNOPSIS
.B wc
[\fB\-m\fR|\fB\-c\fR]
[\fB\-lw\fR]
.IR file ...
.SH DESCRIPTION
.B wc
writes the number of bytes in each input file to standard output.
Optionally, \fBwc\fR can also write the number of <newline>
characters and/or words to standard output as well. If more than one
file is specified, it will also write the total across all files
given as input.
.SH OPTIONS
A listing of options
.TP
.BR \-c
Write the number of bytes in each file
.TP
.BR \-l
Write the number of <newline> characters in each file
.TP
.BR \-m
Write the number of characters in each file
.TP
.BR \-w
Write the number of words in each file
.SH AUTHOR
Written by Kat.
.SH COPYRIGHT
Copyright (C) 2019 Katlynn Richey
.PP
This software is free software. Feel free to modify it and/or pass
it around.
.PP
This \fBwc\fR implementation is a part of the fenutils package.