Comments on Debian Tutorial, patches.
Hello,
Here are comments and patches to Debian Tutorial, created with diff.
By the way, is there a reason the Tutorial is not in DDP CVS?
63,64d62
< FIXME: Link to installation manual? Development version, and where
< it is supposed to be when it is complete.
73c71
< <p>Please send comments about this manual to the Debian
---
> <p>Please send comments about this manual tothe Debian
298,306c296,301
< at your computer. Most people find that reading a book
< without using the program isn't beneficial. The best way to
< learn Unix and GNU/Linux is by using them. Use GNU/Linux for
< everything you can. Experiment. Don't be afraid --- it's
< <em>possible</em> to mess things up, but you can always
< reinstall. Keep backups and have fun!
< Doing backups
< documented in Debian System Administrator's Manual, chapter
< Backup and Restore.
---
> at your computer. Most people find that reading a book
> without using the program isn't beneficial. The best way to
> learn Unix and GNU/Linux is by using them. Use GNU/Linux
> for everything you can. Experiment. Don't be afraid ---
> it's <em>possible</em> to mess things up, but you can always
> reinstall. Keep backups and have fun!
362a358
>
662,663d657
< Clarification: If You are in X, go to VC 1 with C-A-F1. To
< get back to X, press A-F7.
682c676,677
< to turn the computer off when you're done with it
---
> to turn the computer off when you're done with it.
>
690c685
< </footnote>.
---
> </footnote>
738,742d732
< <p>If the <package>dwww</package> is installed, documentation
< can be read with a web browser, like <prgn>lynx</prgn> or
< <prgn>netscape</prgn> by pointing the browser to <url
< id="dwww" name="http://localhost/dwww/">.
<
928c918,919
< directory") and it cannot be renamed
---
> directory") and it cannot be renamed.
>
941c932
< </footnote>.
---
> </footnote>
961c952
< it a <em>pathname</em>. However, people will also refer
---
> it a <em>path</em>. However, people will also refer
1026,1027d1016
< <footnote>You can get the <tt>pwd</tt> to the shell
< prompt with <example>export PS1='\u@\h \w $ '</example>.</footnote>
1087,1088d1075
< Most, but not all shells use the tilde character in this
< way.
1225c1212
< <p>Note several commands ending in <tt>d</tt> --- such as
---
> <p>Note all the commands ending in <tt>d</tt> --- such as
1252,1253d1238
< FIXME: These terms should be added to the Debian
< Dictionary.
1304c1289
< <tt>chsh RET</tt>, supply a password when asked, and choose a
---
> <tt>chsh RET</tt>, supply a password when asked, and chose a
1306,1308d1290
< You can also try out a new shell with <prgn>exec <em>name of
< shell</em></prgn>, <prgn>exit</prgn> ends the new shell. This way your
< login shell is not changed.
1479,1483c1461,1464
< but it is found in the Info help system rather than the man
< pages. To read it, type <tt>info bash</tt> (or use web browser
< to http://localhost/dwww if <package>dwww</package> is
< installed). See <ref id="docs-info"> for instructions on using
< the <tt>info</tt> program.
---
> but it is found in the Info help system rather than the man
> pages. To read it, type <tt>info bash</tt>. See <ref
> id="docs-info"> for instructions on using the <tt>info</tt>
> program.
1500,1501c1481
< beep. Pressing <tt>TAB</tt> after the beep shows all
< possible completions. You can then enter enough of the word to make it
---
> beep. You can then enter enough of the word to make it
1506d1485
< FIXME: setting shell prompt.
1543,1547d1521
< <item> If the <package>dwww</package> is installed, the
< <tt>man</tt>, <tt>info</tt> and
< <tt>/usr/doc/<var>package</var></tt> pages can be read
< with a web browser from http://localhost/dwww.
<
1674,1676d1647
< FIXME: There should be reference to instructions on how to
< use IRC, and perhaps a recommendation which of the many IRC programs
< in Debian to use.
1761,1762c1732
< <p> /var/log/*, dmesg, uname -a
< FIXME: this is incomplete.
---
> <p> /var/log/*, dmesg, uname -a
1811,1813d1780
< FIXME: The PATH above has same directories twice, has "/home/hp/.bin"
< where the dot is wrong(?) and has current directory which may be
< risky.
1818,1819c1785
< system. For example, the <tt>EDITOR</tt> and <tt>VISUAL</tt>
< variables let you
---
> system. For example, the <tt>EDITOR</tt> variable lets you
1924c1890,1891
< their <em>parent process</em>.
---
> their <em>parent process</em>.
>
2148c2115
< <p>FIXME: Stdin, stdout, pipelines, and redirection
---
> <p>Stdin, stdout, pipelines, and redirection
2245,2246c2212
< commands <p>FIXME: "modifiers" like batch, at, nohup, nice,
< sleep
---
> commands <p>"modifiers" like batch, at, nohup, nice
2269,2270c2235
< ls /etc/rc0.d /etc/rc1.d /etc/rc2.d /etc/rc3.d \
< /etc/rc4.d /etc/rc5.d /etc/rc6.d /etc/rcS.d
---
> ls /etc/rc0.d /etc/rc1.d /etc/rc2.d /etc/rc3.d /etc/rc4.d /etc/rc5.d /etc/rc6.d /etc/rcS.d
2493c2458
< (user, group, others) makes a total of 27 combinations.
---
> (user, group, others) makes a total of nine combinations.
2867,2868c2832
< for the X Window System (graphical version of GNU Midnight
< Commander, <tt>gmc</tt>).
---
> for the X Window System.
3058c3022
< adjacent on the home row of the keyboard, and thus
---
> adjacent on on the home row of the keyboard, and thus
3069c3033
< <tt>hjkl</tt> keys. If you try to move too far in
---
> <tt>hjkl</tt> keys. If you try to move to far in
3231d3194
< Or refer to man or info page?
3460d3422
< FIXME: the \key{} things should be something else.
3474,3476d3435
< <p>FIXME: Refer to National HOWTO's, like Danish, Finnish,
< French, German etc.
<
3480c3439
< these are hidden and out of your way while you do your
---
> these are hidden and out of your way while you do you
3544,3546c3503
< tricks. <p>describe <tt>umask</tt>
< FIXME: Setting shell prompt PS1, perhaps here or sooner in
< this document.
---
> tricks. <p>describe <tt>umask</tt>
3572d3528
< FIXME: Reference to section where VC's were explained.
3579,3580d3534
< FIXME: Why recommended? I think it is risky, I only use xdm
< when I am very certain that everything is OK.
3681,3683d3634
< FIXME: Not good to refer to specific stores, they are not
< relevant on the opposite side of the globe. At least use only stores
< that have Web page and can deliver all over the world.
3937c3888
< string GNU, you type:
---
> word GNU, you type:
4029,4030c3980
< FIXME: perhaps clarify when you list all the possible matches, and
< when only a sample.
---
>
4083,4084d4032
< Reference to System Administrator's Manual, chapter Backup and
< Restore.
4127,4129c4075
< <item> <tt>cd; cp /etc/profile ./mysamplefile</tt>
< FIXME: Why the ./ in the filename? It is not needed.
< <p>
---
> <item> <tt>cd; cp /etc/profile ./mysamplefile</tt> <p>
4420a4367
>
4432c4379
< most common on PC platforms. Your DOS/Windows <tt>C:\</tt> partition
---
> most common. Your DOS/Windows <tt>C:\</tt> partition
4453a4401
>
4491,4492c4439
< Debian. You'll need to be root to do this (unless
< <tt>/etc/fstab</tt> allows ordinary users to mount), so be careful;
---
> Debian. You'll need to be root to do this, so be careful;
4509,4513c4456
< to make one using <tt>mkdir /cdrom</tt>. <footnote>
< If the <tt>/cdrom</tt> directory existed, and was not
< empty, those files that were there will not be accessible while the CD
< is mounted there. They are there again when the CD is unmounted,
< however.</footnote>
---
> to make one using <tt>mkdir /cdrom</tt>.
4710,4712d4652
< Add users to <tt>floppy</tt>, <tt>cdrom</tt> and <tt>disk</tt>
< groups, devices group owned by the corresponding group and group can
< read and write.
4733,4735d4672
< <p>FIXME: Networking better in Network Administrator's
< Manual. Not possible to set it up without root permissions anyway.
<
4747,4748d4683
< <p>Not for ordinary users.
<
4764,4765c4699,4700
< are deleted. However, if another program you still have on the
< system also needs those files, you want to be sure you keep them.
---
> are deleted. However, if a program you still have on the
> system needs those files, you want to be sure you keep them.
4799c4734
< getting both versions installed.
---
> installing both versions at once.
5195c5130
< put something into the pipe, and it comes out the other
---
> put something into the file, and it comes out the other
5215,5217d5149
< You can check this with <tt>ls -l mypipe</tt>,
< it should show <tt>p</tt> in the first column to signify that the file
< is a FIFO.
5385,5390d5316
<
< <p>Copy a directory tree to another location:
< <example>
< cd directory1
< tar cf - . | ( cd /some/path/to/directory2 ; tar xpBf - )
< </example>
5400d5325
< FIXME: Is a Tutorial a good place for compiling kernel?
5441,5444d5365
< <p>FIXME: Yes, this would be useful. With 2500 applications it
< is not reasonable to examine them all with dselect to identify the
< ones you want.
<
5522,5523c5443
< drive (if boot order is set so in the BIOS).
< If it finds one, it looks for a "boot sector" on
---
> drive. If it finds one, it looks for a "boot sector" on
5602d5521
< Or better yet, in System Administrator's manual.
5667,5669c5586
< lower prices. Solaris 7 is available for the cost of media,
< shipping and handling for non-commercial use, see
< http://www.sun.com/solaris/freesolaris.html .
---
> lower prices.
5735,5740c5652,5653
< <item>Ian Jackson led Debian from January 1998 until
< February 1999.
<
< <item>Wichert Akkerman was elected leader in February
< 1999.
<
---
> <item>Ian Jackson led Debian from January 1998 until the
> present
--
Tapio Lehtonen
Tapio.Lehtonen@IKI.FI
63,64d62
< FIXME: Link to installation manual? Development version, and where
< it is supposed to be when it is complete.
73c71
< <p>Please send comments about this manual to the Debian
---
> <p>Please send comments about this manual tothe Debian
298,306c296,301
< at your computer. Most people find that reading a book
< without using the program isn't beneficial. The best way to
< learn Unix and GNU/Linux is by using them. Use GNU/Linux for
< everything you can. Experiment. Don't be afraid --- it's
< <em>possible</em> to mess things up, but you can always
< reinstall. Keep backups and have fun!
< Doing backups
< documented in Debian System Administrator's Manual, chapter
< Backup and Restore.
---
> at your computer. Most people find that reading a book
> without using the program isn't beneficial. The best way to
> learn Unix and GNU/Linux is by using them. Use GNU/Linux
> for everything you can. Experiment. Don't be afraid ---
> it's <em>possible</em> to mess things up, but you can always
> reinstall. Keep backups and have fun!
362a358
>
662,663d657
< Clarification: If You are in X, go to VC 1 with C-A-F1. To
< get back to X, press A-F7.
682c676,677
< to turn the computer off when you're done with it
---
> to turn the computer off when you're done with it.
>
690c685
< </footnote>.
---
> </footnote>
738,742d732
< <p>If the <package>dwww</package> is installed, documentation
< can be read with a web browser, like <prgn>lynx</prgn> or
< <prgn>netscape</prgn> by pointing the browser to <url
< id="dwww" name="http://localhost/dwww/">.
<
928c918,919
< directory") and it cannot be renamed
---
> directory") and it cannot be renamed.
>
941c932
< </footnote>.
---
> </footnote>
961c952
< it a <em>pathname</em>. However, people will also refer
---
> it a <em>path</em>. However, people will also refer
1026,1027d1016
< <footnote>You can get the <tt>pwd</tt> to the shell
< prompt with <example>export PS1='\u@\h \w $ '</example>.</footnote>
1087,1088d1075
< Most, but not all shells use the tilde character in this
< way.
1225c1212
< <p>Note several commands ending in <tt>d</tt> --- such as
---
> <p>Note all the commands ending in <tt>d</tt> --- such as
1252,1253d1238
< FIXME: These terms should be added to the Debian
< Dictionary.
1304c1289
< <tt>chsh RET</tt>, supply a password when asked, and choose a
---
> <tt>chsh RET</tt>, supply a password when asked, and chose a
1306,1308d1290
< You can also try out a new shell with <prgn>exec <em>name of
< shell</em></prgn>, <prgn>exit</prgn> ends the new shell. This way your
< login shell is not changed.
1479,1483c1461,1464
< but it is found in the Info help system rather than the man
< pages. To read it, type <tt>info bash</tt> (or use web browser
< to http://localhost/dwww if <package>dwww</package> is
< installed). See <ref id="docs-info"> for instructions on using
< the <tt>info</tt> program.
---
> but it is found in the Info help system rather than the man
> pages. To read it, type <tt>info bash</tt>. See <ref
> id="docs-info"> for instructions on using the <tt>info</tt>
> program.
1500,1501c1481
< beep. Pressing <tt>TAB</tt> after the beep shows all
< possible completions. You can then enter enough of the word to make it
---
> beep. You can then enter enough of the word to make it
1506d1485
< FIXME: setting shell prompt.
1543,1547d1521
< <item> If the <package>dwww</package> is installed, the
< <tt>man</tt>, <tt>info</tt> and
< <tt>/usr/doc/<var>package</var></tt> pages can be read
< with a web browser from http://localhost/dwww.
<
1674,1676d1647
< FIXME: There should be reference to instructions on how to
< use IRC, and perhaps a recommendation which of the many IRC programs
< in Debian to use.
1761,1762c1732
< <p> /var/log/*, dmesg, uname -a
< FIXME: this is incomplete.
---
> <p> /var/log/*, dmesg, uname -a
1811,1813d1780
< FIXME: The PATH above has same directories twice, has "/home/hp/.bin"
< where the dot is wrong(?) and has current directory which may be
< risky.
1818,1819c1785
< system. For example, the <tt>EDITOR</tt> and <tt>VISUAL</tt>
< variables let you
---
> system. For example, the <tt>EDITOR</tt> variable lets you
1924c1890,1891
< their <em>parent process</em>.
---
> their <em>parent process</em>.
>
2148c2115
< <p>FIXME: Stdin, stdout, pipelines, and redirection
---
> <p>Stdin, stdout, pipelines, and redirection
2245,2246c2212
< commands <p>FIXME: "modifiers" like batch, at, nohup, nice,
< sleep
---
> commands <p>"modifiers" like batch, at, nohup, nice
2269,2270c2235
< ls /etc/rc0.d /etc/rc1.d /etc/rc2.d /etc/rc3.d \
< /etc/rc4.d /etc/rc5.d /etc/rc6.d /etc/rcS.d
---
> ls /etc/rc0.d /etc/rc1.d /etc/rc2.d /etc/rc3.d /etc/rc4.d /etc/rc5.d /etc/rc6.d /etc/rcS.d
2493c2458
< (user, group, others) makes a total of 27 combinations.
---
> (user, group, others) makes a total of nine combinations.
2867,2868c2832
< for the X Window System (graphical version of GNU Midnight
< Commander, <tt>gmc</tt>).
---
> for the X Window System.
3058c3022
< adjacent on the home row of the keyboard, and thus
---
> adjacent on on the home row of the keyboard, and thus
3069c3033
< <tt>hjkl</tt> keys. If you try to move too far in
---
> <tt>hjkl</tt> keys. If you try to move to far in
3231d3194
< Or refer to man or info page?
3460d3422
< FIXME: the \key{} things should be something else.
3474,3476d3435
< <p>FIXME: Refer to National HOWTO's, like Danish, Finnish,
< French, German etc.
<
3480c3439
< these are hidden and out of your way while you do your
---
> these are hidden and out of your way while you do you
3544,3546c3503
< tricks. <p>describe <tt>umask</tt>
< FIXME: Setting shell prompt PS1, perhaps here or sooner in
< this document.
---
> tricks. <p>describe <tt>umask</tt>
3572d3528
< FIXME: Reference to section where VC's were explained.
3579,3580d3534
< FIXME: Why recommended? I think it is risky, I only use xdm
< when I am very certain that everything is OK.
3681,3683d3634
< FIXME: Not good to refer to specific stores, they are not
< relevant on the opposite side of the globe. At least use only stores
< that have Web page and can deliver all over the world.
3937c3888
< string GNU, you type:
---
> word GNU, you type:
4029,4030c3980
< FIXME: perhaps clarify when you list all the possible matches, and
< when only a sample.
---
>
4083,4084d4032
< Reference to System Administrator's Manual, chapter Backup and
< Restore.
4127,4129c4075
< <item> <tt>cd; cp /etc/profile ./mysamplefile</tt>
< FIXME: Why the ./ in the filename? It is not needed.
< <p>
---
> <item> <tt>cd; cp /etc/profile ./mysamplefile</tt> <p>
4420a4367
>
4432c4379
< most common on PC platforms. Your DOS/Windows <tt>C:\</tt> partition
---
> most common. Your DOS/Windows <tt>C:\</tt> partition
4453a4401
>
4491,4492c4439
< Debian. You'll need to be root to do this (unless
< <tt>/etc/fstab</tt> allows ordinary users to mount), so be careful;
---
> Debian. You'll need to be root to do this, so be careful;
4509,4513c4456
< to make one using <tt>mkdir /cdrom</tt>. <footnote>
< If the <tt>/cdrom</tt> directory existed, and was not
< empty, those files that were there will not be accessible while the CD
< is mounted there. They are there again when the CD is unmounted,
< however.</footnote>
---
> to make one using <tt>mkdir /cdrom</tt>.
4710,4712d4652
< Add users to <tt>floppy</tt>, <tt>cdrom</tt> and <tt>disk</tt>
< groups, devices group owned by the corresponding group and group can
< read and write.
4733,4735d4672
< <p>FIXME: Networking better in Network Administrator's
< Manual. Not possible to set it up without root permissions anyway.
<
4747,4748d4683
< <p>Not for ordinary users.
<
4764,4765c4699,4700
< are deleted. However, if another program you still have on the
< system also needs those files, you want to be sure you keep them.
---
> are deleted. However, if a program you still have on the
> system needs those files, you want to be sure you keep them.
4799c4734
< getting both versions installed.
---
> installing both versions at once.
5195c5130
< put something into the pipe, and it comes out the other
---
> put something into the file, and it comes out the other
5215,5217d5149
< You can check this with <tt>ls -l mypipe</tt>,
< it should show <tt>p</tt> in the first column to signify that the file
< is a FIFO.
5385,5390d5316
<
< <p>Copy a directory tree to another location:
< <example>
< cd directory1
< tar cf - . | ( cd /some/path/to/directory2 ; tar xpBf - )
< </example>
5400d5325
< FIXME: Is a Tutorial a good place for compiling kernel?
5441,5444d5365
< <p>FIXME: Yes, this would be useful. With 2500 applications it
< is not reasonable to examine them all with dselect to identify the
< ones you want.
<
5522,5523c5443
< drive (if boot order is set so in the BIOS).
< If it finds one, it looks for a "boot sector" on
---
> drive. If it finds one, it looks for a "boot sector" on
5602d5521
< Or better yet, in System Administrator's manual.
5667,5669c5586
< lower prices. Solaris 7 is available for the cost of media,
< shipping and handling for non-commercial use, see
< http://www.sun.com/solaris/freesolaris.html .
---
> lower prices.
5735,5740c5652,5653
< <item>Ian Jackson led Debian from January 1998 until
< February 1999.
<
< <item>Wichert Akkerman was elected leader in February
< 1999.
<
---
> <item>Ian Jackson led Debian from January 1998 until the
> present
Reply to: