.\" Copyright (c) 2002 Andries Brouwer <aeb@cwi.nl>
.\"
-.\" %%%LICENSE_START(VERBATIM)
-.\" Permission is granted to make and distribute verbatim copies of this
-.\" manual provided the copyright notice and this permission notice are
-.\" preserved on all copies.
+.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
-.\" Permission is granted to copy and distribute modified versions of this
-.\" manual under the conditions for verbatim copying, provided that the
-.\" entire resulting derived work is distributed under the terms of a
-.\" permission notice identical to this one.
-.\"
-.\" Since the Linux kernel and libraries are constantly changing, this
-.\" manual page may be incorrect or out-of-date. The author(s) assume no
-.\" responsibility for errors or omissions, or for damages resulting from
-.\" the use of the information contained herein. The author(s) may not
-.\" have taken the same level of care in the production of this manual,
-.\" which is licensed free of charge, as they might when working
-.\" professionally.
-.\"
-.\" Formatted or processed versions of this manual, if unaccompanied by
-.\" the source, must acknowledge the copyright and authors of this work.
-.\" %%%LICENSE_END
-.\"
-.\" 2007-10-23 mtk Added intro paragraph about section, plus a paragraph
-.\" about exit status values.
-.\"
-.TH INTRO 1 2015-03-29 "Linux" "Linux User's Manual"
+.TH intro 1 (date) "Linux man-pages (unreleased)"
.SH NAME
intro \- introduction to user commands
.SH DESCRIPTION
Section 1 of the manual describes user commands and tools,
for example, file manipulation tools, shells, compilers,
web browsers, file and image viewers and editors, and so on.
-
-All commands yield a status value on termination.
-This value can be tested (e.g., in most shells the variable
-.I $?
-contains the status of the last executed command)
-to see whether the command completed successfully.
-A zero exit status is conventionally used to indicate success,
-and a nonzero status means that the command was unsuccessful.
-(Details of the exit status can be found in
-.BR wait (2).)
-A nonzero exit status can be in the range 1 to 255, and some commands
-use different nonzero status values to indicate the reason why the
-command failed.
.SH NOTES
Linux is a flavor of UNIX, and as a first approximation
all user commands under UNIX work precisely the same under
Linux (and FreeBSD and lots of other UNIX-like systems).
-.LP
+.PP
Under Linux, there are GUIs (graphical user interfaces), where you
can point and click and drag, and hopefully get work done without
first reading lots of documentation.
Below a bare minimum, to get started.
.SS Login
In order to start working, you probably first have to open a session by
-giving, your username and password.
+giving your username and password.
The program
.BR login (1)
now starts a
the command interpreter.
It is not built-in, but is just a program
and you can change your shell.
-Everybody has her own favorite one.
+Everybody has their own favorite one.
The standard one is called
.IR sh .
See also
.BR dash (1),
.BR ksh (1),
.BR zsh (1).
-.LP
+.PP
A session might go like:
-.LP
-.RS
-.nf
+.PP
+.in +4n
+.EX
.RB "knuth login: " aeb
.RB "Password: " ********
.RB "$ " date
.RB "$ " "grep maja tel2"
maja 0501\-1136285
$
-.fi
-.RE
-.LP
+.EE
+.in
+.PP
Here typing Control-D ended the session.
-.LP
+.PP
The
.B $
-here was the command prompt\(emit is the shell's way of indicating
+here was the command prompt\[em]it is the shell's way of indicating
that it is ready for the next command.
The prompt can be customized
in lots of ways, and one might include stuff like username,
machine name, current directory, time, and so on.
An assignment PS1="What next, master? "
would change the prompt as indicated.
-.LP
+.PP
We see that there are commands
.I date
(that gives date and time), and
.I cal
(that gives a calendar).
-.LP
+.PP
The command
.I ls
-lists the contents of the current directory\(emit tells you what
+lists the contents of the current directory\[em]it tells you what
files you have.
With a
.I \-l
.I chown
and
.IR chmod .
-.LP
+.PP
The command
.I cat
will show the contents of a file.
.BR stdout (3)),
here
the terminal screen.)
-.LP
+.PP
The command
.I cp
(from "copy") will copy a file.
-.LP
+.PP
The command
.I mv
(from "move"), on the other hand, only renames it.
-.LP
+.PP
The command
.I diff
lists the differences between two files.
Here there was no output because there were no differences.
-.LP
+.PP
The command
.I rm
(from "remove") deletes the file, and be careful! it is gone.
No wastepaper basket or anything.
Deleted means lost.
-.LP
+.PP
The command
.I grep
(from "g/re/p") finds occurrences of a string in one or more files.
That is why
.I /home/aeb/tel
can be abbreviated
-to
+to
.I tel
when the current directory is
.IR /home/aeb .
-.LP
+.PP
The command
.I pwd
prints the current directory.
-.LP
+.PP
The command
.I cd
changes the current directory.
-.LP
+.PP
Try alternatively
.I cd
and
.I pwd
commands and explore
.I cd
-usage: "cd", "cd .", "cd ..", "cd /" and "cd ~".
+usage: "cd", "cd .", "cd ..", "cd /", and "cd \[ti]".
.SS Directories
The command
.I mkdir
makes a new directory.
-.LP
+.PP
The command
.I rmdir
removes a directory if it is empty, and complains otherwise.
-.LP
+.PP
The command
.I find
(with a rather baroque syntax) will find files with given name
usually
.IR less .
Hit the space bar to get the next page, hit q to quit.
-.LP
+.PP
In documentation it is customary to refer to man pages
by giving the name and section number, as in
.BR man (1).
detail.
For newcomers an introductory text with more examples
and explanations is useful.
-.LP
+.PP
A lot of GNU/FSF software is provided with info files.
Type "info info"
for an introduction on the use of the program
.IR info .
-.LP
+.PP
Special topics are often treated in HOWTOs.
Look in
.I /usr/share/doc/howto/en
.BR zsh (1),
.BR wait (2),
.BR stdout (3),
-.BR man-pages (7),
+.BR man\-pages (7),
.BR standards (7)
projects / thirdparty / man-pages.git / blobdiff