[jira] [Created] (MSHARED-995) documentation

["Delany (Jira)" <ji...@apache.org>]

Delany created MSHARED-995:
------------------------------

             Summary: documentation
                 Key: MSHARED-995
                 URL: https://issues.apache.org/jira/browse/MSHARED-995
             Project: Maven Shared Components
          Issue Type: Improvement
          Components: maven-filtering
            Reporter: Delany


There's basically no documentation on the pattern matching used to filter resources. The filter component documentation reads like dev documentation, and I'm left to trail-and-error to figure it out. Adding to the confusion is that Maven plugins can implement their own pattern matching/strain of regex. I think the assembly plugin does its own thing. Its frustrating enough when regex doesn't match so can I at least be clear on the algorithm.

For example, I want to set a more specific filter to copy resources. The filename may have anywhere between 1 and 5 characters followed by an extension.

I tried five question marks, but that only matches 5 characters not 4.

 
{code:java}
<include>?????.changelog</include>
{code}
There's no support for something like

 
{code:java}
<include>?{1,5}.changelog</include>
{code}
 

I see double asterisk in some patterns, suggesting globbing. Can this be stated? Perhaps at one point it was obvious - it may seem too simple to bother with. But the Internet is full of alternatives today and a simple write-up will save a lot of guess-work for newbies and those of us with bad memory.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)