[bt-devel] Re: [Task #32187] reorganize docs

[fred]

mg.pub@gmx.net wrote:

> > Yes  I was thinking about reorganizing the installation instructions.  If
> > installation of qt, kde and sword are covered properly in their install
> > files,  we might not need  such detailed instructions in our general
> > installation instructions.
>
> Yes! That's very right. People will only need this info if they compile
> themselves anyway... KDE/QT are normally covered by the distros
> making the install very simple too. If they compile KDE/QT they can
> use their INSTALL instructions.
> Using the BT rpm is much more simple.
>
> I see you refer to the INSTALL file. Is this where you want the
> installation instructions to go to?

No however it seems that most linux software has a file INSTALL in the top level of the zipped up source.  it would be ok if all this file has is
an instruction to see the handbook.  This would be for somone that has not looked at bibletime and is trying to use the sources.  Can we assume
that the RPM's will eventually fix things like the pointer to libsword.so and the etc/sword.conf files?  These actually would belong in the sword
RPM, unless a combined sword/bibletime rpm is created.

This question about what will be in the RPM's still seems like an open question, which will not be solved untill Brook figures out what works.  I
think is is possible to take two source rpm's and run RPM on them to produce a combined rpm which contains both.  This is not the same as
compiling in kde and so on.

Fred


>
> An alternative might be to have a link in this file pointing to the
> install section of the handbook. That might be easier to administer.
>
> Martin
>
> > See below for my file rough out (it is only started and probably has
> > mistakes
> > in it).  Please only look at it in a general sense.
> >
> > Fred
> > ---------------
> > XML mixed with Text file follows:
> > ---------------
> > Installation of Bibletime
> > <para>Bibletime is provided in many forms.  We hope that one of these will
> > support your system.
> > At this time we only support linux (and unix when you compile it
> > yourself).</para>
> >
> > <table>
> > <title>Bibletime Program File Availability and Requirements</title>
> > <tgroup cols=4>
> > <thead>
> > <row>
> > <entry>filename</entry>
> > <entry>Distribution</entry>
> > <entry>Requirements</entry>
> > <entry>description</entry
> > </row>
> > </thead>
> > <tbody>
> > <row>
> > <entry>bibletime_mdk</entry>
> > <entry>Mandrake 7.2</entry>
> > <entry>qt2, KDE2, sword</entry>
> > <entry>qt2, KDE2 are provided with the distribution</entry>
> > </row>
> > <row>
> > <entry>bibletime.tar.gz</entry>
> > <entry>unlisted distributions or unix</entry>
> > <entry>kde2, qt2, compiler, make, sword</entry>
> > <entry>This is the compile it yourself version, it will support any
> > system able to run kde2 and qt2</entry> </row>
> > <row>
> > <entry>bibletime_qt_kde.tar.gz</entry>
> > <entry>non-kde intel system, sword</entry>
> > <entry>requires an xwindows display</entry>
> > <entry>This file is intended for systems that do not have qt2 and kde2
> > installed</entry>
> > </row>
> > <row>
> > <entry></entry>
> > <entry></entry>
> > <entry></entry>
> > <entry></entry>
> > </row>
> > </tbody>
> > </table>
> >
> > Supporting Programs
> > Determination of presence of supporting programs.
> > <para>Start your package manager.  Search for package qt.  If the package
> > description indicates that the version of qt on your system is 2.x.x (any
> > version of qt 2) then qt is correct.</para>
> > <para>Now search for package KDE.  If the package manager indicates that
> > any
> > version of KDE2 is installed, then your is correct.</para>
> > <para>If qt and kde are not correct, you can download and install qt2 and
> > kde2
> > (in
> > that order) or you can use the version of bibletime with qt2 and kde2
> > compiled
> >
> > in.</para>
> > <para>Now check to see if sword is installed on your system.  This is done
> > by
> > looking
> > at /usr/local/sword If the directry is not present, sword will need to be
> > installed.  Sword is not provided with any distributions at this time, so
> > unless
> > you have prevously installed it you probably will not find it.</para>
> >
> > Installation of supporting programs
> >
> > qt2
> >
> > <para>If you install your qt2 from an rpm, nothing more needs to be
> > done.</para>
> > <para>If you install qt2 from a troll tech source, you will need to unzip
> > the
> > file
> > (using somthing like gnozip) and follow the directions in the file
> > INSTALL.</para>
> >
> > kde2
> >
> > <para>If you install your kde2 from an rpm, nothing more needs to be
> > done.</para>
> > <para>If you install kde2 from the source or CVS at kde.org, you will need
> > to
> > follow the installation directions for the file.</para>
> >
> > sword
> >
> > <para>If you install your sword from an rpm, nothing more needs to be
> > done.</para>
> > <para>If you install sword from the source or CVS at kde.org, you will
> > need to
> >
> > follow the installation directions in the INSTALL file.</para>
> >
> > environment variables
> > <para>in a bash shell, issue the command export, you will see a listing
> > like this:</para>
> > <Screen>declare -x KDEDIR="/usr"
> > declare -x KDE_INITIAL_DESKTOP="1"
> > declare -x LANG="en"
> > declare -x LANGUAGE="en_US:en"
> > declare -x LC_COLLATE="en_US"
> > declare -x LC_CTYPE="en_US"
> > declare -x LC_MESSAGES="en_US"
> > declare -x LC_MONETARY="en_US"
> > declare -x LC_NUMERIC="en_US"
> > declare -x LC_TIME="en_US"
> > declare -x LD_LIBRARY_PATH="/home/fks00/.kde/lib:/usr/lib"
> > declare -x
> >
> PATH="/bin:/usr/bin:/usr/bin/X11:/usr/local/bin:/usr/X11R6/bin:/usr/games:/home/fks00/bin:/usr/X11R6/bin:/usr/games:/usr/X11R6/bin:/usr/games"
> >
> > </screen>
> > <para>Examine this file these items must be set:</para>
> > QTDIR=
> > KDEDIR=
> > KDEDIRS=
> > <para>Also these items must be in your path command.  If see error
> > messages
> > durring the installation (or if bibletime is missing pieces, the most
> > likely
> > cause is improperly set environmental variables:</para>
> >
> > Setting environmental variables.
> >
> > In a bash terminal in mandrake 7.2 use these commands (if you are using
> > another
> > distribution, or installed qt or KDE2 from a source, you will need to
> > figure
> > out
> > the path names youe self):
> >
> >
> >
> >
> > Installing bibletime
> >
> > <para>If you install your bibletime from an rpm, nothing more needs to be
> > done.</para>
> > <para>If you install bibletime from the source or CVS at sourceforge, you
> > will
> >
> > need to follow the installation directions in the INSTALL file.</para>
> >
> >
> >
> >
> >
>
> --
> Machen Sie Ihr Hobby zu Geld bei unserem Partner 1&1!
> http://profiseller.de/info/index.php3?ac=OM.PS.PS003K00596T0409a
>
> --
> GMX - Die Kommunikationsplattform im Internet.
> http://www.gmx.net