2002-08-26 04:09:02

by John D. Coleman

[permalink] [raw]
Subject: I have a question about packages of programs

as in all the *.gz files that I've been grabbing from GNU and other
places.

NOTE: This email is primarily addressed to the ncurses maintainer(?)
because I liked it's documentation much better. But everyone else can
read this also.

Now, I don't know if you wrote the ncurses package or not. I found your
email address from the README.glibc file in ncurses-5.2.tar.gz

I'm new to Linux and still don't know that much about it and I used a
Slackware installation as a base from which to compile my own custom
Linux by following the information found at Linux From Scratch. Which,
in a way, is great because it is forcing me to read a LOT of
documentation about the programs that make up Linux.

I know that Linux is a 'work in progress' project but *what I really
want to know is* : Would it be too much to ask of the writers of these
programs to include in the README file or elsewhere :(1) a description
of the program, (2) A listing of the files installed, (3) A listing of
the files that are required to be present for the correct operation of
their program(s) ? A brief installation procedure followed by details of
variances of the installation procedure would be very nice also rather
than having it scattered throughout a loooong README file as is done in
the Linux Kernel README file. BTW Linux kernel - the documentation for
devfs REALLY sucks ! I can't log in as 'root' now but I can via a 'su'
from a normal user. 'Illegal login from tty1'. I'll just remove the
devfsd and reboot. That experiment failed. There was still too much
clutter in /dev anyway. I'll just see what happens if I delete unused
devices in /dev.

I've noticed that the docs in several packages like to include
instructions for how to compile a kernel. I really wish that they would
stop doing that as their instructions quickly become outdated. If the
kernel needs, or might need, to be recompiled then a reference to the
kernel sources should be all that is required. Anything else is just too
much clutter and a waste of file space on the internet's servers.

Man pages many times lists required files but they don't always list
EVERY one ! It's a pain to read the man pages of programs such as bash,
not find any references to some files that I just happen to stumble
across while reading about an entirely different program.

For instance, and the file names probably are not correct :
Say I read bash's man page because I have a problem with bash.
Then I read ncurses man page which has a reference to a file called
/etc/motd.issue that is required by bash to do something.
I then create the file /etc/motd.issue and that solves my problem.
The kicker is : I never saw a reference to the file while reading bash's
man page !
Maybe bash supposedly doesn't need that file but making it fixed the
problem.

Yes I know : 'Newbies should not be trying to compile software'. I'm no
way , no how, a newbie to computers. Just Linux. Decent documentation
should make software compilation a snap.

Sorry. I am NOT going to volunteer to rewrite documentation for programs
that you maintain. Because my first project is going to be a major
overhaul of the make and/or automake programs. That ./configure
--prefix=whatever -- src=here command-line-only-interface has got to go.
Having to read upwards of ten or more different documents, scattered in
what could be several subdirectories, just to find out what all of the
configure switches are is a real pain in the butt. Is anyone out there
using anything other than a CRT/monitor with Linux nowadays to compile
programs ?

Compiling and starting 'X' went pretty easy. I just followed
instructions.

GRIPE MODE OFF



2002-08-26 14:04:12

by Rik van Riel

[permalink] [raw]
Subject: Re: I have a question about packages of programs

On Mon, 26 Aug 2002, John D. Coleman wrote:

> want to know is* : Would it be too much to ask of the writers of these
> programs to include in the README file or elsewhere :(1) a description
> of the program, (2) A listing of the files installed, (3) A listing of
> the files that are required to be present for the correct operation of

While I'd like to see this kind of stuff too, it IS too much
to ask.

These programs have been provided to the world for free, without
any warranty or anything else. This means nobody has the right
to "demand" support. You're free to ask nicely, of course ;)

> Sorry. I am NOT going to volunteer to rewrite documentation for programs
> that you maintain. Because my first project is going to be a major
> overhaul of the make and/or automake programs. That ./configure
> --prefix=whatever -- src=here command-line-only-interface has got to go.

Ambitious plan, though I hope the command-line interface will
stay since I use it on an almost daily basis to build RPMS
automagically ;)

regards,

Rik
--
Bravely reimplemented by the knights who say "NIH".

http://www.surriel.com/ http://distro.conectiva.com/

2002-08-26 14:09:24

by Hell.Surfers

[permalink] [raw]
Subject: RE:I have a question about packages of programs

We dont make the distros, just the kernel, you will learn to do stuff better, however .config stuff does suck, learn c then suggest a better idea, as one of kurt cobains friends said once"we only make music, dont know nuthin else" and config is a gcc thing, we only do thekernel...



On Mon, 26 Aug 2002 00:10:47 -0400 "John D. Coleman" <[email protected]> wrote:


Attachments:
(No filename) (5.13 kB)

2002-08-26 14:29:18

by Tomas Szepe

[permalink] [raw]
Subject: Re: I have a question about packages of programs

> Because my first project is going to be a major
> overhaul of the make and/or automake programs. That ./configure
> --prefix=whatever -- src=here command-line-only-interface has got to go.

Rik was more than polite in his response to this paragraph.
My comment would be more to the point of "Don't judge stuff
until you've understood it."

> Having to read upwards of ten or more different documents, scattered in
> what could be several subdirectories, just to find out what all of the
> configure switches are is a real pain in the butt. Is anyone out there
> using anything other than a CRT/monitor with Linux nowadays to compile
> programs ?

Yes. Serial terminals, telnet sessions, hercules monitors serving as
secondary heads, ... And believe it or not, lots of people prefer the
classic VGA 80x25 textmode to do their work even on high-end 21" screens.
In fact anyone who's tried to convince me that having white background
all over the userland (Hello MS Visual C GUI) is actually _ergonomic_
failed miserably. (Ever had a headache from staring into high res graphics
with bright backgrounds? Suppose you've had, just like everyone else.)

T.

2002-08-26 15:32:14

by Phil Jackson

[permalink] [raw]
Subject: Re: I have a question about packages of programs

On Mon, Aug 26, 2002 at 12:10:47AM -0400, John D. Coleman wrote:

> Because my first project is going to be a major
> overhaul of the make and/or automake programs. That ./configure
> --prefix=whatever -- src=here command-line-only-interface has got to go.

If it's going to be your first project then you going to have to learn
how to use the autotools before you "overhaul" them, the trouble is
the more you use them the more you'll realise they don't need
overhauling. Catch 22.

Phil

2002-08-26 19:37:08

by Gerhard Mack

[permalink] [raw]
Subject: Re: I have a question about packages of programs

On Mon, 26 Aug 2002, Phil Jackson wrote:

> Date: Mon, 26 Aug 2002 16:32:05 +0100
> From: Phil Jackson <[email protected]>
> To: [email protected]
> Subject: Re: I have a question about packages of programs
>
> On Mon, Aug 26, 2002 at 12:10:47AM -0400, John D. Coleman wrote:
>
> > Because my first project is going to be a major
> > overhaul of the make and/or automake programs. That ./configure
> > --prefix=whatever -- src=here command-line-only-interface has got to go.
>
> If it's going to be your first project then you going to have to learn
> how to use the autotools before you "overhaul" them, the trouble is
> the more you use them the more you'll realise they don't need
> overhauling. Catch 22.


I forget what project it was but I saw a GUI that created a script and
loaded configure with the correct options. It worked rather nicely and no
overhaul needed.

Gerhard

--
Gerhard Mack

[email protected]

<>< As a computer I find your faith in technology amusing.