[Pkg-doc-linux-devel] Linux-FAQ and Debian bug#119942

[Colin Watson]

On Sun, Sep 14, 2003 at 03:35:56PM -0600, doug jensen wrote:
> In an attempt to close bug #119942, I would like to send the attached
> changes to the Linux-FAQ maintainer.

Thanks!

> The original bug report just asked for changing the FTP URLs, however,
> the Linux-FAQ has since been revised and the section numbers have
> changed.  Also, the maintainer has made at least one attempt to fix,
> but it still isn't quite right.  Maybe I shouldn't be changing the
> text while trying to close bugs?

If you have good ideas for the upstream author then I don't see a
problem. The only thing to watch out for is overloading the author with
too many suggestions so that the bug you're actually interested in
doesn't get fixed. :)

> Change:
> 
> Debian GNU/Linux is being ported to Alpha, Sparc, PowerPC, and ARM platforms.
> There are mailing lists for all of them. See http://www.debian.org/
> MailingLists/subscribe
> 
> To:
> 
> Debian GNU/Linux has ports to Alpha, Sparc, Motorola 68k, PowerPC, ARM,
> IBM S/390, MIPS, HP PA-RISC, and IA-64.  Ports to SuperH and amd64 are
> being developed.  Also, Debian is being ported to other non Linux
> kernels including GNU/Hurd, GNU/NetBSD, and GNU/FreeBSD.  There are
> mailing lists for all of them.  See http://www.debian.org/MailingLists/
> for general information, then follow the "subscription" link, and find the
> mailing list you are interested in.
> 
> [*Note for doc-linux team*]
> 
>    The last SuperH updates I saw were in 2001.  The only mailing list activity
>    in 2003 has been spam.  As a side note GNU/win32 also looks dead.
>    SuperH was put in, the paragraph above, because it is on the Debian
>    "ports" web page, should SuperH be included in the paragraph?

I'd drop SuperH for the moment, I think. Otherwise, fine.

> Change:
> 
> Installing Debian GNU/Linux takes 500Mb1GB,
> 
> To:
> 
> Installing a small Debian Gnu/Linux workstation takes from 500Mb to 1GB,

Yes, although "GNU" rather than "Gnu".

> Add at end:
> 
> A fully installed Debian GNU/Linux system could uses several Gigabytes
> of disk space.

s/uses/use/

> -----------------------------------------------------------------------------
> Change:
>        Connect using anonymous FTP to ftp.debian.org and cd to the pub/debian/
>     dists/stable/main/disks-i386/current/ subdirectory.
> To:
>        Connect using http://ftp.debian.org/ and cd to the
         ^^^^^^^^^^^^^ "Connect to"

> To:
>   * Choose the images-*/ subdirectory that matches the type of floppy drive
>     installed on your machine, if unsure try images-1.44/.  Retrieve the
>     rescue.bin, root.bin, and driver-*.bin disk images.  Once you have
>     install those floppy images, the rest of the system can be retrieved
      installed

> -----------------------------------------------------------------------------
> Q: How To Upgrade/Recompile a Kernel
> 
>  $ depmod -a                                                                 
> 
> This command can be run automatically at boot time. On Debian/GNU Linux
> systems, the command is part of the /etc/init.d/modutils script, and can be
> linked appropriately in the /etc/rcx.d/ directories. For more information on 
> depmod, see the manual page.
> 
> [*Note for doc-linux team*]:
> 
>    Not sure what to do here, would it be appropriate to remove that
>    reference to Debain, and/or add:

I'd leave it there, it's helpful.

> A:  On Debian GNU/Linux systems, get a kernel source package from the
> Debian archive or from a Debian GNU/Linux CD and follow the directions
> in the README file that is located in the kernel-package subdirectory.

That might well be useful, although it could be made clear that it's
just an option.

Cheers,

-- 
Colin Watson                                  [cjwatson@flatline.org.uk]