Linux-Mandrake:
User Guide and
Reference Manual

MandrakeSoft

 
 
January 2000
http://www.linux-mandrake.com


Next : Introduction
Previous : Legal Notice
Up

(Back to the table of contents)

Chapter 2 : Typing Conventions


To help you understand better what is being explained, this document uses different fonts for topics with different interpretations. Some fonts are used for different kinds of objects; either the context will tell you which type of object is being referred to, or the exact distinction is not significant.

Snippets and the like

Note that the size of the font is automatically scaled to best fit the page width in the following environments. Most of the examples in this section use programs invoked from a command line, that is to say a terminal where you type commands. Refer to the corresponding chapter for more information on how to get a terminal.

An example of a snippet

# Snippets are presented like this.
# A snippet is an interaction in a
#   terminal between the user and
#   the computer.
# Lines beginning with a "sharp"
#    sign like this one are comments.
# Lines beginning with a "dollar" sign
#    ($) are commands you should type,
#    either as yourself or as root
#    (read the context to know that).
# Lines ending with a "backslash" (\)
#    are lines that continue on the
#    next line. Some programs support
#    this syntax.
# Other lines are the computer messages
$ file /dev/null
/dev/null: character special (1/3)
$ echo Hello \
  World
Hello World
$ echo Hello World
Hello World

An example of a literal excerpt

# Literal portions of configuration files
#   are displayed like this. Often, lines
#   beginning with a "sharp" (#) sign are
#   comments.
# assign a value to the FOO variable
FOO="My value"

An example of the syntax of a command

command <non literal argument> [optional argument ...]

It is very important to understand how to interpret the special signs in syntaxes.

The "greater than" and "less than" signs denote an argument not to be copied verbatim, but to interpret before you do so. For example, <filename> refers to the actual name of the file. If this name is foo.txt, you should type foo.txt, and not <foo.txt> or <filename>.

The square brackets denote optional arguments, which you may or may not include in the command.

The continuation points mean that an arbitrary number of items can be included there.

The syntax used in these pages is representative of syntax you will see in the synopsis of the system's manual pages.

An example of user input

Material you should type literally is displayed like this.

An example of computer output

Messages the computer spits are displayed like this.

Special fonts

This manual uses a number of different fonts (which can sometimes be combined) to help you distinguish the semantics or nature of the words used. They will appear in the following manner:

Miscellaneous

Note: remarks to take into account are presented this way.
Warning: important remarks are displayed like this.

Tools used in the making of this manual

This manual was typeset with LaTeX. Perl and GNU Make were used to manage the set of files involved. Pictures have been shot with xwd and converted with convert (from the ImageMagick package). PostScript files were produced with dvips. All of these pieces of software are available on your Linux-Mandrake distribution, and all are free software.


Next : Introduction
Previous : Legal Notice
Up

Copyright © 2000 MandrakeSoft