Yeah, I think we're still as a team doing a bit of a bad job of documenting features. Some ideas for improving how we document / spec out new flags / features / settings to CLI:
1 - Add a wiki page for each 2 - Add a section within doc/help.txt in addition to a one-line --flag usage description 3 - Attach a full flag description to the JIRA issue 4 - Email out full flag descriptions to the ML 5 - Add text to cordova-doc's plugman/CLI guides I think end-users would benefit from thoroughly explained flags/settings spec'ed, and I tend to like help text being included in --help rather than looking on docs.cordova.io, so I think it'd be good to try and do #3 for spec'ing out the intended help.txt text, and then have help.txt be the authoritative version going forward. On Wed, Jan 8, 2014 at 7:01 AM, Michal Mocny <mmo...@chromium.org> wrote: > Mark, > > I think Jeff's point earlier was that he would like more documentation > about the behavior / limitations, not that he thinks your choices were > wrong. Personally I would rather have explicit multiple search paths than > recursive search. That way we are less likely to hit ambiguity with copies > existing in some subfolder and likely significantly faster operation in > certain scenarios. > > -Michal > > > On Wed, Jan 8, 2014 at 9:41 AM, Mark Koudritsky <kam...@google.com> wrote: > > > Nope, right now neither will work. The multiple --searchpath options > sound > > interesting, i'll check the possibility of using this instead of any > > delimiters so that it's platform independent. Thanks for pointing it out. > > > > > > On Wed, Jan 8, 2014 at 2:11 AM, Axel Nennker <ignisvul...@gmail.com> > > wrote: > > > > > Have you thought of Windows paths? > > > > > > C:\myplugins; z:\sharedplugins > > > > > > Is the delimeter platform specific? > > > Can I have multiple searchpath parameters? > > > > > > --searchpath c:\myplugins --searchpath z:\sharedplugins > > > > > > --Axel > > > Am 07.01.2014 22:41 schrieb "Mark Koudritsky" <kam...@gmail.com>: > > > > > > > > > > > ----------------------------------------------------------- > > > > This is an automatically generated e-mail. To reply, visit: > > > > https://reviews.apache.org/r/16701/ > > > > ----------------------------------------------------------- > > > > > > > > Review request for cordova. > > > > > > > > > > > > Bugs: CB-5006 > > > > https://issues.apache.org/jira/browse/CB-5006 > > > > > > > > > > > > Repository: cordova-plugman > > > > > > > > > > > > Description > > > > ------- > > > > > > > > The diff here is missing author info and squashes 2 commits together, > > for > > > > properly formatted patch use: > > > > curl > > https://github.com/kamrik/cordova-plugman/compare/searchpath.patch| > > > > git am > > > > > > > > Add --searchpath option for local plugin search path. > > > > The param accepts a colon separated list of dirs that are searched in > > > > order for subdirs containing a plugin.xml file with the requested > > plugin > > > ID. > > > > > > > > > > > > Diffs > > > > ----- > > > > > > > > doc/help.txt 0c6ad7a > > > > main.js 5fa6422 > > > > plugman.js a7ff484 > > > > src/fetch.js 0d50187 > > > > src/install.js 6b09434 > > > > > > > > Diff: https://reviews.apache.org/r/16701/diff/ > > > > > > > > > > > > Testing > > > > ------- > > > > > > > > npm test; > > > > > > > > plugman install --platform android --project > > > > /.../myproject/platforms/android --plugin org.apache.cordova.file > > > > plugman uninstall --platform android --project > > > > /.../myproject/platforms/android --plugin org.apache.cordova.file > > > > plugman install --platform android --project > > > > /.../myproject/platforms/android --plugin org.apache.cordova.file \ > > > > --searchpath /some_real/local_reg:/some/dummy/path > > > > > > > > cordova create MyApp > > > > cd MyApp > > > > cordova plugin add org.apache.cordova.file > > > > > > > > > > > > Thanks, > > > > > > > > Mark Koudritsky > > > > > > > > > > > > > >
