leosimons 2002/07/05 01:27:04
Modified: tweety build.xml
tweety/src/xdocs avalon-for-beginners.xml faq.xml
getting-started.xml
tweety/src/conf build.xml
Log:
separate out the main() method into separate class and yet more docs.
Revision Changes Path
1.6 +1 -1 jakarta-avalon-excalibur/tweety/build.xml
Index: build.xml
===================================================================
RCS file: /home/cvs/jakarta-avalon-excalibur/tweety/build.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- build.xml 3 Jul 2002 20:21:03 -0000 1.5
+++ build.xml 5 Jul 2002 08:27:04 -0000 1.6
@@ -59,7 +59,7 @@
<target name="run" depends="compile"
description="Runs the program">
- <java classname="org.apache.avalon.excalibur.tweety.Tweety" fork="true"
dir="." failonerror="true">
+ <java classname="org.apache.avalon.excalibur.tweety.Main" fork="true"
dir="." failonerror="true">
<classpath refid="project.class.path" />
</java>
1.2 +8 -2
jakarta-avalon-excalibur/tweety/src/xdocs/avalon-for-beginners.xml
Index: avalon-for-beginners.xml
===================================================================
RCS file:
/home/cvs/jakarta-avalon-excalibur/tweety/src/xdocs/avalon-for-beginners.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- avalon-for-beginners.xml 27 Jun 2002 16:57:18 -0000 1.1
+++ avalon-for-beginners.xml 5 Jul 2002 08:27:04 -0000 1.2
@@ -9,7 +9,13 @@
</header>
<body>
<s1 title="Introduction">
- <p>TBD</p>
+ <p>Avalon has <b>a lot</b> of documentation (it has a lot of
code, too, but most users
+ don't see this as that much of a problem). It might be
difficult for you to see where
+ you should get started. That's why I wrote this little
document.</p>
+
+ <p>The place you get started is what we call the avalon
framework. This little bit of code
+ (the jar file is about 60k), combined with quite a bit of
documentation, will revolutionize
+ (in time) the way you write software.</p>
</s1>
<s1 title="Table of Contents">
1.3 +35 -2 jakarta-avalon-excalibur/tweety/src/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/jakarta-avalon-excalibur/tweety/src/xdocs/faq.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- faq.xml 3 Jul 2002 20:21:03 -0000 1.2
+++ faq.xml 5 Jul 2002 08:27:04 -0000 1.3
@@ -13,9 +13,42 @@
fix this was to provide an implementation specifically geared
at learning how avalon
works: tweety.</p>
</s1>
+ <s1 title="Why name an avalon container 'tweety'???">
+ <p>"No clues in this fishy. No clues in that fishy."<br /><br />
+ One popular avalon subproject (also a container) is called
Phoenix. It has quite a
+ lot of features (runs multiple applications, classloader
management, isolation,
+ automagically provides management for hosted applications, etc
etc etc). It is also
+ quite difficult to get started with at first.<br />
+ "Phoenix" (among other things) is the name of a powerful
mythological bird. Tweety
+ is the name of a sweet yellow canary. Some of us geeks think it
is funny.</p>
+ </s1>
<s1 title="Will you add feature XXX to tweety?">
- <p>Very unlikely. That would probably increase tweety in size
and complexity, which we
+ <p>"Gimme a 'P', gimme a 'U', gimme a 'D', 'D', 'Y'."<br /><br
/>
+ Very unlikely. That would probably increase tweety in size and
complexity, which we
don't want.</p>
+ </s1>
+ <s1 title="My question is not answered. What do I do?">
+ <p>"Oh goody, goody. A surprise for me."<br /><br />
+ Start by reading the documentation provided. If your question
is not answered
+ there, post a detailed message to the
+ <link
href="http://jakarta.apache.org/site/mail2.html#Avalon">Avalon User list</link>.
+ We will try to help you out.</p>
+ </s1>
+ <s1 title="I followed the instructions in the getting started document,
but Tweety doesn't work. What do I do?">
+ <p>"Aaaah. The poor puddy tat fall down."<br />
+ That's not supposed to happen! Please contact us through the
user mailing list
+ (see above) with detailed information of your system
configuration and what steps
+ you took that led to an error message, and of course the error
message.</p>
+ </s1>
+ <s1 title="Knock it off with the stupid quotes already!!!">
+ <p>"I did! I did taw a puddy tat!"<br /><br />
+ You can find a lot more, along with pictures, icons, sounds,
animations, what
+ have ye, just by typing "tweety" into the google search box.
Just in case you
+ came here looking for just that,
+ <link href="http://www.scally.com/lorrie/tweety.html">this
site</link>
+ will get you started.
+ In case you really can't stand it, go and read our serious
documentation about
+ multi-dimensional separation of concerns 'n stuff!</p>
</s1>
</body>
<footer>
1.3 +22 -2
jakarta-avalon-excalibur/tweety/src/xdocs/getting-started.xml
Index: getting-started.xml
===================================================================
RCS file:
/home/cvs/jakarta-avalon-excalibur/tweety/src/xdocs/getting-started.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- getting-started.xml 3 Jul 2002 20:21:03 -0000 1.2
+++ getting-started.xml 5 Jul 2002 08:27:04 -0000 1.3
@@ -31,9 +31,29 @@
</s1>
<s1 title="Detailed installation instructions">
<p>Please read the <link href="install.html">Install
Document</link>.</p>
+
+ <s2 title="It doesn't work!">
+ <p>"Puddy tat sure doesn't get discouraged."<br /><br />
+
+ Ah. That's bad. Our
+ <link href="faq.html">FAQ</link> will point you to the
avalon-user
+ mailing list where you can contact an avalon expert to
help you out.</p>
+ </s2>
</s1>
<s1 title="Component writing tutorial">
- <p>TBD</p>
+ <p>If you're an experienced programmer, your guide is this:</p>
+ <ol>
+ <li>read our javadocs</li>
+ <li>read the sources for
+ <link
href="http://cvs.apache.org/viewcvs.cgi/jakarta-avalon-excalibur/tweety/src/java/org/apache/avalon/excalibur/tweety/demos/ChirpWorld.java?rev=HEAD">ChirpWorld</link></li>
+ <li>modify 'em, play with 'em a bit</li>
+ <li>read <link
href="http://jakarta.apache.org/avalon/developing/">Developing with
Avalon</link></li>
+ <li>Code! Code! Code!</li>
+ </ol>
+
+ <p>If you're not (but you do know a class from method, don't
you??), we've
+ got a more extensive document right
+ <link href="avalon-for-beginners.xml">here</link> for you to
check out.</p>
</s1>
</body>
<footer>
1.2 +2 -2 jakarta-avalon-excalibur/tweety/src/conf/build.xml
Index: build.xml
===================================================================
RCS file: /home/cvs/jakarta-avalon-excalibur/tweety/src/conf/build.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- build.xml 3 Jul 2002 20:21:03 -0000 1.1
+++ build.xml 5 Jul 2002 08:27:04 -0000 1.2
@@ -28,9 +28,9 @@
<!--
=================================================================== -->
<target name="run"
description="Runs the program">
- <java classname="org.apache.avalon.excalibur.tweety.Tweety"
+ <java classname="org.apache.avalon.excalibur.tweety.Main"
fork="true" dir="." failonerror="true">
<classpath refid="project.class.path" />
</java>
</target>
-</project>
\ No newline at end of file
+</project>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>