harmony-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Konovalova, Svetlana" <svetlana.konoval...@intel.com>
Subject FW: Re: [doc]too many building instructions?
Date Fri, 20 Oct 2006 13:24:54 GMT
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:news@sea.gmane.org] 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:news@sea.gmane.org] 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: harmony-dev-unsubscribe@incubator.apache.org
> For additional commands, e-mail: harmony-dev-help@incubator.apache.org
> 
> ---------------------------------------------------------------------
> Terms of use : http://incubator.apache.org/harmony/mailing.html
> To unsubscribe, e-mail: harmony-dev-unsubscribe@incubator.apache.org
> For additional commands, e-mail: harmony-dev-help@incubator.apache.org
> 
> 

-- 
Egor Pasko, Intel Managed Runtime Division


---------------------------------------------------------------------
Terms of use : http://incubator.apache.org/harmony/mailing.html
To unsubscribe, e-mail: harmony-dev-unsubscribe@incubator.apache.org
For additional commands, e-mail: harmony-dev-help@incubator.apache.org

---------------------------------------------------------------------
Terms of use : http://incubator.apache.org/harmony/mailing.html
To unsubscribe, e-mail: harmony-dev-unsubscribe@incubator.apache.org
For additional commands, e-mail: harmony-dev-help@incubator.apache.org


Mime
View raw message