Folks, I seem to be done with the merging procedure and fixing the duplication issue. Patches are in HARMONY-1730 [http://issues.apache.org/jira/browse/HARMONY-1881]. I've done the following: 1) I've remove [1], because it's out-of-date and have migrated unique bits (not repeated elsewhere) to [2]. In this connection we need to remove the build_classlib.xml file from the repository. I've removed all references to this page from wiki and other site pages (it increased the number of patches...sorry about that..) 2)I've edited [4] to replace the BuildingInstructions link from [1] to [2], so that instructions for both classlib and vm are retrievable. 3)I've placed a More Details link at [3] to [2], work to minimize repetition between these.
As the result we get the following building instructions docs: [2] Getting Started for Contributors describing how to get configured to build and work with the Apache Harmony source code. [3] Getting Started for Users providing basic instructions for users that wish to use Apache Harmony for running their Java programs. [4]Wiki for all other useful stuff to enable flexibility and communication in the community. [5] README providing instructions on how to point to local versions instead of making the build download new ones from the net. I'll be glad if you find a chance to look at the patches. Thanks in advance! Cheers, Sveta Konovalova [1] > http://incubator.apache.org/harmony/subcomponents/classlibrary/build_cla > sslib.html > > [2] http://incubator.apache.org/harmony/quickhelp_contributors.html > > [3] http://incubator.apache.org/harmony/quickhelp_users.html > > [4] http://wiki.apache.org/harmony/FrontPage > [5] http://svn.apache.org/viewvc/incubator/harmony/enhanced/drlvm/trunk/READ ME.txt?view=co -----Original Message----- From: news [mailto:[EMAIL PROTECTED] On Behalf Of Egor Pasko Sent: Wednesday, October 18, 2006 3:24 PM To: harmony-dev@incubator.apache.org Subject: Re: [doc]too many building instructions? +1 I love the way it goes! On the 0x206 day of Apache Harmony Svetlana Konovalova wrote: > Nadya, > I'm with you here! > +1. I'm for reducing the number of building instructions:) > > Folks, > If you do not mind, I can become a volunteer to manage this merging > procedure. > > Please, find a chance to check whether I'm going to do a right job or > not: > 1) Remove [1], because it's out-of-date. migrate unique bits (not > repeated elsewhere) to [2]. > 2) Edit [4] to replace the BuildingInstructions link from [1] to > [2], so that instructions for both classlib and vm are retrievable. > 3) Place a More Details link at [3] to [2], work to minimize > repetition between these. > 4) Name BuildingHintsForClasslib and VMBuildTroubleshooting in a > similar way to show that they are about the same thing. > > Your constructive recommendations/suggestions are very welcome :) > > [1] > http://incubator.apache.org/harmony/subcomponents/classlibrary/build_cla > sslib.html > > [2] http://incubator.apache.org/harmony/quickhelp_contributors.html > > [3] http://incubator.apache.org/harmony/quickhelp_users.html > > [4] http://wiki.apache.org/harmony/FrontPage > [5] README > Cheers, > Sveta Konovalova > > -----Original Message----- > From: news [mailto:[EMAIL PROTECTED] On Behalf Of Egor Pasko > Sent: Wednesday, October 18, 2006 1:52 PM > To: harmony-dev@incubator.apache.org > Subject: Re: [doc]too many building instructions? > > Nadezhda, > > thanks for a bunch of good points! I find the number of (sometimes > contradicting) building howtos misleading too. > > On the 0x205 day of Apache Harmony Nadezhda Morozova wrote: > > Folks, > > > > I've had a strange impression just now that we have too many building > > instructions for Harmony sources: > > > > [1] > > > http://incubator.apache.org/harmony/subcomponents/classlibrary/build_cla > > sslib.html Building Class Library only > > This one is outdated, I would encourage to use [2] instead. > > > [2] http://incubator.apache.org/harmony/quickhelp_contributors.html > > > > [3] http://incubator.apache.org/harmony/quickhelp_users.html - > building > > instructions for the whole bundle (VM + Classlib), in a short and > > detailed versions; the detailed version (for contributors) has > specifics > > for building classlib and vm in addition to common steps > > [2] is not about building, just unpacking a snapshot and running. > > oh, I see a minor bug there: > It says: > you will need to use the tar program as follows : > tar -tzf latest-harmony-jre-linux.tar.gz > Should be: > you will need to use the tar program as follows : > tar xzf latest-harmony-jre-linux.tar.gz > > > [4] http://wiki.apache.org/harmony/FrontPage - startup Wiki page that > > has a link to [1], a placeholder for a future page > > BuildingHintsForClasslib and VMBuildTroubleshooting. The last two > pages > > seem to have similar intentions - show specifics/typical errors when > > building code. > > > > [5] READMEs for Classlib and for VM, with links to some of the sources > > above or repetition of these sources. > > > > > > > > Does this not seem like writing about actually the same thing in many > > places? My suggestion on improving this would be: > > > > 1. Remove [1], migrate unique bits (not repeated elsewhere) to [2] > > or [3] as fits better. > > agreed. Mostly to [2], I see no evidence of moving to [3] > > > 2. Edit [4] to replace the BuildingInstructions link from [1] to > > [2], so that instructions for both classlib and vm are retrievable. > > > > 3. Place a More Details link at [3] to [2], work to minimize > > repetition between these. > > 4. Name BuildingHintsForClasslib and VMBuildTroubleshooting in a > > similar way to show that they are about the same thing. > > I am glad to "hear" that! Are you volunteering? :) > > > I am sorry if this all sounds confusing or if I missed/misunderstood > > some things. Just trying to keep things in a minimal number of places > - > > for easier maintenance and browsing. > > It does not sound confusing. TBD, IMHO! I'd say even ASAP. Because too > often I get emails with "how do I build here and there? Why is > Harmony's website so misleading?". > > Thanks for doing great job at organizing the docs! > > -- > Egor Pasko, Intel Managed Runtime Division > > > --------------------------------------------------------------------- > Terms of use : http://incubator.apache.org/harmony/mailing.html > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > > --------------------------------------------------------------------- > Terms of use : http://incubator.apache.org/harmony/mailing.html > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > > -- Egor Pasko, Intel Managed Runtime Division --------------------------------------------------------------------- Terms of use : http://incubator.apache.org/harmony/mailing.html To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] --------------------------------------------------------------------- Terms of use : http://incubator.apache.org/harmony/mailing.html To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]