[prev in list] [next in list] [prev in thread] [next in thread] 

List:       amanda-users
Subject:    Re: ...finally seem to have tapeless operation working...
From:       Adam Haberlach <adam () newsnipple ! com>
Date:       2001-11-28 21:05:31
[Download RAW message or body]

On Wed, Nov 28, 2001 at 12:58:08PM -0500, Jon LaBadie wrote:
> On Wed, Nov 28, 2001 at 06:24:32AM -0500, Joshua Baker-LePain wrote:
> > On Tue, 27 Nov 2001 at 4:09pm, someone else wrote
> > 
> > > Is there any chance that real documentation (other then the FAQ-O-MATIC)
> > > will ever be produced for Amanda?  I had a hell of a time figuring things
> > > out, and I'm far from stupid.
> > 
> > Err, do you mean beyond docs/INSTALL and "the chapter" at 
> > www.backupcentral.com?  Those got me going, along with this list.
> > 
> >>> End of included message <<<
> 
> I'm getting testy in my senior years.  But it annoys me that many
> pre-packaged amanda's do not supply the docs provided in the source
> and/or new users do not look for them.
> 
> I just took a look at my amanda distribution tree.
> 
> 	100+ Kb  of man pages under "man" dir
> 	100+ Kb  of sample config files under "example" dir
> 	200+ Kb  of how-to and other information under "docs" dir
> 
> Could they be better/extended/updated?  Sure.  And as Joshua wrote:
> 
> > All that having been said, and in the true OSS tradition, feel free to 
> > write more/better documentation.
> 
> Or code :))

	Well, the code is already quite readable.  My main complaint is that the
online resources (other then "The Book", which seems to be better now that
I've looked at it a bit) are pretty scattered and hard to get to from the
www.amanda.org site.

	I also don't like the reliance on sample configs, especially when they
say "This config won't work without being modified" at the top.

	I don't have any easy solutions at the moment, but I found myself using
Google way too much to find information from all sorts of places in order
to get things working.   I'll keep it in mind and maybe work on putting
together something a little better, in my copious spare time.


-- 
Adam Haberlach     | Computer science has the unfortunate characteristic
adam@newsnipple.com| that many of the pioneers of the field are still
                   | alive and doing research.
                   |        -- Adam Rifkin

[prev in list] [next in list] [prev in thread] [next in thread]