code:
@c The GNU Free Documentation License.
@center Version 1.3, 3 November 2008

@c This file is intended to be included within another document,
@c hence no sectioning command or @node.

@display
Copyright @copyright{} 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.
@uref{http://fsf.org/}

Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
@end display

@enumerate 0
@item
PREAMBLE

The purpose of this License is to make a manual, textbook, or other
functional and useful document @dfn{free} in the sense of freedom: to
assure everyone the effective freedom to copy and redistribute it,
with or without modifying it, either commercially or noncommercially.
Secondarily, this License preserves for the author and publisher a way
to get credit for their work, while not being considered responsible
for modifications made by others.

This License is a kind of ``copyleft'', which means that derivative
works of the document must themselves be free in the same sense.  It
complements the GNU General Public License, which is a copyleft
license designed for free software.

We have designed this License in order to use it for manuals for free
software, because free software needs free documentation: a free
program should come with manuals providing the same freedoms that the
software does.  But this License is not limited to software manuals;
it can be used for any textual work, regardless of subject matter or
whether it is published as a printed book.  We recommend this License
principally for works whose purpose is instruction or reference.

@item
APPLICABILITY AND DEFINITIONS

This License applies to any manual or other work, in any medium, that
contains a notice placed by the copyright holder saying it can be
distributed under the terms of this License.  Such a notice grants a
world-wide, royalty-free license, unlimited in duration, to use that
work under the conditions stated herein.  The ``Document'', below,
refers to any such manual or work.  Any member of the public is a
licensee, and is addressed as ``you''.  You accept the license if you
copy, modify or distribute the work in a way requiring permission
under copyright law.

A ``Modified Version'' of the Document means any work containing the
Document or a portion of it, either copied verbatim, or with
modifications and/or translated into another language.

A ``Secondary Section'' is a named appendix or a front-matter section
of the Document that deals exclusively with the relationship of the
publishers or authors of the Document to the Document's overall
subject (or to related matters) and contains nothing that could fall
directly within that overall subject.  (Thus, if the Document is in
part a textbook of mathematics, a Secondary Section may not explain
any mathematics.)  The relationship could be a matter of historical
connection with the subject or with related matters, or of legal,
commercial, philosophical, ethical or political position regarding
them.

The ``Invariant Sections'' are certain Secondary Sections whose titles
are designated, as being those of Invariant Sections, in the notice
that says that the Document is released under this License.  If a
section does not fit the above definition of Secondary then it is not
allowed to be designated as Invariant.  The Document may contain zero
Invariant Sections.  If the Document does not identify any Invariant
Sections then there are none.

The ``Cover Texts'' are certain short passages of text that are listed,
as Front-Cover Texts or Back-Cover Texts, in the notice that says that
the Document is released under this License.  A Front-Cover Text may
be at most 5 words, and a Back-Cover Text may be at most 25 words.

A ``Transparent'' copy of the Document means a machine-readable copy,
represented in a format whose specification is available to the
general public, that is suitable for revising the document
straightforwardly with generic text editors or (for images composed of
pixels) generic paint programs or (for drawings) some widely available
drawing editor, and that is suitable for input to text formatters or
for automatic translation to a variety of formats suitable for input
to text formatters.  A copy made in an otherwise Transparent file
format whose markup, or absence of markup, has been arranged to thwart
or discourage subsequent modification by readers is not Transparent.
An image format is not Transparent if used for any substantial amount
of text.  A copy that is not ``Transparent'' is called ``Opaque''.

Examples of suitable formats for Transparent copies include plain
ASCII without markup, Texinfo input format, La@TeX{} input
format, SGML or XML using a publicly available
DTD, and standard-conforming simple HTML,
PostScript or PDF designed for human modification.  Examples
of transparent image formats include PNG, XCF and
JPG@.  Opaque formats include proprietary formats that can be
read and edited only by proprietary word processors, SGML or
XML for which the DTD and/or processing tools are
not generally available, and the machine-generated HTML,
PostScript or PDF produced by some word processors for
output purposes only.

The ``Title Page'' means, for a printed book, the title page itself,
plus such following pages as are needed to hold, legibly, the material
this License requires to appear in the title page.  For works in
formats which do not have any title page as such, ``Title Page'' means
the text near the most prominent appearance of the work's title,
preceding the beginning of the body of the text.

The ``publisher'' means any person or entity that distributes copies
of the Document to the public.

A section ``Entitled XYZ'' means a named subunit of the Document whose
title either is precisely XYZ or contains XYZ in parentheses following
text that translates XYZ in another language.  (Here XYZ stands for a
specific section name mentioned below, such as ``Acknowledgements'',
``Dedications'', ``Endorsements'', or ``History''.)  To ``Preserve the Title''
of such a section when you modify the Document means that it remains a
section ``Entitled XYZ'' according to this definition.

The Document may include Warranty Disclaimers next to the notice which
states that this License applies to the Document.  These Warranty
Disclaimers are considered to be included by reference in this
License, but only as regards disclaiming warranties: any other
implication that these Warranty Disclaimers may have is void and has
no effect on the meaning of this License.

@item
VERBATIM COPYING

You may copy and distribute the Document in any medium, either
commercially or noncommercially, provided that this License, the
copyright notices, and the license notice saying this License applies
to the Document are reproduced in all copies, and that you add no other
conditions whatsoever to those of this License.  You may not use
technical measures to obstruct or control the reading or further
copying of the copies you make or distribute.  However, you may accept
compensation in exchange for copies.  If you distribute a large enough
number of copies you must also follow the conditions in section 3.

You may also lend copies, under the same conditions stated above, and
you may publicly display copies.

@item
COPYING IN QUANTITY

If you publish printed copies (or copies in media that commonly have
printed covers) of the Document, numbering more than 100, and the
Document's license notice requires Cover Texts, you must enclose the
copies in covers that carry, clearly and legibly, all these Cover
Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
the back cover.  Both covers must also clearly and legibly identify
you as the publisher of these copies.  The front cover must present
the full title with all words of the title equally prominent and
visible.  You may add other material on the covers in addition.
Copying with changes limited to the covers, as long as they preserve
the title of the Document and satisfy these conditions, can be treated
as verbatim copying in other respects.

If the required texts for either cover are too voluminous to fit
legibly, you should put the first ones listed (as many as fit
reasonably) on the actual cover, and continue the rest onto adjacent
pages.

If you publish or distribute Opaque copies of the Document numbering
more than 100, you must either include a machine-readable Transparent
copy along with each Opaque copy, or state in or with each Opaque copy
a computer-network location from which the general network-using
public has access to download using public-standard network protocols
a complete Transparent copy of the Document, free of added material.
If you use the latter option, you must take reasonably prudent steps,
when you begin distribution of Opaque copies in quantity, to ensure
that this Transparent copy will remain thus accessible at the stated
location until at least one year after the last time you distribute an
Opaque copy (directly or through your agents or retailers) of that
edition to the public.

It is requested, but not required, that you contact the authors of the
Document well before redistributing any large number of copies, to give
them a chance to provide you with an updated version of the Document.

@item
MODIFICATIONS

You may copy and distribute a Modified Version of the Document under
the conditions of sections 2 and 3 above, provided that you release
the Modified Version under precisely this License, with the Modified
Version filling the role of the Document, thus licensing distribution
and modification of the Modified Version to whoever possesses a copy
of it.  In addition, you must do these things in the Modified Version:

@enumerate A
@item
Use in the Title Page (and on the covers, if any) a title distinct
from that of the Document, and from those of previous versions
(which should, if there were any, be listed in the History section
of the Document).  You may use the same title as a previous version
if the original publisher of that version gives permission.

@item
List on the Title Page, as authors, one or more persons or entities
responsible for authorship of the modifications in the Modified
Version, together with at least five of the principal authors of the
Document (all of its principal authors, if it has fewer than five),
unless they release you from this requirement.

@item
State on the Title page the name of the publisher of the
Modified Version, as the publisher.

@item
Preserve all the copyright notices of the Document.

@item
Add an appropriate copyright notice for your modifications
adjacent to the other copyright notices.

@item
Include, immediately after the copyright notices, a license notice
giving the public permission to use the Modified Version under the
terms of this License, in the form shown in the Addendum below.

@item
Preserve in that license notice the full lists of Invariant Sections
and required Cover Texts given in the Document's license notice.

@item
Include an unaltered copy of this License.

@item
Preserve the section Entitled ``History'', Preserve its Title, and add
to it an item stating at least the title, year, new authors, and
publisher of the Modified Version as given on the Title Page.  If
there is no section Entitled ``History'' in the Document, create one
stating the title, year, authors, and publisher of the Document as
given on its Title Page, then add an item describing the Modified
Version as stated in the previous sentence.

@item
Preserve the network location, if any, given in the Document for
public access to a Transparent copy of the Document, and likewise
the network locations given in the Document for previous versions
it was based on.  These may be placed in the ``History'' section.
You may omit a network location for a work that was published at
least four years before the Document itself, or if the original
publisher of the version it refers to gives permission.

@item
For any section Entitled ``Acknowledgements'' or ``Dedications'', Preserve
the Title of the section, and preserve in the section all the
substance and tone of each of the contributor acknowledgements and/or
dedications given therein.

@item
Preserve all the Invariant Sections of the Document,
unaltered in their text and in their titles.  Section numbers
or the equivalent are not considered part of the section titles.

@item
Delete any section Entitled ``Endorsements''.  Such a section
may not be included in the Modified Version.

@item
Do not retitle any existing section to be Entitled ``Endorsements'' or
to conflict in title with any Invariant Section.

@item
Preserve any Warranty Disclaimers.
@end enumerate

If the Modified Version includes new front-matter sections or
appendices that qualify as Secondary Sections and contain no material
copied from the Document, you may at your option designate some or all
of these sections as invariant.  To do this, add their titles to the
list of Invariant Sections in the Modified Version's license notice.
These titles must be distinct from any other section titles.

You may add a section Entitled ``Endorsements'', provided it contains
nothing but endorsements of your Modified Version by various
parties---for example, statements of peer review or that the text has
been approved by an organization as the authoritative definition of a
standard.

You may add a passage of up to five words as a Front-Cover Text, and a
passage of up to 25 words as a Back-Cover Text, to the end of the list
of Cover Texts in the Modified Version.  Only one passage of
Front-Cover Text and one of Back-Cover Text may be added by (or
through arrangements made by) any one entity.  If the Document already
includes a cover text for the same cover, previously added by you or
by arrangement made by the same entity you are acting on behalf of,
you may not add another; but you may replace the old one, on explicit
permission from the previous publisher that added the old one.

The author(s) and publisher(s) of the Document do not by this License
give permission to use their names for publicity for or to assert or
imply endorsement of any Modified Version.

@item
COMBINING DOCUMENTS

You may combine the Document with other documents released under this
License, under the terms defined in section 4 above for modified
versions, provided that you include in the combination all of the
Invariant Sections of all of the original documents, unmodified, and
list them all as Invariant Sections of your combined work in its
license notice, and that you preserve all their Warranty Disclaimers.

The combined work need only contain one copy of this License, and
multiple identical Invariant Sections may be replaced with a single
copy.  If there are multiple Invariant Sections with the same name but
different contents, make the title of each such section unique by
adding at the end of it, in parentheses, the name of the original
author or publisher of that section if known, or else a unique number.
Make the same adjustment to the section titles in the list of
Invariant Sections in the license notice of the combined work.

In the combination, you must combine any sections Entitled ``History''
in the various original documents, forming one section Entitled
``History''; likewise combine any sections Entitled ``Acknowledgements'',
and any sections Entitled ``Dedications''.  You must delete all
sections Entitled ``Endorsements.''

@item
COLLECTIONS OF DOCUMENTS

You may make a collection consisting of the Document and other documents
released under this License, and replace the individual copies of this
License in the various documents with a single copy that is included in
the collection, provided that you follow the rules of this License for
verbatim copying of each of the documents in all other respects.

You may extract a single document from such a collection, and distribute
it individually under this License, provided you insert a copy of this
License into the extracted document, and follow this License in all
other respects regarding verbatim copying of that document.

@item
AGGREGATION WITH INDEPENDENT WORKS

A compilation of the Document or its derivatives with other separate
and independent documents or works, in or on a volume of a storage or
distribution medium, is called an ``aggregate'' if the copyright
resulting from the compilation is not used to limit the legal rights
of the compilation's users beyond what the individual works permit.
When the Document is included in an aggregate, this License does not
apply to the other works in the aggregate which are not themselves
derivative works of the Document.

If the Cover Text requirement of section 3 is applicable to these
copies of the Document, then if the Document is less than one half of
the entire aggregate, the Document's Cover Texts may be placed on
covers that bracket the Document within the aggregate, or the
electronic equivalent of covers if the Document is in electronic form.
Otherwise they must appear on printed covers that bracket the whole
aggregate.

@item
TRANSLATION

Translation is considered a kind of modification, so you may
distribute translations of the Document under the terms of section 4.
Replacing Invariant Sections with translations requires special
permission from their copyright holders, but you may include
translations of some or all Invariant Sections in addition to the
original versions of these Invariant Sections.  You may include a
translation of this License, and all the license notices in the
Document, and any Warranty Disclaimers, provided that you also include
the original English version of this License and the original versions
of those notices and disclaimers.  In case of a disagreement between
the translation and the original version of this License or a notice
or disclaimer, the original version will prevail.

If a section in the Document is Entitled ``Acknowledgements'',
``Dedications'', or ``History'', the requirement (section 4) to Preserve
its Title (section 1) will typically require changing the actual
title.

@item
TERMINATION

You may not copy, modify, sublicense, or distribute the Document
except as expressly provided under this License.  Any attempt
otherwise to copy, modify, sublicense, or distribute it is void, and
will automatically terminate your rights under this License.

However, if you cease all violation of this License, then your license
from a particular copyright holder is reinstated (a) provisionally,
unless and until the copyright holder explicitly and finally
terminates your license, and (b) permanently, if the copyright holder
fails to notify you of the violation by some reasonable means prior to
60 days after the cessation.

Moreover, your license from a particular copyright holder is
reinstated permanently if the copyright holder notifies you of the
violation by some reasonable means, this is the first time you have
received notice of violation of this License (for any work) from that
copyright holder, and you cure the violation prior to 30 days after
your receipt of the notice.

Termination of your rights under this section does not terminate the
licenses of parties who have received copies or rights from you under
this License.  If your rights have been terminated and not permanently
reinstated, receipt of a copy of some or all of the same material does
not give you any rights to use it.

@item
FUTURE REVISIONS OF THIS LICENSE

The Free Software Foundation may publish new, revised versions
of the GNU Free Documentation License from time to time.  Such new
versions will be similar in spirit to the present version, but may
differ in detail to address new problems or concerns.  See
@uref{http://www.gnu.org/copyleft/}.

Each version of the License is given a distinguishing version number.
If the Document specifies that a particular numbered version of this
License ``or any later version'' applies to it, you have the option of
following the terms and conditions either of that specified version or
of any later version that has been published (not as a draft) by the
Free Software Foundation.  If the Document does not specify a version
number of this License, you may choose any version ever published (not
as a draft) by the Free Software Foundation.  If the Document
specifies that a proxy can decide which future versions of this
License can be used, that proxy's public statement of acceptance of a
version permanently authorizes you to choose that version for the
Document.

@item
RELICENSING

``Massive Multiauthor Collaboration Site'' (or ``MMC Site'') means any
World Wide Web server that publishes copyrightable works and also
provides prominent facilities for anybody to edit those works.  A
public wiki that anybody can edit is an example of such a server.  A
``Massive Multiauthor Collaboration'' (or ``MMC'') contained in the
site means any set of copyrightable works thus published on the MMC
site.

``CC-BY-SA'' means the Creative Commons Attribution-Share Alike 3.0
license published by Creative Commons Corporation, a not-for-profit
corporation with a principal place of business in San Francisco,
California, as well as future copyleft versions of that license
published by that same organization.

``Incorporate'' means to publish or republish a Document, in whole or
in part, as part of another Document.

An MMC is ``eligible for relicensing'' if it is licensed under this
License, and if all works that were first published under this License
somewhere other than this MMC, and subsequently incorporated in whole
or in part into the MMC, (1) had no cover texts or invariant sections,
and (2) were thus incorporated prior to November 1, 2008.

The operator of an MMC Site may republish an MMC contained in the site
under CC-BY-SA on the same site at any time before August 1, 2009,
provided the MMC is eligible for relicensing.

@end enumerate

@page
@heading ADDENDUM: How to use this License for your documents

To use this License in a document you have written, include a copy of
the License in the document and put the following copyright and
license notices just after the title page:

@smallexample
@group
  Copyright (C)  @var{year}  @var{your name}.
  Permission is granted to copy, distribute and/or modify this document
  under the terms of the GNU Free Documentation License, Version 1.3
  or any later version published by the Free Software Foundation;
  with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
  Texts.  A copy of the license is included in the section entitled ``GNU
  Free Documentation License''.
@end group
@end smallexample

If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
replace the ``with@dots{}Texts.''@: line with this:

@smallexample
@group
    with the Invariant Sections being @var{list their titles}, with
    the Front-Cover Texts being @var{list}, and with the Back-Cover Texts
    being @var{list}.
@end group
@end smallexample

If you have Invariant Sections without Cover Texts, or some other
combination of the three, merge those two alternatives to suit the
situation.

If your document contains nontrivial examples of program code, we
recommend releasing these examples in parallel under your choice of
free software license, such as the GNU General Public License,
to permit their use in free software.

@c Local Variables:
@c ispell-local-pdict: "ispell-dict"
@c End:


code:
\input texinfo    @c -*-texinfo-*-
@comment %**start of header
@setfilename info-fr.info
@settitle Info
@syncodeindex fn cp
@syncodeindex vr cp
@syncodeindex ky cp
@comment %**end of header
@comment $Id: info-fr.texi,v 1.3 2005-09-19 12:50:55 karl Exp $
@comment Traduction modifi�e le 17/02/2002 Adrien Rebollo

@documentlanguage fr
@documentencoding ISO-8859-1

@dircategory Syst�me de documentation Texinfo
@direntry
* Info: (info).                 Navigateur de documentation.
@end direntry

@ifinfo
Ce fichier est le manuel d'utilisation de Info, le syst�me GNU de
documentation en ligne, command� par menus.

Copyright (C) 1989, 1992, 1996, 1997, 1998, 1999, 2000, 2001
Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with the Front-Cover texts being ``A GNU
Manual'', and with the Back-Cover Texts as in (a) below.  A copy of the
license is included in the section entitled ``GNU Free Documentation
License'' in the Emacs manual.

(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
this GNU Manual, like GNU software.  Copies published by the Free
Software Foundation raise funds for GNU development.''

This document is part of a collection distributed under the GNU Free
Documentation License.  If you want to distribute this document
separately from the collection, you can do so by adding a copy of the
license to the document, as described in section 6 of the license.

Il est permis de copier, distribuer et/ou modifier ce document selon
les termes de la GNU Free Documentation License, Version 1.2 ou toute
version ult�rieure publi�e par la Free Software @w{Foundation ;} sans
Sections Invariantes, avec la Couverture indiquant @w{� Un} Manuel @w{GNU �},
et avec le Dos de la Couverture comme dans (a) ci-dessous.  Une copie de
la licence est comprise dans la section intitul�e @w{� GNU} Free
Documentation @w{License �} dans le manuel d'Emacs.

(a) Le Dos de Couverture de la FSF @w{est :} @w{� Vous} avez la permission de
copier et modifier ce manuel GNU, comme les logiciels GNU@.  Les copies
�dit�es par la Free Software Foundation permettent de recueillir des
fonds pour le d�veloppement de @w{GNU@. �}

Ce document fait partie d'un ensemble distribu� sous la GNU Free
Documentation License.  Si vous voulez distribuer ce document s�par�ment
de l'ensemble, vous le pouvez � condition d'ajouter une copie de la
licence � ce document, comme indiqu� � la section 6 de la licence.
@end ifinfo

@titlepage
@title Info
@subtitle Le syst�me GNU de documentation hyper-texte en ligne
@author Brian Fox
@author et la communaut� GNU Texinfo
@author Traduit en fran�ais par Adrien Rebollo
@page
@vskip 0pt plus 1filll
Copyright @copyright{} 1989, 1992, 1993, 1996, 1997, 1998, 1999, 2000, 2001
Free Software Foundation, Inc.
@sp 2
�dit� par la Free Software Foundation @*
51 Franklin Street, Fifth Floor @*
Boston, MA 02110-1301, USA.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with the Front-Cover texts being ``A GNU
Manual'', and with the Back-Cover Texts as in (a) below.  A copy of the
license is included in the section entitled ``GNU Free Documentation
License'' in the Emacs manual.

(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
this GNU Manual, like GNU software.  Copies published by the Free
Software Foundation raise funds for GNU development.''

This document is part of a collection distributed under the GNU Free
Documentation License.  If you want to distribute this document
separately from the collection, you can do so by adding a copy of the
license to the document, as described in section 6 of the license.

Il est permis de copier, distribuer et/ou modifier ce document selon
les termes de la GNU Free Documentation License, Version 1.2 ou toute
version ult�rieure publi�e par la Free Software @w{Foundation ;} sans
Sections Invariantes, avec la Couverture indiquant @w{� Un} Manuel @w{GNU �},
et avec le Dos de la Couverture comme dans (a) ci-dessous.  Une copie de
la licence est comprise dans la section intitul�e @w{� GNU} Free
Documentation @w{License �} dans le manuel d'Emacs.

(a) Le Dos de Couverture de la FSF @w{est :} @w{� Vous} avez la permission de
copier et modifier ce manuel GNU, comme les logiciels GNU@.  Les copies
�dit�es par la Free Software Foundation permettent de recueillir des
fonds pour le d�veloppement de @w{GNU@. �}

Ce document fait partie d'un ensemble distribu� sous la GNU Free
Documentation License.  Si vous voulez distribuer ce document s�par�ment
de l'ensemble, vous le pouvez � condition d'ajouter une copie de la
licence � ce document, comme indiqu� � la section 6 de la licence.
@end titlepage

@ifnottex
@node Top, , Pour D�marrer,
@top Info: Une Introduction

Info est un programme pour la lecture de documentation, que vous
utilisez en ce moment-m�me.  Le Projet GNU distribue la plupart de ses
manuels en ligne au format Info, et vous avez donc besoin d'un
programme appel� @dfn{navigateur Info} pour lire les manuels.  Vous
�tes en train d'utiliser un tel programme.

@ifinfo
Si vous ne connaissez pas Info et voulez apprendre � vous en servir,
tapez tout de suite la commande @kbd{h}.  Elle vous conduit � une
s�quence explicative pr�programm�e.

Pour apprendre des commandes avanc�es d'Info, tapez deux fois @kbd{n}.
Vous serez conduit � @cite{Info pour les Experts}, en sautant le
chapitre @w{� Pour} @w{D�marrer �.}
@end ifinfo
@end ifnottex

@menu
* Pour D�marrer::               Commencer � utiliser un navigateur Info.
* Info Avanc�::                 Commandes avanc�es d'Info.
* Cr�er un Fichier Info::       Comment faire votre propre fichier Info.
* Index::                       Un index des sujets, commandes, et variables.
@end menu

@node Pour D�marrer, Info Avanc�, Top, Top
@comment  node-name,  next,  previous,  up
@chapter Pour D�marrer

Cette premi�re partie du manuel d'Info d�crit comment naviguer dans
Info.  La deuxi�me partie du manuel d�crit diff�rentes commandes
avanc�es d'Info, et montre comment �crire un fichier Info, � distinguer
d'un fichier Texinfo.  La troisi�me partie explique bri�vement comment
g�n�rer des fichiers Info � partir de fichiers Texinfo.

@ifnotinfo
Ce manuel est principalement destin� � �tre consult� � partir d'un
ordinateur avec le programme de navigation Info, pour que vous puissiez
essayer les commandes d'Info au fur et � mesure que vous les apprenez.
Il est moins efficace de le lire en version imprim�e ou avec un
navigateur HTML, car vous devez alors croire sur parole que les
commandes d�crites se comportent vraiment comme le dit le manuel.  Dans
tous les cas parcourez donc ce manuel maintenant que vous l'avez sous
les @w{yeux ;} mais essayez aussi de le consulter dans la version en ligne.

@cindex navigateur Info, comment l'invoquer
@cindex entrer dans Info
Il y a deux fa�ons de consulter la version en ligne de ce @w{manuel :}

@enumerate
@item
Tapez @code{info} sur votre ligne de commande shell.  Cette m�thode
utilise un programme autonome destin� uniquement � lire les
fichiers Info.

@item
Tapez @code{emacs} � la ligne de @w{commande ;} puis tapez @kbd{C-h i}
(@kbd{Control-h}, suivi de @kbd{i}).  Cette m�thode utilise le mode Info
du programme Emacs, un �diteur dot� de bien d'autres possibilit�s.
@end enumerate

Dans tous les cas, tapez ensuite @kbd{mInfo} (les lettres seulement),
suivi de @key{ENTR�E} --- la touche @w{� Return �} ou @w{� Entr�e �}.  � ce
moment-l�, vous devriez pouvoir suivre les instructions de ce manuel
tout en les lisant � l'�cran.
@c FIXME! (pesch@cygnus.com, 14 dec 1992)
@c Is it worth worrying about what-if the beginner goes to somebody
@c else's Emacs session, which already has an Info running in the middle
@c of something---in which case these simple instructions won't work?
@end ifnotinfo

@menu
* Aide-Petit-�cran::    D�marrer Info sur un Petit �cran
* Aide::                Comment se servir d'Info
* Aide-P::              Retourner au noeud Pr�c�dent
* Aide-^L::             Les commandes Espace, DEL, B et ^L.
* Aide-M::              Menus
* Aide-RefC::           Suivre des r�f�rences crois�es
* Aide-Int::            Quelques commandes Info de niveau interm�diaire
* Aide-Q::              Quitter Info
@end menu

@node Aide-Petit-�cran
@section D�marrer Info sur un Petit �cran

@ifnotinfo
(Avec Info, vous ne voyez cette section que si votre terminal a un
petit nombre de @w{lignes ;} la plupart des lecteurs la sautent sans la
voir.)
@end ifnotinfo

@cindex petit �cran, se d�placer
Comme l'�cran de votre terminal a un assez petit nombre de lignes, il
faut d�s le d�part vous donner des conseils particuliers.

Si vous voyez le texte @samp{--All----} pr�s du coin inf�rieur droit de
l'�cran, �a signifie que la totalit� du texte que vous regardez tient
sur l'�cran.  Si vous voyez @samp{--Top----} � la place, �a signifie
qu'il y a encore du texte, plus bas, qui ne tient pas.  Pour avancer
dans le texte et lire l'�cran suivant, tapez @key{ESPACE}, la barre
Espace.  Pour remonter, tapez la touche marqu�e @samp{BackSpace} ou
@samp{DEL} (sur certains claviers, cette touche peut �tre marqu�e
@samp{Delete} ou porter une fl�che vers la gauche).

@ifinfo
Voil� 40 lignes inutiles, pour que vous puissiez essayer @key{ESPACE} et
@key{DEL} et voir ce qui se passe.  � la fin il y a des instructions
pour la suite.

@format
C'est la ligne 21
C'est la ligne 22
C'est la ligne 23
C'est la ligne 24
C'est la ligne 25
C'est la ligne 26
C'est la ligne 27
C'est la ligne 28
C'est la ligne 29
C'est la ligne 30
C'est la ligne 31
C'est la ligne 32
C'est la ligne 33
C'est la ligne 34
C'est la ligne 35
C'est la ligne 36
C'est la ligne 37
C'est la ligne 38
C'est la ligne 39
C'est la ligne 40
C'est la ligne 41
C'est la ligne 42
C'est la ligne 43
C'est la ligne 44
C'est la ligne 45
C'est la ligne 46
C'est la ligne 47
C'est la ligne 48
C'est la ligne 49
C'est la ligne 50
C'est la ligne 52
C'est la ligne 53
C'est la ligne 54
C'est la ligne 55
C'est la ligne 56
C'est la ligne 57
C'est la ligne 58
C'est la ligne 59
C'est la ligne 60
@end format

Si vous avez r�ussi � arriver jusqu'ici, revenez au d�but avec
@kbd{DEL} (ou @key{BACKSPACE}), et revenez ici � nouveau, pour bien
ma�triser les touches @samp{Espace} et @samp{BackSpace}.  Tapez
d�sormais un @kbd{n} --- un seul @w{caract�re ;} ne tapez pas les guillemets
ni la touche Entr�e ensuite --- pour acc�der au d�but normal du cours.
@end ifinfo

@node Aide, Aide-P, Aide-Petit-�cran, Pour D�marrer
@comment  node-name,  next,  previous,  up
@section Comment se servir d'Info

Vous �tes en train d'interagir avec le programme Info, destin� � la
lecture de documentation.

@cindex noeud, dans les documents Info
  Vous �tes actuellement en train de consulter un @dfn{Noeud}
d'Information.  Un noeud contient du texte d�crivant un sujet donn� � un
niveau de d�tail donn�.  Le sujet de ce noeud est @w{� Comment} se servir
@w{d'Info �}.  La ligne de mode indique qu'il s'agit du noeud @samp{Aide}
dans le fichier @file{info-fr}.

@cindex en-t�te du noeud d'Info
La premi�re ligne d'un noeud est son @dfn{en-t�te}.  L'en-t�te de ce
noeud (jetez-y un oeil) indique que le noeud @samp{Suivant} celui-ci
est le noeud appel� @samp{Aide-P}.  Une commande avanc� d'Info vous
permet d'aller � n'importe quel noeud dont vous connaissez le nom.  Dans
le navigateur Info autonome, la ligne d'en-t�te affiche aussi les noms
de ce noeud et du fichier info.  Dans Emacs, le ligne d'en-t�te est
affich�e dans une police sp�ciale, et elle reste � l'�cran quand vous
faites d�filer l'affichage.  Les noms de ce noeud et du fichier Info
sont omis de la ligne d'en-t�te par Emacs.

  En plus d'un @samp{Suivant}, un noeud peut avoir un lien
@samp{Pr�c�dent} ou @samp{Parent}, ou les deux.  Comme vous pouvez le
voir, ce noeud n'a aucun de ces deux liens.

@kindex n @r{(mode Info)}
  Il est temps de passer au noeud @samp{Suivant}, appel� @samp{Aide-P}.

@format
>> Tapez @kbd{n} pour vous y rendre.  Ne tapez qu'un seul @w{caract�re ;} ne
   tapez pas les guillemets ni la touche @key{ENTR�E}.
@end format

@noindent
@samp{>>} dans la marge signifie qu'il est vraiment temps d'essayer une
commande.

@format
>> Si vous avez une souris, et si vous avez d�j� essay� de taper
   @kbd{n} pour passer au noeud suivant, cliquez maintenant avec le
   bouton droit sur le lien @samp{Suivant} pour faire la m�me chose @w{� �}
   la @w{souris �}.
@end format

@node Aide-P, Aide-^L, Aide, Pour D�marrer
@comment  node-name,  next,  previous,  up
@section Retourner au noeud Pr�c�dent

@kindex p @r{(mode Info)}
Ce noeud est appel� @samp{Aide-P}.  Le noeud @samp{Pr�c�dent}, comme vous
pouvez le voir, est @samp{Aide}, c'est celui dont vous venez en ayant
utilis� la commande @kbd{n}.  Une autre commande @samp{n} vous am�nerait
maintenant au noeud suivant, @samp{Aide-^L}.  Dans Emacs, @kbd{n} lance
la commande Emacs @code{Info-next}, et @kbd{p} lance @code{Info-prev}.

@format
>> Mais ne tapez pas encore @kbd{n}.  Essayez d'abord la commande
   @kbd{p}, ou cliquez avec la souris sur le lien @samp{Pr�c�dent}, qui
   vous am�ne au noeud @samp{Pr�c�dent}.  Une fois que vous y �tes, vous
   pouvez faire @kbd{n} � nouveau pour revenir ici.
@end format

  Si vous lisez ceci dans Emacs, vous verrez un �l�ment @samp{Info} dans
la barre de menu, pr�s du bord droit.  Un clic de souris sur l'�l�ment
@samp{Info} ouvre un menu de commandes qui comprennent @samp{Suivant} et
@samp{Pr�c�dent} (ainsi que d'autres commandes que vous ne connaissez
pas encore).

  Tout �a vous a sans doute sembl� outrageusement simple, mais ne soyez
@emph{pas} tent� de sauter.  Les choses vont bient�t devenir plus
compliqu�es.  N'essayez pas non plus une nouvelle commande avant qu'on
vous le dise.  Autrement, vous pourriez sauter par inadvertance des
passages importants.

@format
>> Faites maintenant @kbd{n}, ou cliquez avec la souris sur le lien
   @samp{Suivant}, pour aller au noeud @samp{Aide-^L} et continuer le
   manuel.
@end format

@node Aide-^L, Aide-M, Aide-P, Pour D�marrer
@comment  node-name,  next,  previous,  up
@section Les commandes Espace, DEL, B et ^L.

  La ligne de mode de ce noeud vous indique que vous �tes maintenant
au noeud @samp{Aide-^L}, et la ligne d'en-t�te vous dit que @kbd{p} vous
ram�nerait � @samp{Aide-P}.  Le titre du noeud est @w{soulign� ;} il donne le
sujet du noeud (la plupart des noeuds ont des titres).

  C'est un gros noeud qui ne tient pas en entier sur votre �cran.  Pr�s
du coin inf�rieur droit de votre �cran, vous lisez @samp{--Top----} au
lieu de @samp{--All----}, �a vous indique qu'il y a encore du texte,
non visible pour l'instant.
pouvez d�terminer qu'il reste des choses non visibles

@kindex ESPACE @r{(mode Info)}
@kindex DEL @r{(mode Info)}
@kindex BACKSPACE @r{(mode Info)}
@findex Info-scroll-up
@findex Info-scroll-down
  Les touches @key{ESPACE}, @key{BACKSPACE} (ou @key{DEL})@footnote{La
touche que nous appelons @w{� BackSpace �} ou @w{� DEL �} dans ce manuel est
marqu�e diff�remment selon les claviers.  C'est une touche qui est un peu
au dessus de la touche @key{ENTR�E} ou @key{RETURN} et que vous utilisez
normalement (ailleurs que dans Emacs) pour effacer le caract�re
pr�c�dant le curseur, c'est-�-dire le caract�re que vous avez tap� en
dernier.  Elle peut �tre marqu�e @samp{BackSpace} ou @samp{<-} ou
@samp{DEL}, ou parfois @samp{Delete}.} et @kbd{b} vous permettent de
vous d�placer dans un noeud qui ne tient pas tout entier � l'�cran.
@key{ESPACE} fait avancer le texte, pour afficher ce qui �tait en
dessous du bas de l'�cran.  @key{DEL} ou @key{BACKSPACE} le fait reculer,
pour afficher ce qui �tait au dessus du haut de l'�cran (il n'y a rien au
dessus avant que vous n'ayez tap� quelques espaces).  Dans Emacs,
@key{ESPACE} lance la commande @code{Info-scroll-up}, et @key{BACKSPACE}
lance @code{Info-scroll-down}.

@format
>> Essayez maintenant de taper @key{ESPACE} (tapez ensuite
   @key{BACKSPACE} pour revenir ici).
@end format

  Quand vous tapez @key{ESPACE}, les deux lignes qui �taient en bas de
l'�cran apparaissent en haut, suivies par d'autres.  @key{DEL} ou
@key{BACKSPACE} prend les deux lignes d'en haut et les place en bas,
@emph{en g�n�ral}, mais si au dessus il n'y a pas assez de lignes pour
remplir un �cran elles n'iront peut-�tre pas jusqu'en bas.

  Si vous lisez ceci dans Emacs, notez que la ligne d'en-t�te est
toujours visible, et ne d�file pas avec le reste.  De cette fa�on, vous
pouvez toujours voir les liens @samp{Suivant}, @samp{Pr�c�dent} et
@samp{Parent}, et vous pouvez ais�ment suivre l'un de ces liens depuis
n'importe o� dans le noeud en cliquant dessus avec la souris.

@cindex lire les documents Info du d�but � la fin
@cindex documents Info comme tutoriels
  @key{ESPACE} et @key{DEL} ne se contentent pas de vous d�placer
d'avant en arri�re dans le noeud en cours.  Quand ces commandes
rencontrent le d�but ou la fin du noeud en cours, elles vous conduisent
au noeud situ� avant ou apr�s.  Pr�cis�ment, elles font d�filer tous les
noeuds d'un fichier Info � la suite.  Dans cette suite, les sous-noeuds
d'un noeud suivent leur parent.  Si un noeud a un menu, @key{ESPACE} vous
am�ne dans les sous-noeuds �num�r�s dans le menu, un par un.  Une fois
que vous avez atteint la fin d'un noeud, et avez vu tous ses
sous-noeuds, @key{ESPACE} vous am�ne au noeud suivant ou au noeud
suivant du parent.  C'est fait de telle sorte que vous puissiez lire le
manuel tout entier du d�but � la fin en tapant juste @key{ESPACE}.

@kindex PAGEUP @r{(mode Info)}
@kindex PAGEDOWN @r{(mode Info)}
  La plupart des claviers d'aujourd'hui ont deux touches de d�filement
marqu�es @samp{PageUp} et @samp{PageDown} (ou parfois @samp{Prior} et
@samp{Next}, ou encore des fl�ches vers le haut et le bas barr�es de
plusieurs traits).  Si votre clavier poss�de de telles touches, vous
pouvez vous en servir pour vous d�placer d'avant en arri�re dans le
texte, comme avec @key{ESPACE} et @key{BACKSPACE}.  Cependant,
contrairement � @key{ESPACE} et @key{BACKSPACE}, @key{PAGEUP} et
@key{PAGEDOWN} ne feront jamais d�filer le texte au-del� du d�but ou de
la fin du noeud en cours.

@kindex C-l @r{(mode Info)}
  Si votre �cran est pollu�, vous pouvez demander � Info de l'afficher
� nouveau en tapant @kbd{C-l} (@kbd{Control-L}, c'est-�-dire tenir la
touche @key{CTRL} enfonc�e et taper @kbd{L} ou @kbd{l}).

@format
>> Tapez @kbd{C-l} maintenant.
@end format

@kindex b @r{(mode Info)}
  Pour revenir au d�but du noeud en cours, vous pouvez taper un tas de
touches @key{BACKSPACE}.  Vous pouvez aussi taper simplement @kbd{b}
(@kbd{b} pour @w{� beginning � :} d�but).

@format
>> Essayez tout de suite.  (Nous en avons �crit assez pour que ces
   lignes se situent apr�s le premier �cran, mais les �crans
   deviennent si grands que ce n'est peut-�tre pas assez.  Vous aurez
   peut-�tre � rapetisser votre fen�tre Emacs ou Info.)  Revenez
   ensuite, avec des @key{ESPACE}s.
@end format

  Si votre �cran est tr�s grand, ce noeud y tient peut-�tre tout
entier.  Dans ce cas, @kbd{b} ne fera rien.  @w{D�sol� ;} nous n'y pouvons
rien.

@kindex ? @r{(mode Info)}
@findex Info-summary
  Vous venez d'apprendre un grand nombre de commandes.  Si vous voulez
en utiliser une mais avez du mal � vous rappeler laquelle, vous devez
taper @kbd{?} (dans Emacs �a lance la commande @code{Info-summary}) qui
affiche une br�ve liste de commandes.  Quand vous aurez fini de
consulter la liste, faites-la dispara�tre en tapant @key{ESPACE} de
fa�on r�p�t�e.

@format
>> Tapez @key{?} maintenant.  Tapez @key{ESPACE} pour voir la liste se
   d�rouler jusqu'� la fin.  Puis tapez @key{ESPACE} plusieurs fois,
   jusqu'� ce qu'elle s'en aille.
@end format

  (Si vous utilisez le navigateur Info autonome, tapez @kbd{C-x 0} pour
revenir ici, c'est-�-dire maintenez la touche @key{CTRL} appuy�e, tapez
un @kbd{x}, puis rel�chez @key{CTRL} et @kbd{x}, et tapez @kbd{0} -- un
z�ro, pas la lettre @w{� o �}.)

  D�sormais, vous allez rencontrer de grands noeuds sans qu'on vous
pr�vienne, et l'on attend de vous que vous puissiez utiliser les
touches @key{ESPACE} et @key{BACKSPACE} pour vous d�placer dedans sans
qu'on vous le dise.  Comme tous les terminaux n'ont pas la m�me taille
d'�cran, ce serait de toutes fa�ons impossible de vous pr�venir.

@format
>> Tapez maintenant @kbd{n}, ou cliquez avec la souris sur le lien
   @samp{Suivant}, pour voir la description de la commande @kbd{m}.
@end format

@node Aide-M, Aide-RefC, Aide-^L, Pour D�marrer
@comment  node-name,  next,  previous,  up
@section Les menus et la commande @kbd{m}

@cindex menus dans un document Info
@cindex menus d'Info
  Avec les seules commandes @kbd{n} (suivant) et @kbd{p} (pr�c�dent)
pour se d�placer entre les noeuds, ceux-ci seraient contraints de se suivre
lin�airement.  Les menus permettent d'avoir une structure de branchement.
Un menu est une liste de noeuds auxquels vous pouvez vous rendre.  C'est
en fait juste un morceau de texte format� sp�cialement pour qu'Info
puisse l'interpr�ter.  Un menu d�bute toujours par une ligne commen�ant
par @samp{* Menu:}.  Un noeud contient un menu si et seulement s'il
contient une ligne qui commence ainsi.  � chaque instant le seul menu
auquel vous avez acc�s est celui du noeud dans lequel vous vous trouvez.
Pour acc�der � un menu situ� dans un autre noeud, vous devez d'abord
aller dans celui-ci.

  Apr�s le d�but du menu, chaque ligne commen�ant par une @samp{*}
d�signe un �l�ment.  La ligne contient habituellement un nom succinct
pour l'�l�ment (suivi par un @samp{:}), le nom du noeud traitant ce
sujet, et �ventuellement une description plus pr�cise du sujet.  Les
lignes du menu qui ne commencent pas par une @samp{*} n'ont pas de sens
particulier --- elles sont seulement destin�es au lecteur et ne
d�finissent pas d'autre �l�ment.  Voici un @w{exemple :}

@example
* Machin:  Noeud au sujet de MACHIN        �a parle de MACHIN
@end example

Le nom de l'�l�ment est Machin, et le noeud en question est @samp{Noeud
au sujet de MACHIN}.  Le reste de la ligne n'est destin�e qu'au lecteur.
[[ Mais cette ligne n'est pas un v�ritable �l�ment de menu, car il n'y a
pas au dessus de ligne commen�ant par @samp{* Menu:}.]]

  Quand vous utilisez un menu pour vous rendre dans un autre noeud
(nous allons d�crire bient�t comment faire), vous sp�cifiez le nom de
l'�l�ment, la premi�re partie de la ligne du menu.  Info s'en sert pour
trouver la ligne dans le menu, en d�duire le nom du noeud, et aller � ce
noeud.  Il y a � la fois un nom d'�l�ment et un nom de noeud parce que
le nom de noeud doit �tre signifiant pour l'ordinateur et qu'il peut
donc �tre assez moche.  Le nom d'�l�ment peut �tre choisi simplement
pour l'utilisateur.  Souvent le nom de noeud convient aussi �
l'utilisateur et le nom de noeud et le nom d'�l�ment sont les m�mes.
Dans ce cas-l� on emploie cette @w{abr�viation :}

@example
* Machin::   �a parle de MACHIN
@end example

@noindent
�a signifie que le nom d'�l�ment et le nom de noeud sont les @w{m�mes ;} ils
sont tous deux @samp{Machin}.

@format
>> Trouvez maintenant le menu dans ce noeud avec @key{ESPACE}, puis
   revenez ici avec @kbd{b} et quelques @key{ESPACE}s.  Comme vous le
   voyez, il y a bien un menu visible dans ce noeud.  Si vous ne trouvez
   pas de menu en parcourant un noeud, c'est qu'il n'y en a pas et la
   commande @kbd{m} n'est alors pas disponible.
@end format

@kindex m @r{(mode Info)}
  La commande pour se rendre dans un des sous-noeuds est @kbd{m} ---
mais @emph{n'essayez pas @w{encore !}}  Avant d'utiliser @kbd{m}, vous devez
savoir que certaines commandes attendent des informations
suppl�mentaires.  Jusqu'� maintenant, vous avez appris plusieurs
commandes qui ne r�clamaient pas d'information @w{suppl�mentaire ;} quand
vous en tapiez une, Info la traitait instantan�ment et �tait ensuite
pr�t � en recevoir d'autres.  La commande @kbd{m} se comporte
@w{diff�remment :} elle est incompl�te sans le @dfn{nom de l'�l�ment}.  Une
fois que vous avez tap� @kbd{m}, Info essaye de lire le nom de
l'�l�ment.

  Cherchez maintenant une ligne proche du bas de l'�cran et contenant de
nombreux tirets.  Il y a une autre ligne en dessous, qui est
habituellement vide.  Si elle est vide, Info est pr�t � recevoir une
commande, comme @kbd{n} ou @kbd{b} ou @key{ESPACE} ou @kbd{m}.  Si cette
ligne contient du texte se terminant par deux points @samp{:}, �a signifie
qu'Info essaye de lire plus d'informations pour la derni�re commande.  �
ces moments-l�, les commandes ne fonctionnent pas, parce qu'Info tente
de s'en servir pour constituer cette information suppl�mentaire.  Vous
devez soit taper votre r�ponse et terminer la commande que vous avez
commenc�e, soit taper @kbd{Control-g} pour annuler la commande.  Une
fois que c'est fait, la ligne redevient vide.

@findex Info-menu
  La commande pour aller � un sous-noeud par un menu est @kbd{m}.  Apr�s
que vous avez tap� @kbd{m}, la ligne en bas de l'�cran vous dit
@samp{�l�ment de menu: }.  Vous devez alors taper le nom de l'�l�ment
que vous voulez, et terminer avec @key{ENTR�E}.  Dans Emacs, @kbd{m}
lance la commande @code{Info-menu}.

@cindex abr�vier des sous-noeuds d'Info
  Vous pouvez abr�vier le nom de l'�l�ment.  Si l'abr�viation n'est pas
unique, Info choisit le premier �l�ment qui convient.  Certains menus
mettent en majuscules la fa�on la plus courte possible d'abr�vier chaque
nom d'�l�ment, pour que vous puissiez voir ce qu'il vous faut taper.
Peu importe si vous tapez le nom d'�l�ment en majuscules ou en
minuscules.  Vous ne devez pas ajouter d'espace � la fin, ou dans le nom
d'�l�ment, sauf quand il y a d�j� une espace dans l'�l�ment du menu.

@cindex compl�tion des noms de noeuds d'Info
  Vous pouvez aussi utiliser la @dfn{compl�tion} pour vous aider �
entrer le nom d'�l�ment.  Si vous tapez la touche @key{TAB} apr�s avoir
entr� une partie du nom, elle trouvera toute seule le reste --- autant
qu'il lui est possible de mani�re unique � partir de ce que vous avez
d�j� entr�.

  Si vous d�placez le curseur dans l'une des lignes du menu, vous n'avez
alors pas besoin de @w{param�tre :} vous tapez juste @key{ENTR�E}, et
l'�l�ment correspondant � la ligne o� vous vous situez est s�lectionn�.

Voici un menu pour vous donner l'occasion de vous exercer.  Ce menu vous
donne trois fa�ons d'aller � un m�me endroit, @w{Aide-MACHIN :}

@menu
* Machin:  Aide-MACHIN.    � visiter pous vous amuser.
* Truc:    Aide-MACHIN.    @w{�trange !} 2 fa�ons d'aller au m�me endroit.
* Aide-MACHIN::            Et une fa�on de @w{plus !}
@end menu

@format
>>  Maintenant tapez @kbd{m} et voyez ce qui se @w{passe :}
@end format

  Vous �tes maintenant @w{� dans �} une commande @kbd{m}.  Ici, les commandes
ne fonctionnent @w{pas ;} la prochaine chose � tapez doit �tre le nom d'un
�l�ment.

  Vous pouvez revenir sur votre d�cision en tapant @kbd{Control-g}, qui
annule la commande @kbd{m}.

@format
>> Essayez @w{maintenant ;} notez la ligne inf�rieure vide.
@end format

@format
>> Puis retapez @kbd{m}.
@end format

@format
>> Tapez maintenant @kbd{TRUC}, le nom de l'�l�ment.  Ne tapez pas encore
   @key{ENTR�E}.
@end format

  Pendant que vous tapez le nom de l'�l�ment, vous pouvez utiliser la
touche @key{DEL} (ou @key{BACKSPACE}) pour effacer un caract�re � la
fois si vous avez fait une erreur.

@format
>> Tapez @key{DEL} pour effacer le @samp{C}.  Vous pouvez taper un autre
   @kbd{C} pour le remplacer.  Mais vous n'en avez pas besoin, car
   @samp{TRU} est une abr�viation valide.
@end format

@format
>> Vous �tes maintenant pr�t � y aller.  Tapez @key{ENTR�E}.
@end format

  Apr�s avoir visit� @samp{Aide-MACHIN}, vous devez revenir ici.

  Une autre fa�on d'aller dans les lignes du menu et de vous d�placer
parmi elles est de taper @key{TAB}.  � chaque fois que vous tapez un
@key{TAB}, vous vous rendez dans la ligne de l'�l�ment suivant.  Pour
aller dans une ligne d'�lement pr�c�dente, tapez @kbd{M-@key{TAB}} ---
c'est-�-dire, maintenez la touche @key{META} enfonc�e et tapez alors
@key{TAB}.  (Sur certains claviers, la touche @key{META} peut s'appeler
@samp{Alt}.)

  Une fois que vous avez d�plac� le curseur dans une ligne d'�l�ment,
tapez @key{ENTR�E} pour aller au noeud correspondant.

@cindex souris en mode Info
@kindex Souris-2 @r{(mode Info)}
  Si votre terminal g�re la souris, vous avez encore une autre
fa�on d'aller � un �l�ment.  D�placez votre pointeur de souris sur la
ligne de l'�l�ment, quelque part entre le @samp{*} initial et les deux
points @samp{:} apr�s le nom de l'�l�ment.  Vous verrez que le nom de
l'�l�ment change d'apparence (en g�n�ral, sa couleur de fond change),
ainsi que le pointeur de la souris, si votre plate-forme le permet.  Au
bout d'un moment, si vous laissez la souris � cet endroit, une
indication appara�t vous disant @w{� Souris-2 :} aller � ce @w{noeud �}.  (Si
ces indications sont d�sactiv�es ou indisponibles, ce message appara�t
dans la @dfn{zone de dialogue}, la ligne en bas de l'�cran o� vous tapez
le nom des �l�ments de menu quand c'est n�cessaire.)  @kbd{Souris-2} est
le deuxi�me bouton � partir de la gauche sur votre souris --- celui de
droite pour les souris � deux boutons, celui du milieu pour celles � 3
boutons.  Donc quand vous pressez @kbd{Souris-2} quand le pointeur de la
souris est sur un �l�ment de menu, vous allez dans cet �l�ment.

@findex Info-mouse-follow-nearest-node
  D'une mani�re g�n�rale, @kbd{Souris-2} dans un tampon Info lance la
commande Emacs @code{Info-mouse-follow-nearest-node}, qui trouve le plus
proche lien vers un autre noeud et s'y rend.  Par exemple, pr�s d'une
r�f�rence crois�e il se comporte comme @kbd{f}, dans un menu comme
@kbd{m}, sur la ligne d'en-t�te du noeud comme @kbd{n}, @kbd{p} ou
@kbd{u}, etc.  � la fin du texte du noeud @kbd{Souris-2} va dans le noeud
suivant, ou parent s'il n'y a pas de noeud suivant.

  Voici donc un autre moyen de vous rendre dans Aide-MACHIN, un menu.
Vous pouvez l'ignorer si vous voulez, ou bien l'essayer en tapant
@key{TAB} puis @key{ENTR�E}, ou en cliquant @kbd{Souris-2} dessus (mais
revenez ensuite ici s'il vous pla�t).

@menu
* Aide-MACHIN::
@end menu

@format
>> Tapez @kbd{n} pour voir d'autres commandes.
@end format

@node Aide-MACHIN,  ,  , Aide-M
@subsection La commande @kbd{u}

  @w{F�licitations !} Vous �tes dans le noeud @samp{Aide-MACHIN}.  Il a un
pointeur @samp{Parent} @samp{Aide-M}, le noeud dont vous provenez par la
commande @kbd{m}.  C'est la convention habituelle --- les noeuds que vous
atteignez par un menu ont des liens @samp{Parent} ramenant au menu.  Les
menus font descendre dans l'arborescence, et @samp{Parent} fait remonter.
@samp{Pr�c�dent}, de son c�t�, sert habituellement � @w{� rester} au m�me
niveau tout en revenant en @w{arri�re �}.

@kindex u @r{(mode Info)}
@findex Info-up
  Vous pouvez retourner au noeud @samp{Aide-M} en tapant la commande
@kbd{u} pour @w{� Parent �} (@w{� Up �} en anglais) (la commande Emacs lanc�e par
@kbd{u} est @code{Info-up}).  �a vous am�ne au @emph{d�but} du
noeud --- pour revenir l� o� vous �tiez vous devez taper quelques
@key{ESPACE}s.  (Quelques navigateurs Info, comme celui inclus dans
Emacs, vous ram�nent � l'endroit o� vous �tiez dans @samp{Aide-M}.)

  Une autre fa�on de remonter est de cliquer sur le lien @samp{Parent}
affich� dans la ligne d'en-t�te (pourvu que vous ayez une souris).

@format
>> Tapez maintenant @kbd{u} pour revenir � @samp{Aide-M}.
@end format

@node Aide-RefC, Aide-Int, Aide-M, Pour D�marrer
@comment  node-name,  next,  previous,  up
@section Suivre des R�f�rences Crois�es

@cindex r�f�rences crois�es dans les documents Info
  Dans la documentation Info, vous verrez beaucoup de
@dfn{r�f�rences crois�es}.  Les r�f�rences crois�es ressemblent �
@w{�a :} @xref{Aide-Crois�e, Crois�e}.  C'est une vraie r�f�rence
crois�e, en chair et en os, appel�e @samp{Crois�e} et qui pointe
sur le noeud appel� @samp{Aide-Crois�e}.

@kindex f @r{(mode Info)}
@findex Info-follow-reference
  Il y a deux fa�ons de suivre une r�f�rence crois�e.  Vous pouvez y
amener le curseur et presser @key{Entr�e}, comme pour un menu.
@key{Entr�e} suit la r�f�rence crois�e sur laquelle se trouve le
curseur.  Vous pouvez aussi taper @kbd{f} et ensuite indiquer le nom
de la r�f�rence crois�e (ici, @samp{Crois�e}) comme param�tre.  Dans
Emacs Indo, @kbd{f} lance @code{Info-follow-reference}.

  Avec la commande @kbd{f}, vous d�signez la r�f�rence crois�e par son
nom, de sorte que la position de curseur n'importe pas.  Si le curseur
est sur ou pr�s d'une r�f�rence crois�e, @kbd{f} vous sugg�re le nom de
cette r�f�rence entre parenth�ses comme valeur par @w{d�faut ;} en
tapant @key{Entr�e} vous suivrez cette r�f�rence.  Cependant, si vous
tapez un autre nom de r�f�rence crois�e, @kbd{f} suivra cette derni�re.

@format
>> Tapez @kbd{f}, suivi de @kbd{Crois�e}, puis @key{ENTR�E}.
@end format

  Quand vous tapez le nom de la r�f�rence, vous
pouvez utiliser la touche @key{DEL} (ou @key{BACKSPACE}) pour �diter ce
que vous entrez.  Si vous changez d'avis et ne voulez plus suivre de
r�f�rence, vous pouvez faire @kbd{Control-g} pour annuler la commande.
La compl�tion est disponible dans la commande @w{@kbd{f} ;} vous obtenez
la compl�tion parmi tous les noms de r�f�rence crois�e du noeud en cours
en tapant la touche @key{TAB}.

  Pour obtenir une liste de toutes les r�f�rences crois�es du noeud en
cours, vous pouvez taper @kbd{?} apr�s @kbd{f}.  Le @kbd{f} continue �
attendre le nom d'une r�f�rence crois�e m�me apr�s avoir affich� la
liste, donc si vous ne voulez pas suivre une r�f�rence, vous devez taper
@kbd{Control-g} pour annuler le @kbd{f}.

@format
>> Tapez @kbd{f?} pour obtenir la liste des r�f�rences crois�es de ce
   noeud.  Puis tapez @kbd{Control-g} et voyez comment le @samp{f} est
   annul�.
@end format

  Les touches @key{TAB} et @kbd{M-@key{TAB}}, qui permettent de se
d�placer parmi les �l�ments d'un menu, permettent �galement de se
d�placer parmi des r�f�rences crois�es � l'ext�rieur des menus.

@node Aide-Int, Aide-Q, Aide-RefC, Pour D�marrer
@comment  node-name,  next,  previous,  up
@section Quelques commandes Info de niveau interm�diaire

  Le cours d'introduction est presque @w{termin� ;} restez donc un peu
avec nous pour apprendre quelques commandes de niveau interm�diaire.

  La plupart des fichiers Info poss�dent un index, qui est en fait un
grand noeud qui ne contient rien d'autre qu'un menu.  Ce menu a un
�l�ment pour chaque sujet r�pertori� dans l'index.  Vous pouvez acc�der
au noeud index � partir du noeud principal du fichier, avec la commande
@w{@kbd{m} ;} puis vous pouvez � nouveau utiliser le commande @kbd{m}
dans le noeud d'index pour vous rendre dans le noeud qui d�crit le sujet
que vous cherchez.

  Il y a aussi un raccourci dans Info, la commande @kbd{i}, qui fait
tout cela pour vous.  Il recherche dans l'index un sujet donn� (une
cha�ne de caract�res) et va dans le noeud qui est indiqu� dans l'index
pour ce sujet.  @xref{Recherche Info}, pour une explication d�taill�e.

@kindex l @r{(mode Info)}
@findex Info-last
@cindex retourner en arri�re en mode Info
  Si vous vous �tes d�plac�s dans diff�rents noeuds et voulez revenir
sur vos pas, vous pouvez utiliser la commande @kbd{l} (@kbd{l} pour
@dfn{dernier}, last en anglais), qui revient en arri�re un noeud � la
fois.  Au fur et � mesure que vous vous d�placez dans les noeuds, Info
m�morise les noeuds o� vous vous �tes rendus dans un historique sp�cial.
La commande @kbd{l} revisite les noeuds dans l'ordre de @w{l'historique ;}
chaque commande @kbd{l} successive remonte d'un cran dans cet
historique.

  Si vous avez suivi les instructions, une commande @kbd{l} devrait vous
ramener � @samp{Aide-M}.  Une autre commande @kbd{l} devrait annuler le
@kbd{u} et vous ramener � @samp{Aide-MACHIN}.  Encore un autre @kbd{l}
devrait annuler le @kbd{m} et vous ramener � @samp{Aide-M}.

  Dans Emacs, @kbd{l} lance la commande @code{Info-last}.

@format
>> Essayez de taper trois fois @kbd{l}, en vous arr�tant � chaque fois
   pour voir ce que fait chacun d'entre eux.  Puis suivez les
   instructions � nouveau et vous aboutirez ici.
@end format

  Notez la diff�rence entre @kbd{l} et @w{@kbd{p} :} @kbd{l} vous am�ne l�
o� @emph{vous} �tiez en dernier, tandis que @kbd{p} vous d�place
toujours dans le noeud d�clar� dans l'en-t�te comme @samp{Pr�c�dent} (�
partir de ce noeud-ci, le lien @samp{Pr�c�dent} m�ne � @samp{Aide-M}).

@kindex d @r{(mode Info)}
@findex Info-directory
@cindex aller au noeud R�pertoire
  La commande @kbd{d} (@code{Info-directory} dans Emacs) vous conduit
instantan�ment au noeud R�pertoire.  Ce noeud, qui est le premier que
vous voyez en entrant dans Info, a un menu qui m�ne (directement ou
indirectement, � travers d'autres menus), � tous les noeuds existants.
Le noeud R�pertoire donne la liste de tous les manuels et autres
documents Info qui sont, ou pourraient �tre install�s sur votre syst�me.

@format
>> Essayez de faire @kbd{d}, puis @kbd{l} pour revenir ici
   (@emph{revenez} s'il vous pla�t).
@end format

@kindex t @r{(mode Info)}
@findex Info-top-node
@cindex aller au noeud Top
  La commande @kbd{t} vous conduit au noeud @samp{Top} du manuel.  C'est
utile si vous voulez naviguer dans le menu principal, ou s�lectionner un
�l�ment donn� de ce menu.  La commande Emacs lanc�e par @kbd{t} est
@code{Info-top-node}.

  Cliquer @kbd{Souris-2} sur ou pr�s d'une r�f�rence crois�e permet
�galement de suivre la r�f�rence.  Vous pouvez voir que la r�f�rence
crois�e est sensible � la souris en d�pla�ant le pointeur de souris sur
la r�f�rence et en observant comment se modifient le texte d�sign� ainsi
que le pointeur de souris.

@format
>> Tapez maintenant @kbd{n} pour voir le dernier noeud du cours.
@end format

  @xref{Info Avanc�}, pour des fonctions plus avanc�es d'Info.

@c If a menu appears at the end of this node, remove it.
@c It is an accident of the menu updating command.

@node Info Avanc�
@chapter Info pour les Experts

  Ce chapitre d�crit diverses commandes avanc�es d'Info.  (Si vous
utilisez un navigateur Info autonome, il y a des commandes
suppl�mentaires qui lui sont sp�cifiques, et qui sont document�es dans
diff�rents chapitres de @ref{Top,, GNU Info, info-stnd, GNU Info}.)

  Ce chapitre explique aussi comment �crire une fichier Info, �
distinguer d'un fichier Texinfo.  (Cependant, dans la plupart des cas,
�crire un fichier Texinfo est une meilleure solution, puisque vous
pouvez l'utiliser @emph{� la fois} pour g�n�rer un fichier Info et pour
r�aliser un manuel imprim�.  @xref{Top,, Overview of Texinfo, texinfo,
Texinfo: The GNU Documentation Format}.)

@menu
* Expert::                  Commandes avanc�es @w{d'Info :} g, s, e et 1-5.
* Recherche Info::          Comment rechercher des sujets
                               dans des documents Info.
* Ajouter::                 Comment ajouter de nouveaux noeuds
                               dans la hi�rarchie.
                               D�crit aussi � quoi ressemblent les noeuds.
* Menus::                   Comment ajouter ou cr�er des menus dans les noeuds.
* R�f�rences Crois�es::     Comment ajouter des r�f�rences crois�es
                               dans les noeuds.
* Balises::                 Comment faire des tableaux de balises pour
                               les fichiers Info.
* V�rification::            V�rifier un Fichier Info.
* Variables Info Emacs::    Variables modifiant le comportement d'Emacs Info.
@end menu

@node Expert, Recherche Info,  , Info Avanc�
@comment  node-name,  next,  previous,  up
@section Commandes Avanc�es d'Info

Voici quelques commandes Info suppl�mentaires qui vous permettent de
naviguer plus facilement.

@unnumberedsubsec @kbd{g} va dans un noeud d�sign� par son nom

@kindex g @r{(mode Info)}
@findex Info-goto-node
@cindex aller � un noeud avec son nom
  Si vous connaissez le nom d'un noeud, vous pouvez vous y rendre en
tapant @kbd{g}, le nom, et @key{ENTR�E}.  Ainsi, @kbd{gTop@key{ENTR�E}}
vous am�ne au noeud appel� @samp{Top} dans ce fichier.  (C'est �quivalent
� @kbd{t}, voir @ref{Aide-Int}.)  @kbd{gExpert@key{ENTR�E}} vous
ram�nerait ici.  @kbd{g} dans Emacs lance la commande
@code{Info-goto-node}.

  Contrairement � @kbd{m}, @kbd{g} ne permet pas d'utiliser des
abr�viations.  Mais il autorise la compl�tion, et vous pouvez donc taper
@key{TAB} pour compl�ter un nom de noeud partiel.

@cindex aller dans un autre fichier Info
  Pour aller dans un noeud d'un autre fichier, vous pouvez inclure le
nom du fichier dans le nom du noeud en le mettant devant, entre
parenth�ses.  Ainsi, @kbd{g(dir)Top@key{ENTR�E}} vous enverrait dans le
noeud R�pertoire Info, qui est le noeud @samp{Top} dans le fichier Info
@file{dir}.  De la m�me mani�re, @kbd{g(emacs)Top@key{ENTR�E}} vous am�ne
au noeud sommet du manuel d'Emacs.

  Le nom de noeud @samp{*} d�signe le fichier tout entier.  Vous pouvez
donc regarder tout le fichier en cours en tapant @kbd{g*@key{ENTR�E}} ou
l'int�gralit� d'un autre fichier avec
@kbd{g(@var{nom_fichier})@key{ENTR�E}}.

@unnumberedsubsec @kbd{1}--@kbd{9} s�lectionne un �l�ment de menu par son num�ro

@kindex 1 @r{�} 9 @r{(mode Info)}
@findex Info-nth-menu-item
@cindex s�lectionner le @var{n}i�me �l�ment de menu
  Si vous aimez �conomiser le moindre caract�re frapp�, vous allez aimer
les commandes @kbd{1}, @kbd{2}, @kbd{3}, @kbd{4}, @dots{}, @kbd{9}.  Ce
sont des raccourcis pour la commande @kbd{m} avec le nom d'un �l�ment de
menu.  @kbd{1} va au premier �l�ment de menu du noeud en @w{cours ;} @kbd{2}
va au deuxi�me, etc.  Dans le navigateur autonome, @kbd{0} va
au dernier �l�ment de @w{menu ;} c'est pour que vous n'ayez pas � compter
combien d'entr�es il y a.  Dans Emacs, les touches num�riques lancent la
commande @code{Info-nth-menu-item}.

  Si votre affichage supporte des polices diff�rentes, et que vous
utilisez le mode Info d'Emacs pour lire des fichiers Info, l'�toile
@samp{*} du cinqui�me �l�ment de menu ressort, soit en couleur soit par
une autre caract�ristique, et de m�me pour l'�toile @samp{*} du neuvi�me
@w{�l�ment ;} il est ainsi plus facile de voir d'un coup d'oeil le num�ro �
utiliser pour un �l�ment.

  Certains terminaux ne supportent pas les couleurs ou le soulignement.
Si vous avez besoin de compter les �l�ments, il est pr�f�rable
d'utiliser la commande @kbd{m} � la place, et d'indiquer le nom, ou
d'utiliser @key{TAB} pour vous d�placer rapidement parmi les �l�ments
de menu.

@unnumberedsubsec @kbd{e} rend le document Info �ditable

@kindex e @r{(mode Info)}
@findex Info-edit
@cindex �diter un document Info
  La commande Info @kbd{e} fait passer du mode Info � un mode ordinaire
d'�dition Emacs, afin que vous puissiez �diter le texte du noeud en
cours.  Tapez @kbd{C-c C-c} pour revenir au mode Info.  La commande
@kbd{e} n'est autoris�e que si la variable @code{Info-enable-edit} n'est
pas @code{nil}.

  La commande @kbd{e} ne marche que dans Emacs, o� elle lance la
commande @code{Info-edit}.  Le navigateur Info autonome ne vous permet
pas d'�diter le fichier Info, et taper @kbd{e} vous conduit alors � la
fin du noeud en cours.

@node Recherche Info, Ajouter, Expert, Info Avanc�
@comment  node-name,  next,  previous,  up
@section Comment rechercher un sujet donn� dans des documents Info

@cindex rechercher dans des documents Info
@cindex document Info comme manuel de r�f�rence
  Les commandes de d�placement entre et dans des noeuds vous permettent
de lire le manuel tout entier ou de larges portions.  Mais que faire si
vous devez trouver le plus vite possible une information donn�e dans le
manuel, et que vous ne savez pas ou ne vous rappelez plus dans quel
noeud la @w{chercher ?}  Ce besoin se fait sentir quand vous utilisez le
manuel comme une @dfn{r�f�rence}, ou quand il n'est pas possible de
lire le manuel tout entier avant de commencer � utiliser les programmes
qu'il d�crit.

  Info a de puissantes capacit�s de recherche qui vous permettent de
trouver les choses rapidement.  Vous pouvez chercher soit dans les index
du manuel soit dans le texte.

@kindex i @r{(mode Info)}
@findex Info-index
  Comme la plupart des sujets li�s � ce que le manuel d�crit doivent
figurer dans les index, il vaut mieux d'abord essayer la recherche par
index.  La commande @kbd{i} vous demande de fournir un sujet et
recherche ensuite ce sujet dans les index.  Si elle trouve une entr�e
d'index avec le sujet que vous avez demand�, elle va dans le noeud sur
lequel pointe l'entr�e d'index.  Vous devez parcourir ce noeud pour voir
si le probl�me que vous vouliez y est d�crit.  S'il n'y est pas, tapez
@kbd{,} une ou plusieurs fois pour vous rendre dans d'autres entr�es
d'index qui correspondent � votre sujet.

  La commande @kbd{i} trouve toutes les entr�es d'index qui comprennent
la cha�ne que vous avez tap�e, en tant que @emph{sous-cha�ne}.  Pour
chaque r�sultat, Info affiche dans la zone de dialogue l'entr�e d'index
compl�te qu'il a trouv�e.  Souvent, le texte complet de l'entr�e d'index
vous donne suffisamment d'information pour d�cider si elle correspond �
ce que vous cherchiez, et nous vous recommandons donc de lire ce
qu'Emacs affiche dans la zone de dialogue avant de regarder le noeud en
question.

  Comme @kbd{i} cherche une sous-cha�ne, vous pouvez rechercher des
sujets m�me si vous n'�tes pas s�r de la fa�on dont ils sont
r�pertori�s dans l'index.  Par exemple, supposons que vous voulez
trouver quelque chose qui a � voir avec les commandes qui compl�tent des
entr�es partielles (par ex., quand vous tapez @key{TAB}).  Si vous
voulez obtenir les entr�es d'index se r�f�rant � @w{� compl�ter �},
@w{� compl�tion �}, et @w{� compl�te �}, vous pouvez taper
@kbd{icompl@key{ENTR�E}}.

  Les documents Info qui d�crivent des programmes doivent indexer les
commandes, options, et s�quences de touches fournies par le programme.
Si vous cherchez la description d'une commande, d'une option, ou d'une
touche, vous n'avez qu'� taper leur nom quand @kbd{i} vous demande un
sujet.  Par exemple, si vous voulez lire la description de ce que fait
la touche @kbd{C-f}, tapez @kbd{iC-f@key{ENTR�E}}.  Ici @kbd{C-f} sont 3
caract�res distincts @samp{C}, @samp{-}, et @samp{f}, et non la commande
@w{� Control-f �} que vous tapez dans Emacs pour lancer la commande li�e �
@kbd{C-f}.

  Dans Emacs, @kbd{i} lance la commande @code{Info-index}.

@kindex s @r{(mode Info)}
@findex Info-search
  La commande @kbd{s} vous permet de rechercher une cha�ne dans tout un
fichier.  Il passe au noeud suivant si n�cessaire.  Vous tapez @kbd{s}
suivi de la cha�ne que vous recherchez, et vous la terminez par
@key{ENTR�E}.  Pour rechercher de nouveau la m�me cha�ne, faites juste
@kbd{s} suivi de @key{ENTR�E}.  Les noeuds du fichier sont balay�s dans
l'ordre dans lequel ils sont dans le fichier, qui n'est pas
n�cessairement li� � l'ordre dans lequel ils peuvent �tre dans la
structure arborescente des menus et des pointeurs @samp{suivant}.  Mais
normalement les deux ordres ne sont pas tr�s diff�rents.  Dans tous les
cas, vous pouvez toujours faire @kbd{b} pour savoir dans quel noeud vous
�tes arriv�, si l'en-t�te n'est pas visible (ce qui peut arriver, parce
que @kbd{s} place votre curseur sur l'occurrence de la cha�ne, et non au
d�but du noeud).

@kindex M-s @r{(mode Info)}
  Dans Emacs, @kbd{Meta-s} est �quivalent � @kbd{s}.  C'est pour la
compatibilit� avec d'autres paquetages GNU qui utilisent @kbd{M-s} pour
effectuer une recherche similaire.  @kbd{s} et @kbd{M-s} lancent tous
deux dans Emacs la commande @code{Info-search}.

@node Ajouter, Menus, Recherche Info, Info Avanc�
@comment  node-name,  next,  previous,  up
@section Ajouter un nouveau noeud � Info

Pour ajouter un nouveau sujet � la liste du r�pertoire Info, vous
@w{devez :}

@enumerate
@item
Cr�er des noeuds, dans un fichier, pour documenter ce sujet.
@item
Mettre ce sujet dans le menu du r�pertoire.  @xref{Menus, Menu}.
@end enumerate

  D'habitude, on cr�e des noeuds avec Texinfo (@pxref{Top,, Overview of
Texinfo, texinfo, Texinfo: The GNU Documentation Format}@w{) ;} l'avantage
est que vous pouvez aussi en obtenir un manuel imprim�.  Cependant, si
vous voulez �diter un fichier Info, voici comment.

@cindex d�limiteurs de noeud
  Le nouveau code peut r�sider dans un fichier de documentation d�j�
existant, ou dans un nouveau.  Il doit commencer par un caract�re
@samp{^_} (invisible � @w{l'utilisateur ;} ce noeud en a un mais vous ne
pouvez pas le voir), et il se termine avec un @samp{^_}, un @samp{^L}
(@w{� formfeed �}), ou la fin du fichier.@footnote{Si vous mettez un
@samp{^L} pour terminer un nouveau noeud, assurez-vous qu'il y a un
@samp{^_} apr�s pour commencer le suivant, car @samp{^L} ne peut pas
@emph{commencer} un noeud.  D'autre part, une fa�on plus belle de faire
d'une limite de noeud une limite de page est de mettre un @samp{^L}
@emph{juste apr�s} le @samp{^_}.}

  Le @samp{^_} d�marrant un noeud doit �tre suivi par un passage � la
ligne ou un passage � la ligne de type @samp{^L}, apr�s lequel vient la
ligne d'en-t�te du noeud.  La ligne d'en-t�te doit donner le nom du
noeud (gr�ce auquel Info le retrouve), et d�clarer les noms des noeuds
@samp{Suivant}, @samp{Pr�c�dent} et @samp{Parent} (s'il y en a).  Comme
vous pouvez le voir, le noeud @samp{Parent} de ce noeud-ci est le noeud
@samp{Top}, qui pointe sur toute la documentation d'Info.  Le noeud
@samp{Suivant} est @samp{Menus}.

@cindex ligne d'en-t�te de noeud, format
@cindex format des en-t�tes de noeud
  Les mots-cl�s @dfn{Noeud}, @dfn{Suivant}, @dfn{Pr�c�dent} et
@dfn{Parent} peuvent appara�tre dans n'importe quel ordre, n'importe o�
dans le ligne d'en-t�te, mais l'ordre recommand� est celui donn� dans
cette phrase.  Chaque mot-cl� doit �tre suivi d'un deux-points,
d'espaces et de tabulations, puis du nom appropri�.  Le nom peut �tre
termin� avec une tabulation, une virgule ou un passage � la ligne.  Une
espace ne le termine @w{pas ;} les noms de noeud peuvent contenir des
espaces.  La casse des lettres dans les noms ne compte pas.

@cindex format du nom de noeud
@cindex noeud R�pertoire
  Le nom d'un noeud a deux formes.  Un noeud dans le fichier en cours
est d�sign� par ce qui suit @samp{Noeud: } dans la premi�re ligne de
ce noeud.  Par exemple, le nom de ce noeud est @samp{Ajouter}.  Un
noeud dans un autre fichier est d�sign� par
@samp{(@var{nom_fichier})@var{noeud_dans_fichier}}, comme dans
@samp{(info)Ajouter} pour ce noeud.  Si le nom de fichier commence par
@w{� ./ � ;} alors il est relatif au r�pertoire @w{actuel ;} sinon, il est
relatif au r�pertoire standard des fichiers Info sur votre syst�me.
Le nom @samp{(@var{nom_fichier})Top} peut �tre raccourci en
@samp{(@var{nom_fichier})}.  Par convention, le nom @samp{Top} sert
pour le noeud le plus @w{� �lev� �} de tout le fichier --- le noeud dont
@samp{Parent} pointe en dehors du fichier.  Le noeud @samp{R�pertoire}
est @file{(dir)}, il pointe vers un fichier @file{dir} qui contient
un grand menu donnant la liste de tous les documents Info install�s
sur votre syst�me.  Le noeud @samp{Top} d'un fichier de document
mentionn� dans le @samp{R�pertoire} devrait comporter un
@samp{Parent: (dir)}.

@cindex documents non structur�s
  Le nom de noeud @kbd{*} est @w{sp�cial :} il se r�f�re au fichier tout
entier.  Ainsi, @kbd{g*} vous montre tout le fichier en cours.  Le
noeud @kbd{*} permet d'int�grer des fichiers non structur�s dans les
noeuds de l'arbre.

  Le nom de @samp{Noeud:}, dans lequel un noeud indique son propre nom,
ne doit pas contenir de nom de fichier, puisque quand Info recherche un
noeud, il ne s'attend pas � ce qu'il y ait l� un nom de fichier.  Les
noms @samp{Suivant}, @samp{Pr�c�dent} et @samp{Parent} peuvent en
contenir un.  Dans ce noeud-ci, comme le noeud @samp{Parent} est dans le
m�me fichier, il n'�tait pas n�cessaire d'en mettre un.

  Notez que les noeuds de ce fichier ont un nom de fichier dans la
ligne d'en-t�te.  Les noms de fichier sont ignor�s par Info, mais
ils servent de commentaires pour aider l'utilisateur � identifier le
noeud.

@node Menus, R�f�rences Crois�es, Ajouter, Info Avanc�
@comment  node-name,  next,  previous,  up
@section Comment Cr�er des Menus

  Tous les noeuds de la hi�rarchie d'Info peuvent avoir un @dfn{menu} --- une
liste de sous-noeuds.  La commande @kbd{m} recherche dans le menu du noeud
en cours le sujet que vous lui donnez dans le terminal.

@cindex menu et d'entr�e de menu, format
  Un menu d�bute avec une ligne commen�ant par @samp{* Menu:}.  Le
reste de la ligne est un commentaire.  Apr�s la ligne initiale, chaque
ligne commen�ant par @samp{* } correspond � un unique sujet.  Le nom
du sujet --- ce que l'utilisateur doit donner comme param�tre � la
commande @kbd{m} pour s�lectionner ce sujet --- vient juste apr�s
l'�toile et l'espace, et est suivi par un deux-points, des espaces et
des tabulations, et le nom du noeud qui traite de ce sujet.  Le nom du
noeud, comme les noms de noeuds apr�s @samp{Suivant}, @samp{Pr�c�dent}
et @samp{Parent}, peut �tre termin� par une tabulation, une virgule ou
un passage � la @w{ligne ;} il peut aussi �tre termin� par un point.

  Si le nom de noeud et le nom de sujet sont les m�mes, alors plut�t
que de r�p�ter deux fois le nom, on peut utiliser l'abr�viation
@samp{* @var{nom}::} (et on doit l'utiliser � chaque fois que c'est
possible, pour rendre le menu moins encombr�).

  Il est de bon ton de choisir les noms de sujets de telle sorte qu'ils
soient diff�renci�s tr�s pr�s du d�but du mot --- �a permet �
l'utilisateur de taper des abr�viations courtes.  Dans un long menu,
c'est une bonne id�e de mettre en majuscules le pr�fixe minimal de
chaque sujet qui puisse faire office d'abr�viation (par long menu
nous entendons plus de 5 entr�es).

  Les noeuds figurant dans le menu d'un noeud sont appel�s ses
@w{� sous-noeuds �}, et il est leur @w{� sup�rieur �}.  Ils doivent chacun
avoir un @samp{Parent:} pointant vers leur sup�rieur.  Il est souvent
utile de ranger la plupart des sous-noeuds dans une s�quence de
pointeurs @samp{Suivant} et @samp{Pr�c�dent}, pour que quelqu'un qui
voudrait tous les voir n'ait pas besoin de repasser par le Menu.

  Le R�pertoire d'Info est simplement le menu du noeud
@samp{(dir)Top} --- c'est-�-dire le noeud @samp{Top} du fichier
@file{.../info/dir}.  Vous pouvez mettre de nouvelles entr�es dans ce
menu comme dans n'importe quel autre menu.  Le R�pertoire Info
@emph{n'est pas} la m�me chose que le r�pertoire du syst�me de fichiers
appel� @file{info}.  Il arrive que beaucoup des fichiers Info r�sident
dans ce r�pertoire, mais ce n'est pas une @w{obligation ;} et les fichiers
de ce r�pertoire ne figurent pas automatiquement dans le noeud
R�pertoire d'Info.

  �galement, bien que le graphe des noeuds Info pr�tende �tre une
@w{� hi�rarchie �}, en fait ce peut �tre @emph{n'importe quel} graphe
orient�.  Les structures partag�es et les pointeurs cycliques sont
parfaitement possibles, et peuvent �tre utilis�s s'ils sont opportuns
pour exprimer le sens voulu.  Il n'y a pas besoin que tous les noeuds
d'un fichier soient en relation.  En fait, ce fichier a deux
composantes connexes.  Vous �tes dans l'une d'entre elles, qui est sous
le noeud @w{@samp{Top} ;} l'autre contient le noeud @samp{Aide} auquel on
acc�de par la commande @kbd{h}.  En fait, comme il n'y a pas de
collecteur de d�tritus, il n'arrive rien de terrible si rien ne pointe
sur une sous-structure, mais une telle sous-structure ne sert pas �
grand chose puisque personne ne peut jamais y acc�der.

@node R�f�rences Crois�es, Balises, Menus, Info Avanc�
@comment  node-name,  next,  previous,  up
@section Cr�er des R�f�rences Crois�es

@cindex r�f�rence crois�e, format
  Une r�f�rence crois�e peut �tre plac�e n'importe o� dans le texte,
contrairement � un �l�ment de menu qui doit �tre au d�but d'une ligne.
Une r�f�rence crois�e ressemble � un �l�ment de menu � part qu'elle a un
@samp{*note} � la place de @samp{*}.  Elle ne peut @emph{pas} se
terminer par une @samp{)}, parce que les @samp{)} font souvent partie des
noms de noeuds.  Si vous voulez mettre une r�f�rence crois�e entre
parenth�ses, terminez-la d'abord avec un point.  Voici deux exemples de
pointeurs de r�f�rence @w{crois�e :}

@example
*Note d�tails: commandes.  (Voir *note 3: Preuve Compl�te.)
@end example

@noindent
@emph{Ce ne sont que des exemples.}  Les endroits o� ils @w{� m�nent �}
n'existent pas @w{vraiment !}

@menu
* Aide-Crois�e::                   Cible d'une r�f�rence crois�e.
@end menu

@node Aide-Crois�e,  ,  , R�f�rences Crois�es
@subsection Le noeud atteint par la r�f�rence crois�e dans Info

  C'est le noeud atteint par la r�f�rence crois�e appel�e
@samp{Crois�e}.

  Alors que ce noeud est sp�cialement destin� � �tre atteint par une
r�f�rence crois�e, la plupart des r�f�rences crois�es conduisent � des
noeuds qui @w{� appartiennent �} � la structure du document Info et qui sont
situ�s loin ailleurs.  Vous ne pouvez donc pas compter sur un lien
@samp{Suivant}, @samp{Pr�c�dent} ou @samp{Parent} ramenant l� d'o� vous
venez.  En g�n�ral, la commande @kbd{l} (el) est le seul moyen d'y
retourner.

@format
>> Tapez @kbd{l} pour revenir au noeud o� �tait situ�e la r�f�rence
   crois�e.
@end format

@node Aide-Q,  , Aide-Int, Pour D�marrer
@comment  node-name,  next,  previous,  up
@section Quitter Info

@kindex q @r{(mode Info)}
@findex Info-exit
@cindex quitter le mode Info
  Pour sortir d'Info, et retourner � ce que vous faisiez avant, tapez
@kbd{q} pour @dfn{Quitter}.  �a lance la commande @code{Info-exit} dans
Emacs.

  C'est la fin du cours de base sur l'utilisation d'Info.  Vous avez
appris comment vous d�placer dans un document Info, et comment naviguer
dans les menus et les r�f�rences crois�es.  Vous �tes d�sormais pr�t �
lire les manuels du d�but � la fin, comme tous les utilisateurs
d'un nouveau paquetage devraient faire.

  Un autre ensemble de commandes Info sert � trouver quelque chose
rapidement dans un manuel --- quand vous avez besoin du manuel comme
une r�f�rence plus que comme un tutoriel.  Nous vous recommandons
d'apprendre aussi ces commandes.  Si vous voulez le faire tout de
suite, suivez cette r�f�rence crois�e vers @ref{Recherche Info}.

Il y a encore un autre jeu de commandes, destin�es aux utilisateurs
@w{exp�riment�s ;} vous pouvez les trouver en cherchant dans le noeud
R�pertoire la documentation sur Info.  Les trouver sera un bon exercice
pour l'utilisation de base d'Info.

@format
>> Tapez @kbd{d} pour aller dans le noeud r�pertoire @w{d'Info ;} puis tapez
   @kbd{mInfo} et Entr�e, pour aller dans le noeud concernant Info et
   voir le reste de l'aide disponible.
@end format

@node Balises, V�rification, R�f�rences Crois�es, Info Avanc�
@comment  node-name,  next,  previous,  up
@section Tableaux de Balises pour les Fichiers Info

@cindex tableaux de balises dans les fichiers info
  Vous pouvez acc�l�rer l'acc�s aux noeuds dans un long fichier Info en
lui donnant un tableau de balises.  Contrairement aux tableaux de
balises pour un programme, le tableau de balises d'un fichier Info
r�side dans le fichier lui-m�me et est utilis� automatiquement � chaque
fois qu'Info lit le fichier.

@findex Info-tagify
  Pour fabriquer un tableau de balises, allez dans un noeud du fichier
avec le mode Info d'Emacs et tapez @kbd{M-x Info-tagify}.  Vous devez
alors faire @kbd{C-x C-s} pour enregistrer le fichier.  Les fichiers
Info produites par la commande @code{makeinfo} qui fait partie du
paquetage Texinfo sont toujours pourvus de tableaux de balises.

@cindex tableaux de balises p�rim�s
@cindex mettre � jour le tableau de balises d'Info
  Une fois que le fichier Info a un tableau de balises, vous devez vous
assurer que celui-ci est � jour.  Si vous �ditez un fichier Info
directement (et non sa source Texinfo), et qu'un noeud, � la suite de
l'effacement d'une partie du texte, recule de plus de mille caract�res
dans le fichier par rapport � sa position enregistr�e dans le tableau
de balises, Info ne pourra plus retrouver le noeud.  Pour mettre �
jour le tableau de balises, utilisez de nouveau la commande
@code{Info-tagify}.

  Le tableau de balises d'un fichier Info appara�t � la fin du fichier
et ressemble � @w{ceci :}

@example
^_^L
Tag Table:
File: info, Node: R�f�rences Crois�es^?21419
File: info,  Node: Balises^?22145
^_
End Tag Table
@end example

@noindent
Notez qu'il contient une ligne par noeud, et que cette ligne contient le
d�but de l'en-t�te du noeud (jusqu'� la fin du nom de noeud), un
caract�re @samp{DEL}, et la position du d�but du noeud dans le fichier,
en nombre de caract�res.

@node V�rification, Variables Info Emacs, Balises, Info Avanc�
@section V�rifier un Fichier Info

Quand vous cr�ez un fichier Info, il est facile d'oublier le nom d'un
noeud quand vous faites un pointeur dessus � partir d'un autre noeud.
Si vous vous trompez dans le nom du noeud, ce n'est pas d�tect� avant
que quelqu'un n'essaye de suivre le pointeur avec Info.  La v�rification
du fichier Info est un processus automatique qui v�rifie tous les
pointeurs vers des noeuds et signale tous ceux qui sont invalides.
Tous les @samp{Suivant}, @samp{Pr�c�dent}, et @samp{Parent} sont
v�rifi�s, ainsi que tous les �l�ments de menu et toutes les r�f�rences
crois�es.  En plus, tous les @samp{Suivant} qui n'ont pas de
@samp{Pr�c�dent} qui leur corresponde sont signal�s.  Seuls les
pointeurs � l'int�rieur du fichier sont v�rifi�s, car contr�ler les
pointeurs vers d'autres fichiers serait horriblement lent.  Mais
ceux-ci sont en g�n�ral peu nombreux.

@findex Info-validate
Pour v�rifier un fichier Info, faites @kbd{M-x Info-validate} depuis
n'importe quel noeud du fichier dans le mode Info d'Emacs.

@node Variables Info Emacs, , V�rification, Info Avanc�
@section Variables du mode Info d'Emacs

Les variables suivantes peuvent modifier le comportement du mode Info
dans @w{Emacs ;} vous pouvez vouloir fixer l'une ou plusieurs de ces
variables interactivement, ou dans votre fichier @file{~/.emacs}.
@xref{Examining, Examining and Setting Variables, Examining and Setting
Variables, emacs, The GNU Emacs Manual}.  Le navigateur Info autonome a
son propre ensemble de variables, d�crit dans @ref{Variables,,
Manipulating Variables, info-stnd, GNU Info}.

@vtable @code
@item Info-directory-list
La liste des r�pertoires � consulter pour chercher des fichiers Info.
Chaque �l�ment est une cha�ne (nom de r�pertoire) ou @code{nil} (essayer
le r�pertoire par d�faut).  Si elle n'est pas initialis�e Info utilise
la variable d'environnement @env{INFOPATH} pour l'initialiser, ou
@code{Info-default-directory-list} s'il n'y a pas de variable
@env{INFOPATH} dans l'environnement.

Si vous voulez personnaliser la liste des r�pertoires Info � la fois
pour Emacs info et pour la visionneuse Info autonome, il est pr�f�rable
de d�finir la variable d'environnement @env{INFOPATH}, car elle
s'applique aux deux programmes.

@item Info-additional-directory-list
La liste des r�pertoires suppl�mentaires � consulter pour chercher des
fichiers de documentation Info.  Ces r�pertoires ne sont pas consult�s
pour forger le fichier @file{dir}.

@item Info-fontify
Quand elle est fix�e � une valeur non @code{nil}, active la surbrillance
des fichiers Info.  La valeur par d�faut est @code{t}.  Vous pouvez
changer l'apparence de la surbrillance en personnalisant les polices
@code{info-node}, @code{info-menu-5}, @code{info-xref},
@code{info-header-xref}, @code{info-header-node},
@code{info-title-@var{n}-face} (o� @var{n} est le niveau de la section,
un num�ro entre 1 et 4), et @code{info-menu-header}.  Pour personnaliser
une police, tapez @kbd{M-x customize-face @key{ENTR�E} @var{police}
@key{ENTR�E}}), o� @var{police} est l'un des noms de police cit�s ici.

@item Info-use-header-line
Si pas @code{nil}, Emacs place dans le tampon Info une ligne d'en-t�te
avec les liens @samp{Suivant}, @samp{Pr�c�dent}, et @samp{Parent}.  Une
ligne d'en-t�te ne d�file pas avec le reste du tampon, rendant ces
lignes toujours visibles.

@item Info-scroll-prefer-subnodes
Si elle est fix�e � une valeur non @code{nil}, les touches
@key{ESPACE} et @key{BACKSPACE} (ou @key{DEL}) dans un menu visitent les
sous-noeuds du noeud en cours avant de vous amener respectivement au
d�but et � la fin.  Par exemple, si le menu du noeud appara�t � l'�cran,
l'@key{ESPACE} suivant vous am�ne au sous-noeud indiqu� par l'�l�ment de
menu suivant.  Mettre cette option � @code{nil} donne un comportement
similaire � celui du navigateur Info autonome, qui ne visite le
premier sous-noeud du menu que lorsque vous avez atteint la fin du noeud
en cours.  La valeur par d�faut est @code{t}.

@item Info-enable-active-nodes
Quand elle est fix�e � une valeur non @code{nil}, elle permet � Info
d'ex�cuter du code Lisp associ� aux noeuds.  Le code Lisp est ex�cut�
quand le noeud est s�lectionn�.  Le code Lisp � ex�cuter doit suivre le
d�limiteur de noeud (le caract�re @samp{DEL}) et une balise
@samp{execute: }, comme @w{ceci :}

@example
^_execute: (message "C'est un noeud actif !")
@end example

@item Info-enable-edit
Fix�e � @code{nil}, d�sactive la commande @samp{e} (@code{Info-edit}).  Une
valeur autre que @code{nil} l'active.  @xref{Ajouter, �diter}.
@end vtable

@node Cr�er un Fichier Info
@chapter Cr�er un Fichier Info � partir d'un Fichier Texinfo

@code{makeinfo} est un utilitaire pour convertir un fichier Texinfo en
fichier @w{Info ;} @code{texinfo-format-region} et
@code{texinfo-format-buffer} sont des fonctions de GNU Emacs qui font la
m�me chose.

@xref{Top,, Overview of Texinfo, texinfo, Texinfo: The GNU Documentation
Format}, pour apprendre comment �crire un fichier Texinfo.

@xref{Creating an Info File,,, texinfo, Texinfo: The GNU Documentation
Format}, pour apprendre comment cr�er un fichier Info � partir d'un
fichier Texinfo.

@xref{Installing an Info File,,, texinfo, Texinfo: The GNU
Documentation Format}, pour apprendre comment installer un fichier Info
apr�s en avoir cr�� un.

@node Index
@unnumbered Index

C'est la liste alphab�tique de toutes les commandes, variables, et
sujets discut�s dans ce document.

@printindex cp

@bye

repo_name: mthl/texinfo

license: mit