Blame Manual/Introduction/convenctions.texi

34051a
In this manual, certain words are represented in different fonts,
34051a
typefaces, sizes, and weights. This highlighting is systematic;
34051a
different words are represented in the same style to indicate their
34051a
inclusion in a specific category. The types of words that are
34051a
represented this way include the following:
34051a
671838
@table @command
671838
@item command
34051a
34051a
Linux commands (and other operating system commands, when used) are
34051a
represented this way. This style should indicate to you that you can
34051a
type the word or phrase on the command line and press Enter to invoke
34051a
a command. Sometimes a command contains words that would be displayed
34051a
in a different style on their own (such as file names). In these
34051a
cases, they are considered to be part of the command, so the entire
34051a
phrase is displayed as a command. For example:
34051a
34051a
Use the @command{cat testfile} command to view the contents of a file,
34051a
named testfile, in the current working directory.
671838
@end table
34051a
671838
@table @file
671838
@item file name
34051a
34051a
File names, directory names, paths, and RPM package names are
34051a
represented this way. This style indicates that a particular file or
34051a
directory exists with that name on your system. Examples:
34051a
34051a
The @file{.bashrc} file in your home directory contains bash shell
34051a
definitions and aliases for your own use.
34051a
34051a
The @file{/etc/fstab} file contains information about different system
34051a
devices and file systems.
34051a
34051a
Install the @file{webalizer} RPM if you want to use a Web server log
34051a
file analysis program.
671838
@end table
34051a
671838
@table @key
671838
@item key
34051a
34051a
A key on the keyboard is shown in this style. For example:
34051a
34051a
To use @key{TAB} completion to list particular files in a directory,
34051a
type @command{ls}, then a character, and finally the Tab key. Your
34051a
terminal displays the list of files in the working directory that
34051a
begin with that character.  key-combination
34051a
34051a
A combination of keystrokes is represented in this way. For example:
34051a
34051a
The @key{Ctrl-Alt-Backspace} key combination exits your graphical
34051a
session and returns you to the graphical login screen or the console.
671838
@end table
2823a2
2823a2
@table @command
2823a2
@item computer output
2823a2
2823a2
Text in this style indicates text displayed to a shell prompt such as
2823a2
error messages and responses to commands. For example:
2823a2
2823a2
The @command{ls} command displays the contents of a directory. For example:
2823a2
2823a2
@verbatim
2823a2
Config                           manual_renameEntry.sh
2823a2
manual_copyEntry.sh              manual_restoreCrossReferences.sh
2823a2
manual_deleteCrossReferences.sh  manual_searchIndex.sh
2823a2
@end verbatim
2823a2
2823a2
The output returned in response to the command (in this case, the
2823a2
contents of the directory) is shown in this style.
2823a2
@end table
f646a9
f646a9
Additionally, we use several different strategies to draw your
f646a9
attention to certain pieces of information. In order of urgency, these
f646a9
items are marked as a note, tip, important, caution, or warning. For
f646a9
example:
f646a9
f646a9
@quotation
f646a9
@strong{Note} Remember that Linux is case sensitive. In other words, a
f646a9
rose is not a ROSE is not a rOsE. 
f646a9
@end quotation
f646a9
f646a9
@quotation
f646a9
@strong{Tip} The directory @file{/usr/share/doc/} contains additional
f646a9
documentation for packages installed on your system. 
f646a9
@end quotation
f646a9
f646a9
@quotation
f646a9
@strong{Important} If you modify the DHCP configuration file, the
f646a9
changes do not take effect until you restart the DHCP daemon. 
f646a9
@end quotation
f646a9
f646a9
@quotation
f646a9
@strong{Caution} Do not perform routine tasks as root --- use a regulr
f646a9
user account unless you need to use the root account for system
f646a9
administration tasks.
f646a9
@end quotation
f646a9
f646a9
@quotation
f646a9
@strong{Warning} Be careful to remove only the necessary partitions.
f646a9
Removing other partitions could result in data loss or a corrupted
f646a9
system environment.
f646a9
@end quotation