[Bps-public-commit] Shipwright branch, master, updated. 0cf584d876c314da7a237465ed5e26f22599abc9

[sunnavy at bestpractical.com]

The branch, master has been updated
       via  0cf584d876c314da7a237465ed5e26f22599abc9 (commit)
       via  c9150b33fd53a35d78c60191c910b5368968b782 (commit)
      from  18e9a9490e31ac8afabd97607c143d27284492b4 (commit)

Summary of changes:
 lib/Shipwright/Manual/Tutorial.pod |   27 +++++++++++++++------------
 share/bin/shipwright-builder       |    2 ++
 share/bin/shipwright-filter        |    5 ++++-
 3 files changed, 21 insertions(+), 13 deletions(-)

- Log -----------------------------------------------------------------
commit c9150b33fd53a35d78c60191c910b5368968b782
Author: sunnavy <sunnavy at bestpractical.com>
Date:   Fri Jul 24 14:00:32 2009 +0800

    improve tutorial

diff --git a/lib/Shipwright/Manual/Tutorial.pod b/lib/Shipwright/Manual/Tutorial.pod
index 667c82b..e10a15a 100644
--- a/lib/Shipwright/Manual/Tutorial.pod
+++ b/lib/Shipwright/Manual/Tutorial.pod
@@ -8,7 +8,7 @@ In this tutorial, we'll create a vessel to represent basic stuff of Shipwright.
 
 =head1 DESCRIPTION
 
-Currently, Shipwright supports 3 kinds of backends: I<SVK>, I<SVN>, I<Git> and I<plain
+Currently, Shipwright supports 4 kinds of backends: I<SVK>, I<SVN>, I<Git> and I<plain
 file system>. e.g.
 
     svn:file:///tmp/svnrepo/foo
@@ -18,12 +18,11 @@ file system>. e.g.
     git:file:///tmp/shipwright.git
     fs:/tmp/foo
 
-Note: since we need C<svk>/C<svn>/C<svnadmin> cmds in in backends, sources or 
-other places, we can tell shipwright the location of C<svk>/C<svn> cmds by 
-setting ENV C<SHIPWRIGHT_SVK> or C<SHIPWRIGHT_SVN>.
+Note: since we need C<svk>/C<svn>/C<svnadmin>/C<git> cmds in in backends, sources or 
+other places, we can tell shipwright the location of C<svk>/C<svn>/C<git> cmds by 
+setting ENV C<SHIPWRIGHT_SVK>/C<SHIPWRIGHT_SVN>/C<SHIPWRIGHT_GIT>.
 C<svnadmin> is assumed in the same directory of svn. 
 
-
 we'll use C<svn:file:///tmp/svnrepo/foo> as the repository for the rest tutorial.
 
 =head2 create
@@ -74,7 +73,6 @@ B<Caveat>: for files, we only support I<.tar.gz>(I<.tgz>) and I<.tar.bz2> format
 
 =item SVK
     
-    svn:file:///tmp/svnrepo/foo>
     svk:/test/foo
 
 =item SVN
@@ -88,7 +86,7 @@ B<Caveat>: for files, we only support I<.tar.gz>(I<.tgz>) and I<.tar.bz2> format
     cpan:Module::Install
 
 It's ok, Shipwright will find the download link automatically for us,
-with L<CPAN>'s help.
+with L<CPAN>'s help. thanks, L<CPAN>!
 
 =item Shipwright
 
@@ -130,7 +128,7 @@ For more information on build scripts, see L<Shipwright::Manual::CustomizeBuild>
 
 =head2 update
 
-For dists with I<CPAN>, I<SVK>, I<SVN> and I<Shipwright> types,
+For dists with I<CPAN>, I<SVK>, I<SVN>, I<Git> and I<Shipwright> types,
 we can simply use the I<update> cmd to update:
 
     $ shipwright update -r svn:file:///tmp/svnrepo/foo cpan-XML-LibXML
@@ -157,10 +155,9 @@ in F</scripts/cpan-XML-LibXML/require.yml> there's no such entry,
 because F<require.yml> is created automatically, filled with perl module dists,
 no extra dependence will be set.
 
-So we have to do it manually, edit F</scripts/cpan-XML-LibXML/require.yml>
-ourselves, at least by now.
+So we need to do it manually, e.g. use the following cmd to do so
 
-Hey, you know how to edit that file, right? ;)
+    $ shipwright update -r svn:file:///tmp/svnrepo/foo apache --add-deps libxml
 
 =head2 build
 
@@ -169,7 +166,13 @@ then I<chdir> there, and run:
 
 $ ./bin/shipwright-builder 
 
-Run I<./bin/shipwright-builder --help> to see more options.
+Run I<./bin/shipwright-builder --help> to see more options and
+I<./bin/shipwright-builder --advanced-help> to see even more options.
+
+=head2 fiddle the vessel
+
+we can use bin/shipwright-filter to fiddle the vessel, e.g. removing pods.
+Run I<./bin/shipwright-filter --help> to see more options
 
 =head2 ship our vessel
 

commit 0cf584d876c314da7a237465ed5e26f22599abc9
Author: sunnavy <sunnavy at bestpractical.com>
Date:   Fri Jul 24 14:01:09 2009 +0800

    pod update for shipwright-builder and shipwright-filter

diff --git a/share/bin/shipwright-builder b/share/bin/shipwright-builder
index 37a5df5..ce4ffb3 100755
--- a/share/bin/shipwright-builder
+++ b/share/bin/shipwright-builder
@@ -97,6 +97,8 @@ Less commonly needed options:
   --branches    Specify the branch of a given package in the vessel you want 
                 to build.
                 Ex: --branches Foo,trunk,Bar,2.0
+  --as          for multi-arch dists, you can use this to specify the arch name.
+                By default it's the uname.
 END
 
 if ( $args{'help'} ) {
diff --git a/share/bin/shipwright-filter b/share/bin/shipwright-filter
index 32a60a0..e22dade 100755
--- a/share/bin/shipwright-filter
+++ b/share/bin/shipwright-filter
@@ -21,9 +21,12 @@ options:
 
 help: print this usage
 
-remove-pod: remove .pm files' pod
+remove-pod: remove .pm files' pod, this will ignore files that match lines in
+    file __pod_ignores, which contains a list of regex line by line
+
 squeeze: squeeze lib files. this is done by replace duplicate files by
 linking
+
 verbose: show more info to stdout
 
 END

-----------------------------------------------------------------------