[Kos-cvs] kos-web/contents snapshots_bin_en.i, 1.9,
1.10 snapshots_bin_fr.i, 1.9, 1.10 snapshots_src_en.i, 1.9,
1.10 snapshots_src_fr.i, 1.9, 1.10
thomas at kos.enix.org
thomas at kos.enix.org
Wed Jan 5 21:45:12 CET 2005
Update of /var/cvs/kos/kos-web/contents
In directory the-doors:/tmp/cvs-serv32096/contents
Modified Files:
snapshots_bin_en.i snapshots_bin_fr.i snapshots_src_en.i
snapshots_src_fr.i
Log Message:
Clarification de quelques pages
Index: snapshots_bin_en.i
===================================================================
RCS file: /var/cvs/kos/kos-web/contents/snapshots_bin_en.i,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- snapshots_bin_en.i 30 Dec 2004 00:22:40 -0000 1.9
+++ snapshots_bin_en.i 5 Jan 2005 20:45:10 -0000 1.10
@@ -1,41 +1,65 @@
-<?
+<? // ;; -*- mode: HTML; -*-
+include("$topsrcdir/contents/snapshots.i");
start_content_section("Binary distribution","bin");
?>
-<h2>kos module binaries</h2>
+<p>You will find here compiled versions of KOS. KOS is composed of two
+main parts : the <i>kernel</i> and the <i>root filesystem</i>. The
+kernel is the result of the compilation of the <i>kos</i> CVS module
+and the root filesystem is the result of the compilation of the
+<i>kos-sys</i> CVS module. These two parts are vailable on this page
+in the binary form, while the sources are <?
+make_link("downloads-src.php", "available on an other page"); ?></p>
-<p> <? make_snapshot_link("kos_current/grub/fd.img","Floppy disk
-image"); ?> (1.44M). Also available in <?
-make_snapshot_link("kos_current/grub/kos-144M.gz","gzip format"); ?>
-(about 200k), or <?
-make_snapshot_link("kos_current/grub/kos-144M.zip","(pk)zip format");
-?> (about 200k). Use rawrite/rawrite2 under win32 in order to make a
-boot diskette, or dd or cp under Unix.</p>
+<p>Currently, KOS automatically tries to mount the first partition of
+the first disk as the root filesystem. This partition must be
+formatted using the FAT filesystem and must contain the test programs
+of the <i>kos-sys</i> module. Because of this constraints, we highly
+recommend to test KOS in an emulator, like <a
+href="http://bochs.sf.net">Bochs</a> or <a
+href="http://bellard.org/qemu/">Qemu</a>.</p>
-<p>For the Grub advanced users, get the <?
+<p>If you want to test KOS, we recommend you to read the <a
+href="http://kos.enix.org/~d2/snapshots/kos_current/doc/testingen.pdf">Compile,
+test and debug KOS</a> documentation.</p>
+
+<h2>kos CVS module</h2>
+
+<p>The easiest solution to test KOS is to use a
+make_snapshot_link("kos_current/grub/fd.img","floppy disk image");
+(1.44M), also available <?
+make_snapshot_link("kos_current/grub/kos-144M.gz","gzip-compressed");
+?> or <?
+make_snapshot_link("kos_current/grub/kos-144M.zip","zip-compressed");
+?>.</p>
+
+<p>If you really want to test on a real computer, you have to transfer
+this image on a real floppy disk using <code>rawrite</code> under
+Windows or <code>dd</code> under Linux. Have a look at <a
+href="http://kos.enix.org/~d2/snapshots/kos_current/doc/testingen.pdf">Compile,
+test and debugKOS</a> for more information.</p>
+
+<p>The experimented <i>Grub</i> users can download the <?
make_snapshot_link("kos_current/loader/loader.elf","loader"); ?>, the
<? make_snapshot_link("kos_current/modules/kos.a","kernel"); ?>, and
-the <? make_snapshot_link("kos_current/grub/menu.txt","menu.txt"); ?>
-(update the kernel options if needed: see below).</p>
+then <? make_snapshot_link("kos_current/grub/menu.txt","menu.txt");
+?> file. These files are directly loadable by Grub at boot time.</p>
-<h2>kos-sys module binaries</h2>
+<h2>kos-sys CVS module</h2>
-<p>To test with an x86 emulator (<a
+<p>To test with an emulator (<a
href="http://bochs.sf.net">Bochs</a>/<a
-href="http://bellard.org/qemu">Qemu</a>/VMWare/...) : download the 10M
-hard disk image <?
-make_snapshot_link("kos-sys_current/hd10M.img.gz","gzipped"); ?> or <?
-make_snapshot_link("kos-sys_current/hd10M.zip","(pk)zipped"); ?>
-(about 15k).</p>
-
-<p>To test on a real hard disk: copy <?
-make_snapshot_link("kos-sys_current/apps/test","this test
-application"); ?> on your disk (IDE disk, FAT partition, in the
-<tt>/bin/</tt> subdirectory) and update the option passed to the
-kernel by Grub
-(<tt>wolfgang:root="/dev/part/hda0",init="/bin/console"</tt> by
-default) if needed.</p>
+href="http://bellard.org/qemu">Qemu</a>/VMWare/...), you have to fetch
+the hard disk image <?
+make_snapshot_link("kos-sys_current/hd10M.img.gz","gzip-compressed");
+?> or <?
+make_snapshot_link("kos-sys_current/hd10M.zip","zip-compressed"); ?>
+(around 15k), and give it to your emulator as the image of the first
+hard drive.</p>
+<p>If you really want to test on a real machine, you have to transfer
+the contents of the disk image proposed above into the first partition
+of the first disk, which must be FAT-formatted.</p>
<?
end_content_section();
Index: snapshots_src_fr.i
===================================================================
RCS file: /var/cvs/kos/kos-web/contents/snapshots_src_fr.i,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- snapshots_src_fr.i 30 Dec 2004 00:26:36 -0000 1.9
+++ snapshots_src_fr.i 5 Jan 2005 20:45:10 -0000 1.10
@@ -1,66 +1,111 @@
-<?
+<? // ;; -*- mode: HTML; -*-
+include("$topsrcdir/contents/snapshots.i");
start_content_section("Sources KOS et documentation","pkg");
?>
-<h2>Module <a href="/cgi/cvsweb/kos/?cvsroot=kos">kos</a>
- (chargeur/éditeur de liens, modules qui forment le noyau)</h2>
+<p>KOS est composé de 3 modules CVS distincts : <b>kos</b>, <b>kos-sys</b>
+et <b>kos-doc</b>.</p>
+
+<p>Les fichiers disponibles ci-dessous sont générées automatiquement
+chaque jour à partir du CVS de <b>kos</b>. Ils représentent donc la
+dernière version de développement de KOS. Nous ne fixons pas pour le
+moment de versions stables de KOS. Toutefois, nous nous arrangerons,
+la plupart du temps, pour que la version disponible sur CVS compile
+correctement et s'éxécute.</p>
+
+<p>Si vous souhaitez tester KOS, nous vous recommandons la lecture du
+document <a
+href="http://kos.enix.org/~d2/snapshots/kos_current/doc/testingfr.pdf">Compiler,
+tester et débugger KOS</a>.</p>
+
+<h2>Module CVS kos</h2>
+
+ <p>Le module CVS <b>kos</b> contient le <i>loader</i> et l'ensemble
+ des modules qui composent le noyau de KOS.</p>
<ul>
<li>
- <? make_snapshot_link("kos_current/ChangeLog","ChangeLog"); ?>
+ Une <? make_snapshot_link("kos_current.tar.gz","archive au format
+ tar.gz"); ?> ou au <? make_snapshot_link("kos_current.zip","format (PK)Zip"); ?>
+ (au format CR/LF DOS) est la solution la plus simple pour
+ récupérer les sources ;
</li>
<li>
- <a href="http://kos.enix.org/cgi/lxr/source/?lang=fr">Arborescence complète</a>
-
- <? make_snapshot_link("kos_current/","(version sans lxr)"); ?>
+ Le <? make_snapshot_link("kos_current/ChangeLog","ChangeLog"); ?>
+ liste les derniers changements intervenus dans <b>kos</b> ;
</li>
<li>
- <? make_snapshot_link("kos_current.tar.gz","Archive au format tar.gz"); ?>
+ L'<? make_snapshot_link("kos_current/","arborescence complète");
+ ?> des sources est disponible ;
</li>
<li>
- <? make_snapshot_link("kos_current.zip","Archive au format (PK)Zip"); ?>
- (au format CR/LF DOS).
+ Un accès au <a href="/cgi/cvsweb/kos/?cvsroot=kos">module CVS
+ kos</a> est possible via CVSWeb ;
</li>
<li>
- <? make_snapshot_link("kos_current/deps.html","Graphes de dépendances"); ?>
+ Des <? make_snapshot_link("kos_current/deps.html","graphes de
+ dépendances"); ?> sont générés automatiquement à partir des
+ sources de <b>kos</b>. Ils permettent de visualiser graphiquement
+ les dépendances entre les modules du noyau.
</li>
</ul>
-<h2>Module <a href="/cgi/cvsweb/kos-sys/?cvsroot=kos">kos-sys</a>
- (applications utilisateur, libc basique)</h2>
+<h2>Module CVS kos-sys</h2>
+
+ <p>Le module CVS <b>kos-sys</b> contient les petites applications
+ utilisateur de test et une petite bibliothèque de fonctions
+ standards (type <i>libc</i>). Il permet de générer une image de
+ disque dur contenant ces programmes utilisateur de tests qui
+ fonctionneront dans KOS. Cette image de disque contient un système
+ de fichiers qui sera montée à la racine de l'arborescence dans
+ KOS.</p>
<ul>
<li>
- <? make_snapshot_link("kos-sys_current/","Arborescence complète"); ?>
- </li>
- <li>
- <? make_snapshot_link("kos-sys_current/ChangeLog","ChangeLog"); ?>
+ L'<? make_snapshot_link("kos-sys_current.tar.gz","archive au
+ format tar.gz"); ?> ou <?
+ make_snapshot_link("kos-sys_current.zip","au format (PK)Zip"); ?>
+ (au format CR/LF DOS) est la solution la plus simple pour
+ récupérer les sources ;
</li>
<li>
- <? make_snapshot_link("kos-sys_current.tar.gz","Archive au format tar.gz"); ?>
+ L'<? make_snapshot_link("kos-sys_current/","arborescence
+ complète"); ?> des sources est disponible ;
</li>
<li>
- <? make_snapshot_link("kos-sys_current.zip","Archive au format (PK)Zip"); ?>
- (au format CR/LF DOS).
+ Un accès au <a href="/cgi/cvsweb/kos-sys/?cvsroot=kos">module CVS
+ kos-sys</a> est possible via CVSWeb ;
</li>
</ul>
-<h2>Module <a href="/cgi/cvsweb/kos-doc/?cvsroot=kos">kos-doc</a></h2>
+<h2>Module CVS kos-doc</h2>
- <ul>
- <li>
- <? make_snapshot_link("kos-doc_current/ChangeLog","ChangeLog"); ?>
- </li>
+ <p>Ce module CVS contient des documents concernant KOS. La plupart
+ des documents ne sont plus à jour et les nouveaux documents sont
+ disponibles dans le répertoire <code>doc/</code> du module CVS
+ <b>kos</b> (voir ci-dessus).</p>
+
+ <p>Si vous souhaitez tout de même consulter ces documents, vous
+ pouvez télécharger des versions PDF, Postscript ou HTML sur la page
+ ?????.</p>
+
+ <ul>
<li>
- <? make_snapshot_link("kos-doc_current/","Arborescence complète"); ?>
+ L'<? make_snapshot_link("kos-doc_current.tar.gz","archive au
+ format tar.gz"); ?> ou <?
+ make_snapshot_link("kos-doc_current.zip","au format (PK)Zip"); ?>
+ (au format CR/LF DOS) est la solution la plus simple pour
+ récupérer les sources ;
</li>
<li>
- <? make_snapshot_link("kos-doc_current.tar.gz","Archive au format tar.gz"); ?>
+ L'<? make_snapshot_link("kos-doc_current/","arborescence
+ complète"); ?> des sources est disponible ;
</li>
<li>
- <? make_snapshot_link("kos-doc_current.zip","Archive au format (PK)Zip"); ?>
- (au format CR/LF DOS).
+ Un accès au <a href="/cgi/cvsweb/kos-doc/?cvsroot=kos">module CVS
+ kos-doc</a> est possible via CVSWeb ;
</li>
+
</ul>
<?
Index: snapshots_src_en.i
===================================================================
RCS file: /var/cvs/kos/kos-web/contents/snapshots_src_en.i,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- snapshots_src_en.i 30 Dec 2004 00:26:36 -0000 1.9
+++ snapshots_src_en.i 5 Jan 2005 20:45:10 -0000 1.10
@@ -1,66 +1,110 @@
<?
-start_content_section("KOS and documentation source distribution","pkg");
+include("$topsrcdir/contents/snapshots.i");
+
+start_content_section("Sources KOS et documentation","pkg");
?>
-<h2>Module <a href="/cgi/cvsweb/kos/?cvsroot=kos">kos</a>
- (loader/linker, modules that compose the kernel)</h2>
+<p>KOS is made of three separate CVS modules : <b>kos</b>,
+<b>kos-sys</b> et <b>kos-doc</b>.</p>
+
+<p>The files available below are automatically generated every day
+from the KOS CVS. They contain the last development version of KOS. We
+do not release stable versions of KOS at the moment. However, we
+almost always make sure that the version available through CVS
+compiles and runs smoothly.</p>
+
+<p>If you want to test KOS, we recommend you to read the <a
+href="http://kos.enix.org/~d2/snapshots/kos_current/doc/testingen.pdf">Compiling
+Testing and Debugging KOS</a> documentation.</p>
+
+<h2>kos CVS module</h2>
+
+ <p>The <b>kos</b> CVS module contains the <i>loader</i> and all the
+ modules that are part of the KOS kernel. This is the main CVS
+ module, in which most of the development occurs.</p>
<ul>
<li>
- <? make_snapshot_link("kos_current/ChangeLog","ChangeLog"); ?>
+ A <? make_snapshot_link("kos_current.tar.gz","tar.gz archive"); ?>
+ or a <? make_snapshot_link("kos_current.zip","(PK)Zip archive"); ?>
+ (CR/LF DOS formatted) are the simplest solutions to fetch the
+ sources ;
</li>
<li>
- <a href="http://kos.enix.org/cgi/lxr/source/?lang=en">Complete source tree</a>
-
- <? make_snapshot_link("kos_current/","(version without lxr)"); ?>
+ The <? make_snapshot_link("kos_current/ChangeLog","ChangeLog"); ?>
+ lists the last changes made to the <b>kos</b> module ;
</li>
<li>
- <? make_snapshot_link("kos_current.tar.gz","tar.gz archive"); ?>
+ The <? make_snapshot_link("kos_current/","complete source tree");
+ ?> is available for browsing ;
</li>
<li>
- <? make_snapshot_link("kos_current.zip","(PK)Zip archive"); ?>
- (in CR/LF DOS format).
+ An access to the <a href="/cgi/cvsweb/kos/?cvsroot=kos">kos CVS
+ module</a> is possible through CVSWeb ;
</li>
<li>
- <? make_snapshot_link("kos_current/deps.html","Dependency graphs"); ?>
+ <? make_snapshot_link("kos_current/deps.html","Dependency
+ graphs"); ?> are generated automatically from the <b>kos</b>
+ sources. They allow to graphically visualize the dependencies
+ between kernel modules.
</li>
</ul>
-<h2>Module <a href="/cgi/cvsweb/kos-sys/?cvsroot=kos">kos-sys</a>
- (basic user applications, basic libc)</h2>
+<h2>kos-sys CVS module</h2>
+
+ <p>The <b>kos-sys</b> CVS module contains the small user
+ applications and a tiny standard functions library (like <i>libc</i>
+ but very very limited). These applications and library are run under
+ KOS. The <b>kos-sys</b> module allows to generate disk image to be
+ mounted as the root filesystem inside KOS.</p>
<ul>
<li>
- <? make_snapshot_link("kos-sys_current/ChangeLog","ChangeLog"); ?>
- </li>
- <li>
- <? make_snapshot_link("kos-sys_current/","Complete source tree"); ?>
+ A<? make_snapshot_link("kos-sys_current.tar.gz","tar.gz archive");
+ ?> or a <?
+ make_snapshot_link("kos-sys_current.zip","(PK)Zip archive"); ?>
+ (CR/LF DOS formatted) are the simplest solutions to fetch the
+ sources ;
</li>
<li>
- <? make_snapshot_link("kos-sys_current.tar.gz","tar.gz archive"); ?>
+ The <? make_snapshot_link("kos-sys_current/","complete source
+ tree"); ?> is available for browsing ;
</li>
<li>
- <? make_snapshot_link("kos-sys_current.zip","(PK)Zip archive"); ?>
- (in CR/LF DOS format).
+ An access to the <a href="/cgi/cvsweb/kos-sys/?cvsroot=kos">kos-sys CVS
+ module</a> is possible through CVSWeb ;
</li>
</ul>
-<h2>Module <a href="/cgi/cvsweb/kos-doc/?cvsroot=kos">kos-doc</a></h2>
+<h2>kos-doc CVS module</h2>
- <ul>
+ <p>This CVS module contains some documentations about KOS. Most of
+ the documentation is out of date, and the updated documentation is
+ available under the <code>doc/</code> directory in the <b>kos</b>
+ CVS module (see above).</p>
+
+ <p>If you still want to read this documents, you may prefer to use
+ already compiled PDF, Postscript or HTML versions, available on the
+ ????? page.</p>
+
+ <ul>
<li>
- <? make_snapshot_link("kos-doc_current/ChangeLog","ChangeLog"); ?>
- </li>
<li>
- <? make_snapshot_link("kos-doc_current/","Complete source tree"); ?>
+ A<? make_snapshot_link("kos-doc_current.tar.gz","tar.gz archive");
+ ?> or a <?
+ make_snapshot_link("kos-doc_current.zip","(PK)Zip archive"); ?>
+ (CR/LF DOS formatted) are the simplest solutions to fetch the
+ sources ;
</li>
<li>
- <? make_snapshot_link("kos-doc_current.tar.gz","tar.gz archive"); ?>
+ The <? make_snapshot_link("kos-doc_current/","complete source
+ tree"); ?> is available for browsing ;
</li>
<li>
- <? make_snapshot_link("kos-doc_current.zip","(PK)Zip archive"); ?>
- (in CR/LF DOS format).
+ An access to the <a href="/cgi/cvsweb/kos-doc/?cvsroot=kos">kos-doc CVS
+ module</a> is possible through CVSWeb ;
</li>
+
</ul>
<?
Index: snapshots_bin_fr.i
===================================================================
RCS file: /var/cvs/kos/kos-web/contents/snapshots_bin_fr.i,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- snapshots_bin_fr.i 30 Dec 2004 00:22:40 -0000 1.9
+++ snapshots_bin_fr.i 5 Jan 2005 20:45:10 -0000 1.10
@@ -1,42 +1,69 @@
-<?
+<? // ;; -*- mode: HTML; -*-
+include("$topsrcdir/contents/snapshots.i");
start_content_section("Distribution binaire","bin");
?>
-<h2>Module kos</h2>
+<p>Vous trouverez ici des versions compilées de KOS. KOS est composé
+de deux parties : le noyau, issu de la compilation du module CVS
+<i>kos</i>, et le système de fichier racine, issu de la compilation du
+module CVS <i>kos-sys</i>. Ces deux parties sont disponibles sur cette
+page au format binaire, tandis que les sources sont <?
+make_link("downloads-src.php", "disponibles sur une autre page");
+?>.</p>
-<p><? make_snapshot_link("kos_current/grub/fd.img","Image disquette");
-?> (1.44M) Egalement disponible <?
+<p>A l'heure actuelle, KOS essaie automatiquement de monter la
+première partition du premier disque comme système de fichiers
+racine. Celle-ci doit être formatée avec le système de fichiers FAT et
+contenir les programmes de test du module <i>kos-sys</i>. En raison de
+ces contraintes, nous vous recommandons plutôt de tester KOS dans un
+émulateur tel que <a href="http://bochs.sf.net">Bochs</a> ou <a
+href="http://bellard.org/qemu/">Qemu</a>.</p>
+
+<p>Si vous souhaitez tester KOS, nous vous recommandons la lecture du
+document <a
+href="http://kos.enix.org/~d2/snapshots/kos_current/doc/testingfr.pdf">Compiler,
+tester et débugger KOS</a>.</p>
+
+<h2>Module CVS kos</h2>
+
+<p>La solution la plus simple pour tester KOS est d'utiliser une <?
+make_snapshot_link("kos_current/grub/fd.img","Image disquette"); ?>
+(1.44M), également disponible <?
make_snapshot_link("kos_current/grub/kos-144M.gz","au format gzip");
-?> (environ 200k), ou <?
-make_snapshot_link("kos_current/grub/kos-144M.zip","au format
-(pk)zip"); ?> (environ 200k). Utiliser rawrite/rawrite2 sous win32
-pour en faire une disquette bootable, ou dd ou cp sous Unix ;</p>
+?> , ou <? make_snapshot_link("kos_current/grub/kos-144M.zip","au
+format (pk)zip"); ?>.</p>
-<p>Pour les utilisateurs expérimentés de grub, téléchargez le <?
+<p>Pour tester sur une machine réelle, il suffira de transférer cette
+image de disquette sur une vraie disquette avec l'aide de
+<code>rawrite</code> sous Windows ou <code>dd</code> sous Linux. Voir
+<a
+href="http://kos.enix.org/~d2/snapshots/kos_current/doc/testingfr.pdf">Compiler,
+tester et débugger KOS</a> pour plus d'informations.</p>
+
+<p>Les utilisateurs expérimentés de grub peuvent télécharger le <?
make_snapshot_link("kos_current/loader/loader.elf","loader"); ?>, le
<? make_snapshot_link("kos_current/modules/kos.a","noyau"); ?>, et le
fichier <?
-make_snapshot_link("kos_current/grub/menu.txt","menu.txt"); ?>
-(modifiez les options au kernel si besoin : cf ci-dessous).</p>
+make_snapshot_link("kos_current/grub/menu.txt","menu.txt"); ?>. Ces
+fichiers sont ensuite chargeables directement par Grub au démarrage de
+la machine.</p>
-<h2>Module kos-sys</h2>
+<h2>Module CVS kos-sys</h2>
<p>Pour tester avec un émulateur 80486/Pentium (<a
href="http://bochs.sf.net">Bochs</a>/<a
-href="http://bellard.org/qemu">Qemu</a>/VMWare/...) : récupérer
+href="http://bellard.org/qemu">Qemu</a>/VMWare/...), il faut récupérer
l'image de disque dur <?
make_snapshot_link("kos-sys_current/hd10M.img.gz","compressée au
format gzip"); ?> ou <?
make_snapshot_link("kos-sys_current/hd10M.zip","compressée au format
-(pk)zip"); ?> (environ 15k).</p>
-
-<p>Pour tester sur un vrai disque : copier <?
-make_snapshot_link("kos-sys_current/apps/test","cette application de
-test"); ?> sur votre disque dur (disque IDE, partition FAT, répertoire
-<tt>/bin/</tt>) et modifiez l'option passée par Grub au kernel (par
-défaut : <tt>wolfgang:root="/dev/part/hda0",init="/bin/console"</tt>)
-si besoin.</p>
+(pk)zip"); ?> (environ 15k), et la fournir à l'émulateur comme image
+du premier disque dur.</p>
+<p>Pour tester sur une machine réelle, il faut transférer le contenu
+de l'image disque proposée ci-dessus dans la première partition du
+premier disque qui doit être formatée avec le système de fichiers
+FAT.</p>
<?
end_content_section();
More information about the Kos-cvs
mailing list