[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Bacula-devel] Bacula documentation


On Friday 03 October 2008 20:46:38 Hemant Shah wrote:
> --- On Fri, 10/3/08, Kern Sibbald <kern@xxxxxxxxxxx> wrote:
> > From: Kern Sibbald <kern@xxxxxxxxxxx>
> > Subject: Bacula documentation
> > To: "Hemant Shah" <hjrrs@xxxxxxxxx>
> > Cc: "bacula-devel" <bacula-devel@xxxxxxxxxxxxxxxxxxxxx>, "bacula-users"
> > <bacula-users@xxxxxxxxxxxxxxxxxxxxx> Date: Friday, October 3, 2008, 4:09
> > AM
> > Hello,
> >
> >   "  I am not sure how the manual is generated, maybe
> > adding version in
> >      paranthesis after the option would be easy:
> >
> >     e.g.  IgnoreDir (V3.0.0)
> >
> >     This way you only have to maintain one manual and if
> > someone is reading a
> >      manual and is using older version, he/she can easily
> > make a decision
> >      whether he/she should upgrade to the new version in
> > order to use the new
> >      option. "
> >
> >
> > I never cease to be amazed how easy it is to use the words
> > "would be easy",
> > when yes, it is easy, but it is terribly time consuming.
> >
> > After about two hours of working with LaTeX, I have put up
> > a version of the
> > Concepts manual that has the version in the header on each
> > page.   I
> > personally prefer the old way of doing it, but if a
> > majority of users prefer
> > seeing the version on each page, I will leave it.  Note,
> > however, that
> > this "easy" task will undoubtedly take another
> > 4-6 hours to implement in all
> > the 7 Bacula manuals in each of the three languages.
> >
> > If I don't hear some significant positive response for
> > this new format, I will
> > put it back to the old format (section and chapter) in the
> > next couple of
> > days.
> >
> > If anyone is tempted to make additional proposals, I will
> > be happy to consider
> > them, but if you want them to be implemented, please
> > include a note along
> > with your proposal that says you will implement it, and
> > supply a patch that
> > corrects our English, German, and French manuals.
> >
> > Best regards,
> >
> >
> > Kern
> >
> > PS: Please, when responding to my Status messages, start a
> > new thread, or at a
> > minumum do not include the French language email list in
> > your response -- it
> > just floods them with English that not all of them
> > understand.  Thanks :-)
>
> Folks,
>
>   I did not intend to invoke such strong emotions about this. As I had said
> that I was not aware of how the manuals were generated, I also use Latex
> and I know it is be very difficult to maintain latex files.

Sometimes email comes across too strong.  I didn't have any strong emotions 
about this, I am just short on time so I type fast, and I wanted to clarify 
the situation.  Some times I do get the feeling that people forget that we do 
this all day for free, and that Bacula is far bigger than we can handle 
alone ...

>
> Actually, right now I am trying to install TexLive 2008 on one of the
> systems.
>
>   I always liked how IBM would add the version number besides the options.
> I run several versions of the software on our systems and it is always easy
> to read the manual and see if the option was supported on a particular
> version where I was trying to fix the problem. The release notes has so
> much other information and I do not read it more than once.

Yes, I agree, their manuals are really nice.  I have a good number here, but 
take a look at the size of the team that they have for each manual.   Some 
day, when the Bacula professional company does 2 Billion dollars of buisiness 
I hope we will have manuals that match IBM's  :-)

>
>   I would love to help out but we recently downsized and I am the only one
> to maintain 30 servers and 50 workstation over 2 continents.

Good luck.

Kern
>
>
> Hemant Shah
> E-mail: hjrrs@xxxxxxxxx



-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________
Bacula-devel mailing list
Bacula-devel@xxxxxxxxxxxxxxxxxxxxx
https://lists.sourceforge.net/lists/listinfo/bacula-devel


This mailing list archive is a service of Copilotco.