Source de cours/references.php

<?
  
require ("../page.inc");
  require (
"lessons.inc");

  
$currentPage = new Page();

  
$currentPage->setPrintable(true);
  
$currentPage->setHomePage("Retour aux cours","index.php");

  
$lessons = new Lessons();
  
$lessons->setSectionContent($currentPage);

  
$currentPage->setCreationDate("2002-12-12");

  
$currentPage->setKeywords("notation, référence, reference, exemple, cadre, terminal, commande, taper, code, source, documentation, manuel, man, apropos, gnu, RFC, document, réseau, reseau");
  
$currentPage->setDescription("Description des notations utilisées dans les cours ainsi que où trouver les documentations de référence.");

  
$currentPage->setTitle("Notations et références");
  
$currentPage->setContent('');
  
$currentPage->setPageTitle('Notations et références');
  
$currentPage->setIntroduction('<p>Dans les différents articles présents sur ce site sont utilisées certaines notations présentées ici. Les documents servant de référence sont également indiqués.</p>');

  
$currentPage->addChapter('notation''Notations''
<p>Il y a deux types d\'exemples apparaissant dans des cadres.</p>
<p>Le premier type correspond à ce que l\'on pourrait voir dans un teminal où les commandes vont être saisies. Les lignes commençant par &gt; sont celles qui doivent être entrées (le &gt; et l\'espace le suivant ne devant pas être tapés), les autres sont le résultat.
</p>
<code class="terminal">&gt; commande à taper<br />
résultat</code>
<p>Concernant les autres exemples, ils correspondent à du code source. Il s\'agit de ce qui doit être tapé dans un éditeur de texte pour le programme ou shell-script concerné.
</p>
<code>Lignes de code devant être saisies<br />
à l\'aide d\'un éditeur de texte.
</code>
'
);

  
$currentPage->addChapter('ref''Références''
<p>Les articles techniques ne sont pas forcément exhaustifs. Ils permettent de savoir ce qui est nécessaire pour une utilisation courante. Mais il arrive parfois des situations où des besoins très précis se font sentir.
</p><p>
Sous <acronym xml:lang="en" lang="en" title="GNU\'s Not Unix">GNU</acronym>/Linux, le moyen le plus simple d\'obtenir tous les détails des options d\'un programme ou d\'une fonction, est de consulter sa page de manuel. Elle s\'obtient à l\'aide de l\'exécutable <strong>man</strong>. On l\'utilise comme ceci&nbsp;:
</p>
<p class="terminal">&gt; man programme</p>
<p>
Cela permet d\'afficher la page de manuel de programme. Les touches fléchées permettent de naviguer. A l\'aide de <strong>/</strong> on peut taper une chaîne à rechercher (touche Entrée pour valider puis <strong>N</strong> pour passer à l\'occurence suivante). On quitte en appuyant sur <strong>Q</strong>.
</p>
<p>
Les pages de manuel sont organisées par sections. Et parfois plusieurs sections contiennent une page de même nom. Il faut alors spécifier dans quelle section on désire chercher. Cela se fait en indiquant simplement le numéro de section avant le nom du programme. Par exemple&nbsp;:
</p>
<p class="terminal">
&gt; man 7 signal
</p>
<p>
Qui permet d\'afficher les informations concernant signal dans la section numéro 7. On désigne en abrégé la page de manuel de signal dans la section 7 sous la forme&nbsp;: signal(7). Et plus généralement donc, <strong>programme(section)</strong> permet de désigner (dans un article par exemple) la page de manuel de programme dans la section indiquée.
</p>
<p>
Pour lister l\'ensemble des pages de manuel se rapportant à un mot-clé, il suffit d\'utiliser la commande <strong>apropos</strong>.
</p>
<p class="terminal">&gt; apropos mot-clé</p>
<p>
Les documentations des outils GNU sont disponibles sur Internet en anglais à l\'adresse suivante&nbsp;:
</p>
<a rel="external" class="external" hreflang="en" href="http://www.gnu.org/manual/manual.html">http://www.gnu.org/manual/manual.html</a>
<p>
Pour tout ce qui touche aux protocoles réseaux de l\'Internet, les documentations de référence sont les <acronym xml:lang="en" lang="en" title="Request For Comments">RFC</acronym>. Ce sont des notes plus ou moins techniques qui définissent tout ce qui sert de base à ce réseau. Elles peuvent être consultées sur ce site&nbsp;:
</p>
<a rel="external" class="external" hreflang="en" href="http://www.rfc-editor.org/">http://www.rfc-editor.org/</a>
'
);

  
$currentPage->display();
?>