[source] Folder setup for interactions across multiple SourceForge repositories

[Roy Walmsley]

Don,

 

Currently there are at least four independent repositories that have
interactions spanning multiple repositories.

 

The x3d repository (https://sourceforge.net/projects/x3d/) is the main X3D
repository. Of relevance here is that it includes the Web3D examples, which
includes a Netbeans project entitled "X3D examples: archive top level".

 

Detailed examination reveals that this project relies upon three subprojects
in three other repositories.

 

The first is the Xj3D repository (https://sourceforge.net/projects/xj3d/).

 

The second is the Savage examples archive
(https://savage.nps.edu/svn/repos/nps/list/Savage).

 

The third is the Savage defence examples archive. This is, of course, a
restricted archive not available to the general public.

 

The top level project needs to refer to each of the sub projects. This needs
to be done by specifying relative directories. Therefore, in order for this
to be successful, the relative locations of the cloned repositories needs to
be clearly specified.

 

I therefore suggest the following.

 

Assume that the top level folder exists, which for the sake of this
discussion I will simply name "TopLevel". It can be called anything the user
wishes. The x3d repository should be checked out into this folder. There are
two top level folders: "legacy" and "www.web3d.org". In the latter there are
two further folders: "specifications" and "x3d".

 

The Xj3D repository should be checked out into the "www.web3d.org" folder.
This  adds a third folder to "xj3d" to "specifications" and "x3d".

 

The "x3d" folder contains five folders. The one we are particularly
interested in is "content". "content" has three folders. We are interested
in "examples". "examples" has seven  folders. Five of these are of interest,
as they contain the full set of Web3D archive examples. These are "Basic",
"ConformanceNist", "Vrml2.0Sourcebook", "X3dForAdvancedModeling", and
"X3dForWebAuthors". It is into the "examples" folder that the Savage
examples, and, if available, the Savage Defence examples repositories should
be checked into. For the Savage examples archive this adds the folder
"Savage".

 

In summary, this produces the following folder structure excerpt (only the
relevant folders are shown - there are many more).

 

TopLevel -+

                     |

                     +- legacy

                     +- www.web3d.org -+

                                                               |

                                                               +-
specifications

                                                               +- xj3d

                                                               +- x3d -+

 
|

 
+- content -+

 
|

 
+- examples -+

 
|

 
+- Basic

 
+- ConformanceNist

 
+- Vrml2.0Sourcebook

 
+- X3DForAdvancedModeling

 
+- X3DForWebAuthors

 
+- Savage

 
+- SavageDefence (??)

 

Note: The nesting of repositories has not caused any problems on my Windows
system.

 

If this folder structure is agreed then I will amend all paths to conform to
this structure. I will also modify the code so that the paths are specified
as variables at the start of a "build.xml" file so that, if necessary, any
modifications are only required in one place.

 

Roy

 

 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://web3d.org/pipermail/source_web3d.org/attachments/20160213/4218a254/attachment.html>