syncing german and english installation manuals
i am almost done with syncing the things which are present in the
german manual but not in the english version.
the thing what is missing is a chapter on dual booting with
windows/dos and some basic lilo configuration. but anything else
is done more or less.
cvs question: when i do a cvs diff -u > doc.diff how can i tell
diff and/or cvs that it should also include completely new files?
for instance the appendix.sgml file which is attached because of
so long and night
RCS file: /cvs/debian-boot/boot-floppies/documentation/install.sgml,v
retrieving revision 1.79
diff -u -r1.79 install.sgml
--- documentation/install.sgml 2000/04/22 04:04:40 1.79
+++ documentation/install.sgml 2000/04/28 02:40:55
@@ -14,6 +14,7 @@
<!entity ch-dbootstrap SYSTEM "en/dbootstrap.sgml">
<!entity ch-post-install SYSTEM "en/post-install.sgml">
<!entity ch-tech-info SYSTEM "en/tech-info.sgml">
+ <!entity ch-appendix SYSTEM "en/appendix.sgml">
<!entity ch-administrivia SYSTEM "en/administrivia.sgml">
<!entity FIXME "<![ %FIXME [ <p><em>Documentation not complete, text missing.</em> ]]>">
@@ -129,6 +130,8 @@
RCS file: /cvs/debian-boot/boot-floppies/documentation/urls.ent,v
retrieving revision 1.45
diff -u -r1.45 urls.ent
--- documentation/urls.ent 2000/04/23 15:55:08 1.45
+++ documentation/urls.ent 2000/04/28 02:40:57
@@ -25,7 +25,7 @@
<!entity ftp-debian-org "ftp.debian.org">
-<!entity nonus-debian-org "ftp://nonus.debian.org/pub/debian-non-US">
+<!entity nonus-debian-org "ftp://nonus.debian.org/debian-non-US">
<!entity url-social-contract "http://&www-debian-org;/social_contract">
RCS file: /cvs/debian-boot/boot-floppies/documentation/en/hardware.sgml,v
retrieving revision 1.15
diff -u -r1.15 hardware.sgml
--- documentation/en/hardware.sgml 2000/04/20 05:02:18 1.15
+++ documentation/en/hardware.sgml 2000/04/28 02:41:03
@@ -39,8 +39,9 @@
This document covers installation for the <em>&architecture;</em>
-architecture. Separate versions of this document exist for other
+architecture. If you look for information on other architectures take
+a look at the <url id="http://&www-debian-org;/ports/" name="Debian-Ports">
<![ %powerpc [
@@ -61,21 +62,23 @@
Complete information concerning supported peripherals can be found at
<url id="&url-hardware-howto;" name="Linux Hardware Compatibility
HOWTO">. This section merely outlines the basics.
+ <sect2 id="cpus">CPU
Nearly all x86-based processors are supported; this includes AMD and
-Cyrix processors as well. However, Linux will <em>not</em> run on
-286 or earlier processors.
+Cyrix processors as well. Also the new processors like Athlon and the
+K6-2 or K6-3, respectively, are supported. However, Linux will
+<em>not</em> run on 286 or earlier processors.
+ <sect2 id="bus">I/O Bus
The system bus is the part of the motherboard which allows the CPU to
communicate with peripherals such as storage devices. Your computer
must use the ISA, EISA, PCI, the Microchannel Architecture (MCA, used
in IBM's PS/2 line), or VESA Local Bus (VLB, sometimes called the VL
-Laptops are also supported. Laptops are often specialized or contain
-proprietary hardware. To see if your particular laptop works well
-with GNU/Linux, see the <url id="&url-x86-laptop;" name="Linux
+ <sect2 id="gfx">Graphics Card
You should be using a VGA-compatible display interface for the console
terminal. Nearly every modern display card is compatible with
@@ -91,6 +94,13 @@
id="&url-xfree-support;">. Debian &release; ships with X11 revision
+ <sect2 id="laptops">Laptops
+Laptops are also supported. Laptops are often specialized or contain
+proprietary hardware. To see if your particular laptop works well
+with GNU/Linux, see the <url id="&url-x86-laptop;" name="Linux
<![ %m68k [
@@ -526,7 +536,9 @@
Spellcaster BRI ISDN boards are also not supported by the
-Sound devices are not supported by default.
+Sound devices are not supported by default. But as already mentioned above:
+if you want to use an own kernel please go to <ref id="kernel-baking"> for
@@ -581,7 +593,6 @@
also be supported by the boot disks. You may need to load your
network driver as a module.
<sect>Purchasing Hardware Specifically for GNU/Linux
RCS file: /cvs/debian-boot/boot-floppies/documentation/en/partitioning.sgml,v
retrieving revision 1.18
diff -u -r1.18 partitioning.sgml
--- documentation/en/partitioning.sgml 2000/04/23 15:56:00 1.18
+++ documentation/en/partitioning.sgml 2000/04/28 02:41:08
@@ -77,6 +77,51 @@
big, you will be wasting space that could be used elsewhere. Disk
space is cheap nowadays, but why throw your money away?
+ <sect1>The Directory Tree
+The following list describes some important directories. It should
+help you to find out what your partitioning scheme should be. If this
+is too confusing for you, just ignore it and reread it when you read
+the rest of the installation manual.
+<tt>/</tt>: root represents the starting point of the directory
+hierachy. It contains the essentiel programs that the
+computer can boot. This includes the kernel, system
+libraries, configuration files in <tt>/etc</tt> and
+various other needed files. Typically 30-50 MB are needed
+but this may vary.
+<tt>/dev</tt>: this directory contains the various device files
+which are interfaces to the various hardware components.
+For more information see <ref id="disk-naming">.
+<tt>/usr</tt>: all user programs (<tt>/usr/bin</tt>), libraries (<tt>
+/usr/lib</tt>), documentation (<tt>/usr/share/doc</tt>),
+etc. are in this directory. This part of the filesystem
+needs most of the space. You should at least provide
+300-500 MB of disk space. If you want to install more you
+should increase the amount of space you give this
+<tt>/home</tt>: every user will put his data into a subdirectory of this
+directory. The size of this depends on how many users will be using the
+system and what files are to be stored in the directories of the users.
+Depending on your planned usage you should reserver about 100 MB for each
+User but which should be adapted to your needs.
+<tt>/var</tt>: all variable data like news articles, e-mails, websites,
+etc. will be placed under this directory. The size of this directory
+depends greatly on the usage of your computer.
+<tt>/tmp</tt>: if a program creates temporary data it will most likely
+go in there. 20-50 MB should be usually enough.
+<tt>/proc</tt>: this is a virtual file system which doesn't reside on the
+harddisk. Thus no harddisk space is needed. It provides interesting and
+also vital information about the running system.
<sect>Planning Use of the System
RCS file: /cvs/debian-boot/boot-floppies/documentation/en/preparing.sgml,v
retrieving revision 1.12
diff -u -r1.12 preparing.sgml
--- documentation/en/preparing.sgml 2000/04/20 05:36:44 1.12
+++ documentation/en/preparing.sgml 2000/04/28 02:41:10
@@ -249,6 +249,12 @@
This setting enables you to boot from either a floppy disk or a
CD-ROM, which are the two most common boot devices used to install
+If you have a newer SCSI controller and you have a CD-ROM device
+attached to it, you are usually able to boot from the CD-ROM.
+All you have to do is enabling booting from a CD-ROM in the SCSI-BIOS
+of your controller. Additionally you have to be able to boot from a
+floppy disk. This is set up in the PC-BIOS.
If your system can't boot directly from CD-ROM, or you simply can't
seem to get it to work, don't despair; you can simply run
@@ -406,6 +412,11 @@
somewhere between 0xA0000 and 0xFFFFF (from 640K to just below 1
megabyte) or at an address at least 1 megabyte greater than the total
amount of RAM in your system.
+ <sect1>More than 64 MB RAM
+The Linux Kernel can not always detect what amount of RAM you have. If
+this is the case please look at <ref id="boot-parms">.
<!-- retain these comments for translator revision tracking -->
<!-- $Id: welcome.sgml,v 1.8 2000/04/23 15:56:00 aph Exp $ -->
<sect>Further Information and Obtaining Debian GNU/Linux
<sect1 id="furtherinfo">Further Information
A general source of information on Linux is the <url
id="&url-ldp;" name="Linux Documentation Project">. There you will find
the HOWTOs and pointers to other very valuable information on parts
of a GNU/Linux system.
<sect1 id="obtain">Obtaining Debian GNU/Linux
If you want to buy a CD set to install GNU/Debian from CD-ROM you
should look at the <url id="http://&www-debian-org;/distrib/vendors"
name="CD vendors page">. There you get a list of addresses which
sell GNU/Debian no CD-ROMs. The list is sorted by country so you shouldn't
have a problem to find a vendor near you.
<sect1 id="mirrors">Debian GNU Mirrors
If you live outside of the USA you want to download Debian packages you
can also use one of many mirrors which reside outside the USA. A list
of countries and mirrors can be found at the <url
id="http://&www-debian-org;/distrib/ftplist" name="Debian FTP server website">.
<sect1 id="nonus-issue">GPG, SSH and other Security Software
The following text is taken from the README.non-US.
United States laws place restrictions on the export of defense articles,
which, unfortunately, includes some types of cryptographic software. PGP
and ssh, among others, fall into this category. It is legal however, to
import such software into the US.
To prevent anyone from taking unnecessary legal risks, some Debian
packages are available from a server outside the US which serves the various
cryptographic programs: <url id="&nonus-debian-org;" name="Debian GNU non-US
<sect id="linuxdevices">Linux Devices
In Linux you have various special files in <tt>/dev</tt>. These files are
called devices files. In the Unix world accessing hardware is different.
There you have a special file which actually runs a driver which in turn
accesses the hardware. The device file is an interface to the actual
system component. Files under <tt>/dev</tt> also behave differently than
ordinary files. Below are the most important device files listed.
fd0 1. Floppy Drive
fd1 2. Floppy Drive
hda IDE Harddisk / CD-ROM on the first IDE port (Master)
hdb IDE Harddisk / CD-ROM on the first IDE port (Slave)
hdc IDE Harddisk / CD-ROM on the second IDE port (Master)
hdd IDE Harddisk / CD-ROM on the first IDE port (Slave)
hda1 1. partition of the first IDE harddisk
hdd15 15. partition of the fourth IDE harddisk
sda SCSI Harddisk / CD-ROM with lowest SCSI ID (e.g. 0)
sdb SCSI Harddisk / CD-ROM with next higher SCSI ID (e.g. 1)
sdc SCSI Harddisk / CD-ROM with next higher SCSI ID (e.g. 2)
sda1 1. partition of the first SCSI harddisk
sdd10 10. partition of the fourth SCSI harddisk
cdrom Symbolic link to the CD-ROM drive
mouse Symbolic link to the mouse device file
null everything pointed to this device will disappear
zero one can endlessly read zeros out of this device
<!-- Keep this comment at the end of the file
sgml-parent-document:("../install.sgml" "book" "chapt")