Menu
▾
▴
SF.net SVN: jazzplusplus: [540] web/htdocs
|
From: <pst...@us...> - 2008-05-17 21:36:07
|
Revision: 540
http://jazzplusplus.svn.sourceforge.net/jazzplusplus/?rev=540&view=rev
Author: pstieber
Date: 2008-05-17 14:36:05 -0700 (Sat, 17 May 2008)
Log Message:
-----------
Applied a slightly modified version of a patch provided by Donald B. Moore.
Donald's changes.
1. Added GDB intro/plug, email pointer, obtrusion of thanks
to bugreports page.
2. Changed wording on the Subversion page.
3. Reworked download content to properly document the existence of
'a non-release tarball release' being available via sourceforge.
4. Reworded some tex2rtf content.
Pete's changes.
1. I removed the div tag at the beginning of the bug reports page.
2. I removed the OL tags from the bug reports page.
3. Changed gdb support for all three to 2 out of 3. The Visual
Studio builds are not supported by gdb.
4. Added a link to the source forge bug tracker.
5. Changed some break tags to paragraph tags.
6. Wrapped lines at 80 columns to help poor souls that might edit
on a terminal.
Modified Paths:
--------------
web/htdocs/bugreports/index.php
web/htdocs/download/index.php
web/htdocs/subversion/index.php
web/htdocs/tex2rtf/index.php
Modified: web/htdocs/bugreports/index.php
===================================================================
--- web/htdocs/bugreports/index.php 2008-05-17 20:36:59 UTC (rev 539)
+++ web/htdocs/bugreports/index.php 2008-05-17 21:36:05 UTC (rev 540)
@@ -93,15 +93,15 @@
So if you are going to email us a bug or test report, start your email by
including this 'common' information first. Here is a bare minimum example
of that;
-<br />
-<br />
+</p>
+<p>
<em>
Hello, I am using Slackware 7.1 on an intel PC. I'm hoping to use Jazz++ with
my Korg M3 keyboard. I don't know much about the MIDI interface, but it does
plug into my computer's USB port. I have updated my version here, and it says
"At revision 523."</em>
-<br />
-<br />
+</p>
+<p>
It might not look like much, but this tells the Jazz++ developers a good many
things about your hardware/software situation. It helps. Next, you would
include some specifics regarding what you have found, or the problem you are
@@ -132,8 +132,8 @@
If the problem you are describing relates to the interaction of Jazz++ with
real world MIDI hardware, developers may require some extra information from
you. They will let you know if this is so, and what they need you to do.
-<br/>
-<br/>
+</p>
+<p>
<u>Note:</u> At the time of this writing, (May 2008), the immediate goal of
the Jazz++ developers is to get the code stable and running on all 3 currently
supported platforms, and have it capable of loading and replaying a midi
@@ -143,7 +143,7 @@
to replay a midi composition via an externally connected MIDI capable device
and run into troubles, it might help the development team if you retry the
same operation using your computer's MIDI 'softsynth' setup instead and
-report (in the same email posting) if that solved the issue or not.
+report (preferably in the same email posting) if that solved the issue or not.
</p>
<p>
<u>If the Jazz++ binary you've compiled crashes [SEGFAULT]</u>; Firstly, try
@@ -170,6 +170,12 @@
this might be so.
</p>
<p>
+GDB, the GNU Project debugger, is a widely used software program debugging
+tool. It will run on 2 of the 3 platforms Jazz++ is currently supporting
+(Linux and Mac), and most linux distributions defaultly install gdb as
+part of their respective 'software developers suite' set of packages.
+</p>
+<p>
To create a backtrace using the 'gdb' debugger, go into your
<TT>~/Jazz++/TestInstall/bin</TT> directory, and run your jazz binary with gdb
by issuing the following command;
@@ -234,13 +240,14 @@
Program received signal SIGSEGV, Segmentation fault.
[Switching to Thread 140049561757408 (LWP 4137)]
snd_seq_port_subscribe_set_sender (info=0x7fffdc63f540, addr=0x0) at seq.c:2432
-2432 memcpy(&info->sender, addr, sizeof(*addr));
+2432 memcpy(&info->sender, addr, sizeof(*addr));
(gdb)
</pre>
<p>
-Now, at the (gdb) prompt, issue the 'bt' command - this will generate the backtrace for us ;
+Now, at the (gdb) prompt, issue the 'bt' command - this will generate the
+backtrace for us;
</p>
<pre>
@@ -275,6 +282,17 @@
because invariably you will be asked to do this by the developers anyway if
your bug report is about Jazz++ crashing.
</p>
+<p>
+Once you have finished getting all these bits of information together for us,
+please include them in your report to
+<a name="SourceForge Bug Tracker" href="http://sourceforge.net/tracker/?group_id=104252&atid=637412">
+the SourceForge bug tracker for Jazz++</a>
+</p>
+<p>
+The Jazz++ developers wish to thank all people who contribute to the
+Jazz++ project, by way of bug reports, error reports, or emails telling
+us of their experience - it all counts! Thank You for your support!
+</p>
<?php
require_once('../include/footer.php');
?>
Modified: web/htdocs/download/index.php
===================================================================
--- web/htdocs/download/index.php 2008-05-17 20:36:59 UTC (rev 539)
+++ web/htdocs/download/index.php 2008-05-17 21:36:05 UTC (rev 540)
@@ -16,13 +16,32 @@
<TD class="mainCopy">
<H2>Downloading Jazz++</H2>
<P>
-Currently, only a source tarball is available. You would probably have more
-success attempting to build the source in Subversion. We simply aren't ready
-to produce binary distributions yet. If you still want to give the source tarball
-a try, you first need to create a non-stock build of wxWidgets 2.8.7 to build
-Jazz++. View the <a href="/buildingwx/">Building wxWidgets</a> page for details.
+Currently, only a source tarball is available, It is of limited functionality,
+and many features are as yet unimplemented and/or simply not enabled. It has
+been made available solely as a placeholder for things to come, and
+historically remarks where the current development initiative of the Jazz++
+project started out.
</P>
<P>
+You would probably have more success attempting to build the source obtained
+from our Subversion repository. At the moment, only the source in Subversion
+is truly indicative of the current 'state-of-play' with the Jazz++ code.
+</P>
+<P>
+Simply put -- we aren't ready to produce binary distributions yet, and the
+same goes for release tarballs : there are none, not yet. We encourage people
+to get a little involved, give building the Jazz++ source from our Subversion
+respository a try, and report on what they find. Things like this help
+eventuate release binary and tarball dates, however at present (May 2008) it
+is impossible to accurately predict when in the future these dates might be.
+</P>
+<P>
+If you still want to just give the currently available 'minimal functionality'
+source tarball a try, you will first need to compile and install a non-stock
+build of wxWidgets 2.8.7 to build Jazz++ itself. View the
+<a href="/buildingwx/">Building wxWidgets</a> page for details.
+</P>
+<P>
<A href="http://sourceforge.net/project/showfiles.php?group_id=104252">Download
the Jazz++ source tarball from sourceforge.</A>
</P>
Modified: web/htdocs/subversion/index.php
===================================================================
--- web/htdocs/subversion/index.php 2008-05-17 20:36:59 UTC (rev 539)
+++ web/htdocs/subversion/index.php 2008-05-17 21:36:05 UTC (rev 540)
@@ -29,7 +29,7 @@
</p>
<p>
-The code in the Subversion repository can be unstable at times. Building the
+The code in the Subversion repository can be unstable at times. Building the
code will take a little effort on your part, but we have provided detailed
instructions for building the source code, so this process should also be
possible for "non-developers" to complete successfully.
@@ -38,8 +38,9 @@
<p>
Since Jazz++ is currently in a development state, code from the Subversion
repository is the best place to get the latest fixes and features as they are
-added. Until we reach the point where we are creating binaries to download,
-we hope you will give building Jazz++ from Subversion a try.
+added. Until we reach the point where we are creating binaries for people to
+download, we hope and encourage you to give building Jazz++ from Subversion a
+try.
</p>
<p>
Modified: web/htdocs/tex2rtf/index.php
===================================================================
--- web/htdocs/tex2rtf/index.php 2008-05-17 20:36:59 UTC (rev 539)
+++ web/htdocs/tex2rtf/index.php 2008-05-17 21:36:05 UTC (rev 540)
@@ -68,9 +68,9 @@
the wxWidgets developers list suggests to us that the tex2rtf source may be
removed from wxWidgets altogether at some future time. Even now, the tex2rtf
utility is not defaultly built or installed as part of the current wxWidgets
-installation process....which is unfortunate, because the developers of the
-current Jazz++ project still wish to use this utility for document conversion
-tasks within the current Jazz++ source tree.
+installation process any more....which is unfortunate, because the developers
+of the current Jazz++ project still wish to use this utility for document
+conversion tasks inside the current Jazz++ source tree.
</p>
<h4>Into the future</h4>
<p>
@@ -80,8 +80,8 @@
a short discussion, the current Jazz++ developers decided to investigate
whether it was possible to create a fork of the tex2rtf inside the Jazz++
source tree itself. After consulting with the tex2rtf's original author Julian
-Smart and getting his kind approval and blessings, the tex2rtf utility has now
-become part of the Jazz++ source tree.
+Smart, and obtaining his kind approval and blessings, the tex2rtf utility has
+now become part of the Jazz++ source tree.
</p>
<p>
If you have any questions about tex2rtf, join one of our mailing lists and
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
