SF.net SVN: jazzplusplus: [559] web/htdocs/faq/index.php

[<pst...@us...>]

Revision: 559
          http://jazzplusplus.svn.sourceforge.net/jazzplusplus/?rev=559&view=rev
Author:   pstieber
Date:     2008-05-23 17:18:25 -0700 (Fri, 23 May 2008)

Log Message:
-----------
Applied a slightly modified version of a patch provided by Donald B. Moore.
Donald's changes:
Adds initial content to new FAQ website area.
Pete's changes:
Reformatted the page.

Modified Paths:
--------------
    web/htdocs/faq/index.php

Modified: web/htdocs/faq/index.php
===================================================================
--- web/htdocs/faq/index.php	2008-05-22 18:16:07 UTC (rev 558)
+++ web/htdocs/faq/index.php	2008-05-24 00:18:25 UTC (rev 559)
@@ -15,8 +15,117 @@
 </TD>
 <TD class="mainCopy">
 <H2>Jazz++ FAQ</H2>
+<p>
+Here you will find some of the most Frequently Asked Questions that the Jazz++
+team get asked by Jazz++ users, along with helpful answers to those questions.
+</p>
+<p>
+This area is broken down into two parts --
+</p>
+<p>
+The User FAQ deals with general user questions regarding the operation and use
+of Jazz++ itself.
+</p>
+<p>
+The Developer FAQ deals with specific questions related to the Jazz++ code
+itself, and possible problems when compiling/using that code on the
+platforms/OS' currently supported by Jazz++.
+</p>
+
 <H3>User FAQ</H3>
+<p>
+
+</p>
+
 <H3>Developer FAQ</H3>
+<p>
+<b>Q.</b> When I run configure, I get the following error...
+</p>
+<p>
+<b>A.</b> If you are trying to build/compile Jazz++ from sourcecode tarball or
+the Jazz++ svn repository, you may encounter one or more of the following
+errors.  Check through this list of errors below and see if the error message
+you've encountered has already been noted before emailing the Jazz++
+developers about these sorts of problems.  These are typically <u>not</u>
+problems with Jazz++ or the Jazz++ source itself, but usually more indicative
+of a problem with the 'host' computer system software setup.
+</p>
+<p>
+<b>Error:</b>
+</p>
+<pre>
+../jazz/configure: line 4844: AC_PROG_LIBTOOL: command not found
+
+configure.ac:44: error: possibly undefined macro: AC_PROG_LIBTOOL
+If this token and others are legitimate, please use m4_pattern_allow.
+See the Autoconf documentation.
+autoreconf: /usr/bin/autoconf failed with exit status: 1
+</pre>
+<p>
+<b>Problem:</b>  The <tt>libtools</tt> package is not installed.
+</p>
+<p>
+<b>Likely Cause:</b>  [linux] 'desktop' installation, SDK not installed
+</p>
+<p>
+<b>Solution:</b>  Install the <tt>libtools</tt> package and retry
+</p>
+<p>
+During the installation stage of most all Linux based distributions, the
+person installing the system is given a choice as to what sort of system
+they would like to install.  Typically the choices are something like
+'Server', 'Desktop', and 'Work Station'.  The linux SDK (software developers
+kit) is *NOT* routinely installed as part of a standard 'Desktop' type linux
+installation, and this is true for most all mainstream linux distributions.
+However the SDK *IS* routinely installed by most linux distributions when the
+'Work Station' install option is selected, and this is how some people end up
+with the SDK and others not...who end up seeing this sort of error.  It's not
+a problem - you don't have to reinstall everything, you just need to add
+the SDK packages.
+</p>
+<p>
+Adding the SDK packages is where some people have problems.  The linux SDK
+is a -collection- of packages, not just a single package.  That said, there is
+a 'single' package entry in most linux distribution 'package managers' which
+is itself a 'meta-package' containing a list of the packages needed to be
+installed to have a complete SDK installed.  Some people make the mistake of
+installing the GCC package onto their system, thinking this is the SDK itself
+(or that the other required packages of the SDK will be installed as
+dependancy packages).  In actuality, GCC is both a part of the overall SDK
+-and- a valid stand-alone installation target, so installing it won't pull in
+any other the other required SDK packages at all.
+</p>
+<p>
+TODO: add SDK meta-package names for various linux distros
+</p>
+<p>
+<b>Error:</b>
+</p>
+<pre>
+Project.o: In function `JZProject':
+/home/auser/Build/JazzBuild/src/../../jazz/src/Project.cpp:167:
+undefined reference to `tAudioPlayer::tAudioPlayer(JZSong*)'
+/home/auser/Build/JazzBuild/src/../../jazz/src/Project.cpp:167:
+undefined reference to `tAudioPlayer::tAudioPlayer(JZSong*)'
+collect2: ld returned 1 exit status
+</pre>
+<p>
+<b>Problem:</b>  ALSA library headers missing, Alsa-dev package not installed
+</p>
+<p>
+<b>Solution:</b> Install ALSA development package and retry.
+</p>
+<p>
+Most linux distributions do not defaulty install all 'development' packages.
+These development packages contain all the runtime library header (and
+sometimes 'C' code) files needed for other programs (like Jazz++) to compile.
+Jazz++ depends on the ALSA API function declarations to build on linux, so you
+need to install this package before attempting to compile Jazz++ from source
+tarball or the svn repository.
+</p>
+<p>
+TODO: add ALSA devel package names for various linux distros
+</p>
 <?php
 require_once('../include/footer.php');
 ?>


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.