[jsword-devel] maven vs ant

[trent.jsword at trentonadams.ca]

Hi DM,

I didn't see you mention any errors, other than the encoding issue.  I'll try this on my wife's mac.    

For now, responses below...

----- "DM Smith" <dmsmith at crosswire.org> wrote:

> From: "DM Smith" <dmsmith at crosswire.org>
> To: "J-Sword Developers Mailing List" <jsword-devel at crosswire.org>
> Sent: Sunday, February 21, 2010 12:23:23 PM GMT -06:00 US/Canada Central
> Subject: Re: [jsword-devel] maven vs ant
>
> Trent,
> It did not work for me. I'm attaching the output. One of the things
> I'm curious about is why it downloaded stuff that BibleDesktop (and
> the libraries it uses) does not need. E.g. jetty, plexus, oro,
> velocity doxia-module-xml, ....
> 
> The POM is using the platform's default encoding. Should it? In my
> case it is MacRoman. None of the files are MacRoman. They are either 7
> bit ascii or UTF-8.

Yeah, we need to specify the proper encoding.  I tried with UTF-8, and apparently those java files are not UTF-8 in the tests folder of jsword I think it is.  I'll try again later.

The trunk/pom.xml that I recently sent should have the new encoding properties
    <project.build.sourceEncoding>iso-8859-1</project.build.sourceEncoding>

    <project.reporting.outputEncoding>iso-8859-1</project.reporting.outputEncoding>

I'll try ascii, and what not.

> > I still need to do at least the following...
> > - jar signing # never done it before
> > - run bibledesktop using a profile
> > - work something out for the jlfgr jar.  Perhaps those should just
> be in the bibledesktop resources?  Or should they be in their own
> module?  We could just create a sub module, with no source files, and
> only "src/main/resources", and package them in a jar automatically?
> 
> jlfgr is Sun's (now Oracle's) Java Look and Feel Graphics Repository.
> I'd be just as happy to replace the library outright. We only use it
> in the menus and toolbar for icons.

Okay, I'll check if that's available.

> > - the jsword project lead needs to prepare an account on a public
> maven repository, so we can push these things through maven.  Assuming
> of course that is what you guys want to do.  Or, if you really want,
> we can setup a maven.crosswire.org repository, and just put that in
> the base pom.
> 
> That would be me. But I need guidance... :)

It might be best to do a crosswire repo first, and then once we have our stuff together, perhaps look at going with maven's default repositories.  Any thoughts?

I've only done ssh based distribution management before.  The repository is configured to allow devs to upload using scp, and then regular users download from it via http.  But, there may be a way of allowing the HTTP PUT method, I'm not sure.  We'll have to investigate.

> 
> > 
> > I highly recommend the core developers move ALL resources to
> "src/main/resources" of each sub module.
> 
> What qualifies as a resource?
> I'm in the process of moving files containing string translations to
> there.

I would say that anything that is not source code, is a resource.  Obviously the resources folder needs sub folders so that you can keep the same structure once it gets copied to target/classes/  so, if the resource was org/crosswire/jsword/BookDriver.plugin then it would be in src/main/resources/org/crosswire/jsword/BookDriver.plugin

> Let me know of specific files that should be moved to
> src/test/resources.

Oh, well that would be anything in src/test/java/ that's not a java source file.

The following seems to work for resource copying, so probably all of those.  But again, I don't know which folders have which resources, so I just put all of these everywhere. :P

          <include>**/*.properties</include>
          <include>**/*.plugin</include>
          <include>**/*.png</include>
          <include>**/*.gif</include>
          <include>**/*.txt</include>
          <include>**/*.xml</include>
          <include>**/*.xsl</include>
> 
> > 
> > The following commands, from the command line, should work.  At some
> point, I'll try it in eclipse for you guys, and see if there's any
> maven related problems.  I don't use eclipse, so I don't know yet.
> 
> I used to do all of my development in vi and emacs. I like Eclipse
> because it has safe refactoring.

Yeah, I was using vi for quite awhile.  I use IDEA now, because it seems to be the best IDE out there.  They do offer free versions for open source projects, if you wanted to try it.  But, eclipse is more widely used in open source projects, which drives me nuts, cause I think it's the worst one out there (between NetBeans, eclipse, and IDEA). :P  eclipse features are fine, it's just IMO, it's about as convoluted as you can get, for an IDE.  Seems like you have to jump through hoop after hoop to get anything done.