[carton] 35/472: Started FAQ doc

[Lucas Kanashiro]

This is an automated email from the git hooks/post-receive script.

kanashiro-guest pushed a commit to branch master
in repository carton.

commit 2c298b08f3cc4d0edc0268af018602d158ef1237
Author: Tatsuhiko Miyagawa <miyagawa at bulknews.net>
Date:   Sun Jun 26 02:03:40 2011 -0700

    Started FAQ doc
---
 lib/Carton/Doc/Faq.pod | 51 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/lib/Carton/Doc/Faq.pod b/lib/Carton/Doc/Faq.pod
new file mode 100644
index 0000000..633553b
--- /dev/null
+++ b/lib/Carton/Doc/Faq.pod
@@ -0,0 +1,51 @@
+=head1 NAME
+
+carton-faq - Frequently Asked Questions
+
+=head1 QUESTIONS
+
+=head2 How is this different from DPAN or CPAN::Mini::Inject?
+
+First of all, if you currently use L<DPAN|MyCPAN::App::DPAN>,
+L<CPAN::Mini::Inject> or any other similar tools successfully, then
+that's totally fine. You don't need to switch to carton.
+
+If you experience difficulties with these tools, or are interested in
+what could be better in carton, keep on reading.
+
+carton definitely shares the goal with these private CPAN repository
+management tool:
+
+=over 4
+
+=item *
+
+Manage the dependencies tree locally
+
+=item *
+
+Take snapshots/lock the versions
+
+=item *
+
+Inject private modules into the repository
+
+=back
+
+Existing tools are designed to work with existing CPAN clients such as
+L<CPAN> or L<CPANPLUS>, and have accomplished that by working around
+the CPAN mirror structure.
+
+carton internally does the same thing, but its user interface is
+centerd around the installer, by implementing a wrapper for
+L<cpanm|App::cpanminus>, so you can use the same commands in the
+development mode and deployment mode.
+
+Carton automatically maintains the L<carton.lock> file, which is meant
+to be version controlled, inside your application directory. You don't
+need a separate database or a directory to maintain tarballs outside
+your application. The C<carton.lock> file can always be generated out
+of the local library path, and carton can reproduce the tree using the
+lock file on other machines.
+
+

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-perl/packages/carton.git