April 2008 - cl-darcs-cvs@lists.common-lisp.net

[Cl-darcs-cvs] r205 - cl-darcs/trunk/doc
by mhenoch＠common-lisp.net 03 Apr '08

03 Apr '08

Author: mhenoch Date: Wed Apr 2 19:03:58 2008 New Revision: 205 Modified: cl-darcs/trunk/doc/cl-darcs.texi Log: Document "darcs init" Modified: cl-darcs/trunk/doc/cl-darcs.texi ============================================================================== --- cl-darcs/trunk/doc/cl-darcs.texi (original) +++ cl-darcs/trunk/doc/cl-darcs.texi Wed Apr 2 19:03:58 2008 @@ -156,6 +156,10 @@ @node Creating a new repository, Pulling new patches, Getting a repository, Top @chapter Creating a new repository +@deffn Command @command{darcs init} +Create a new empty repository in the current directory. +@end deffn + @defun DARCS:CREATE-REPO repodir Create a new empty repository in @var{repodir}. @var{repodir} must be a local nonexistent directory.

1 0

[Cl-darcs-cvs] r204 - cl-darcs/trunk
by mhenoch＠common-lisp.net 03 Apr '08

03 Apr '08

Author: mhenoch Date: Wed Apr 2 19:02:00 2008 New Revision: 204 Modified: cl-darcs/trunk/cmdline.lisp Log: Note todo items for command operands Modified: cl-darcs/trunk/cmdline.lisp ============================================================================== --- cl-darcs/trunk/cmdline.lisp (original) +++ cl-darcs/trunk/cmdline.lisp Wed Apr 2 19:02:00 2008 @@ -97,9 +97,11 @@ (lambda (o) `(,o (cdr (assoc (option-keyword ,(option-symbol o)) ,options-sym)))) options) + ;; XXX: what if this fails? (destructuring-bind ,operands ,operands-sym ,@body)))) (setf (get ',function 'darcs-documentation) + ;; XXX: documentation for operands ,(if (null options) docstring `(format nil

1 0

[Cl-darcs-cvs] r203 - cl-darcs/trunk
by mhenoch＠common-lisp.net 03 Apr '08

03 Apr '08

Author: mhenoch Date: Wed Apr 2 19:00:27 2008 New Revision: 203 Modified: cl-darcs/trunk/cmdline.lisp Log: Use DARCS-DOCUMENTATION property in USAGE Modified: cl-darcs/trunk/cmdline.lisp ============================================================================== --- cl-darcs/trunk/cmdline.lisp (original) +++ cl-darcs/trunk/cmdline.lisp Wed Apr 2 19:00:27 2008 @@ -65,7 +65,7 @@ (format *error-output* " ~A~15,2T~A~%" cmd (car (split-sequence:split-sequence - #\Newline (documentation function 'function) + #\Newline (get function 'darcs-documentation) :count 1)))))) (defun command-usage (command)

1 0

[Cl-darcs-cvs] r202 - cl-darcs/trunk/doc
by mhenoch＠common-lisp.net 02 Apr '08

02 Apr '08

Author: mhenoch Date: Wed Apr 2 18:50:10 2008 New Revision: 202 Modified: cl-darcs/trunk/doc/cl-darcs.texi Log: Document command line tool Modified: cl-darcs/trunk/doc/cl-darcs.texi ============================================================================== --- cl-darcs/trunk/doc/cl-darcs.texi (original) +++ cl-darcs/trunk/doc/cl-darcs.texi Wed Apr 2 18:50:10 2008 @@ -42,6 +42,7 @@ @menu * Introduction:: +* Running cl-darcs:: * Access methods:: * Getting a repository:: * Creating a new repository:: @@ -50,7 +51,7 @@ * Working directory layout:: @end menu -@node Introduction, Access methods, Top, Top +@node Introduction, Running cl-darcs, Top, Top @chapter Introduction cl-darcs is an implementation of the darcs version control system @@ -82,7 +83,24 @@ middle-of-the-room cases). However, it is already useful for simple usage. -@node Access methods, Getting a repository, Introduction, Top +@node Running cl-darcs, Access methods, Introduction, Top +@chapter Running cl-darcs + +There are two ways of running cl-darcs, from the shell, or from the +REPL. + +@section From the shell + +If you have successfully compiled the @file{darcs} binary, you can use +it much like you'd use the original darcs client, except that it only +supports a small subset of the commands. + +@section From the REPL + +Of course, all functionality is equally available from the REPL, though +sometimes with different syntax or semantics. + +@node Access methods, Getting a repository, Running cl-darcs, Top @chapter Access methods cl-darcs can access repositories on a local disk (read and write) and on @@ -103,20 +121,14 @@ Using a caching proxy (e.g. Squid) can be a good idea, since cl-darcs is sometimes a bit wasteful about how much it downloads, and bugs might make it lose what it already has downloaded. + +This variable is not available in the standalone @file{darcs} +executable. @end defopt @node Getting a repository, Creating a new repository, Access methods, Top @chapter Getting a repository -@defun DARCS:GET-REPO in-path out-path &key query -Get a local copy of the tree at @var{in-path}, and write it to -@var{out-path}. @var{in-path} may be an HTTP URL or a local directory. -@var{out-path} must be a local nonexistent directory. - -If @var{query} is true, ask for a range of patches to download and -apply. -@end defun - Getting a copy of a repository involves getting all the patches from that repository, and applying them one by one to the local tree. This can be a lot of data, if the repository has long history. Darcs has a @@ -126,6 +138,21 @@ @file{_darcs/prefs/defaultrepo}), and is used as default repository to pull from. @xref{Pulling new patches}. +@deffn Command @command{darcs get} [@kbd{--repodir=}@var{to}] from +Get a local copy of the tree at @var{from}, and write it to @var{to}. +If @var{to} is not specified, a subdirectory of the current directory is +created, based on the last path element of @var{from}. +@end deffn + +@defun DARCS:GET-REPO in-path out-path &key query +Get a local copy of the tree at @var{in-path}, and write it to +@var{out-path}. @var{in-path} may be an HTTP URL or a local directory. +@var{out-path} must be a local nonexistent directory. + +If @var{query} is true, ask for a range of patches to download and +apply. +@end defun + @node Creating a new repository, Pulling new patches, Getting a repository, Top @chapter Creating a new repository @@ -145,6 +172,17 @@ Updating your working copy with new patches from the original repository is called ``pulling'' these patches. +@deffn Command @command{darcs pull} [@kbd{--all-patches}|@kbd{-a}] [@kbd{--repodir=}@var{local}] [@var{foreign}] + +Pull new patches from repository @var{foreign} into repository +@var{local}. If @var{local} is not specified, it defaults to the +current directory. If @var{foreign} is not specified, it defaults to +the repository you pulled from last time. + +If you specify @kbd{-a} or @kbd{--all-patches}, all new patches are +pulled; otherwise you will be asked for which ones to pull. +@end deffn + @defun DARCS:PULL our-repo &optional their-repo Pull new patches from @var{their-repo} into @var{our-repo}. @var{our-repo} must be a local darcs tree. @var{their-repo} can be a @@ -162,9 +200,6 @@ from where you can recover the changed file and merge it with your changes. -Also, all new patches will be pulled without asking. This is -suboptimal; selecting some of the patches should be supported. - @node Recording a patch, Working directory layout, Pulling new patches, Top @chapter Recording a patch @@ -172,6 +207,10 @@ called ``recording'' in darcs. Before doing that, you may want to review your local changes. +@deffn Command @command{darcs whatsnew} +Find changes in the repository in the current directory, and print them. +@end deffn + @defun DARCS:DIFF-REPO-DISPLAY repo Find changes in @var{repo} and print them. @end defun @@ -181,6 +220,11 @@ ignored; see @ref{Boring files}. New files in your tree are automatically included in the diff output, unless they are ``boring''. +@deffn Command @command{darcs record} +Interactively ask which changes to record, what name to give the patch, +and who the author is. +@end deffn + @defun DARCS:RECORD-CHANGES repo name author date log Interactively ask which changes to @var{repo} to record.

1 0

[Cl-darcs-cvs] r201 - cl-darcs/trunk
by mhenoch＠common-lisp.net 02 Apr '08

02 Apr '08

Author: mhenoch Date: Wed Apr 2 17:40:59 2008 New Revision: 201 Modified: cl-darcs/trunk/README Log: Mention compilation in README Modified: cl-darcs/trunk/README ============================================================================== --- cl-darcs/trunk/README (original) +++ cl-darcs/trunk/README Wed Apr 2 17:40:59 2008 @@ -2,7 +2,18 @@ writing it because the original client requires GHC (the Glasgow Haskell Compiler), which is not available on all platforms. -cl-darcs is currently in a very early state of development. +* Compiling + +If you use CLISP or SBCL, you can use cl-darcs as a standalone +executable with an interface very similar to the real darcs. Just +run: + +./configure && make && make install + +You can also use cl-darcs from the REPL, by installing it as an ASDF +system: + +ln -s $PWD/cl-darcs.asd /path/to/asdf-systems/ * Usage

1 0

[Cl-darcs-cvs] r200 - cl-darcs/trunk/doc
by mhenoch＠common-lisp.net 02 Apr '08

02 Apr '08

Author: mhenoch Date: Wed Apr 2 17:35:47 2008 New Revision: 200 Modified: cl-darcs/trunk/doc/cl-darcs.texi Log: Add dir entry to documentation Modified: cl-darcs/trunk/doc/cl-darcs.texi ============================================================================== --- cl-darcs/trunk/doc/cl-darcs.texi (original) +++ cl-darcs/trunk/doc/cl-darcs.texi Wed Apr 2 17:35:47 2008 @@ -14,6 +14,11 @@ @end quotation @end copying +@dircategory Software development +@direntry +* Cl-darcs: (cl-darcs). Darcs version control system client +@end direntry + @titlepage @title cl-darcs 0.3.0 @subtitle a darcs client in Common Lisp

1 0

[Cl-darcs-cvs] r199 - cl-darcs/trunk
by mhenoch＠common-lisp.net 02 Apr '08

02 Apr '08

Author: mhenoch Date: Wed Apr 2 17:27:17 2008 New Revision: 199 Modified: cl-darcs/trunk/Makefile.am Log: Include test suite in distribution Modified: cl-darcs/trunk/Makefile.am ============================================================================== --- cl-darcs/trunk/Makefile.am (original) +++ cl-darcs/trunk/Makefile.am Wed Apr 2 17:27:17 2008 @@ -3,6 +3,8 @@ info_TEXINFOS=doc/cl-darcs.texi +dist_noinst_DATA=tests/package.lisp tests/gcau-tests.lisp + # satisfy ASDF's tarball name convention distdir=$(PACKAGE)_$(VERSION)

1 0

[Cl-darcs-cvs] r198 - in cl-darcs/trunk: . doc
by mhenoch＠common-lisp.net 02 Apr '08

02 Apr '08

Author: mhenoch Date: Wed Apr 2 17:06:36 2008 New Revision: 198 Removed: cl-darcs/trunk/doc/Makefile.am Modified: cl-darcs/trunk/Makefile.am cl-darcs/trunk/configure.ac Log: Use one central makefile Modified: cl-darcs/trunk/Makefile.am ============================================================================== --- cl-darcs/trunk/Makefile.am (original) +++ cl-darcs/trunk/Makefile.am Wed Apr 2 17:06:36 2008 @@ -1,7 +1,7 @@ bin_PROGRAMS = darcs darcs_SOURCES = cl-darcs.asd apply-patch.lisp cmdline.lisp commute.lisp condition.lisp diff.lisp display-patch.lisp dump-clisp.lisp dump-sbcl.lisp equal.lisp get.lisp getopt.lisp ifstar.lisp inflate.lisp invert-patch.lisp merge.lisp packages.lisp patch-core.lisp patchinfo.lisp pending.lisp prefs.lisp pristine.lisp pull.lisp read-patch.lisp record.lisp repo.lisp revert.lisp send.lisp touching.lisp unreadable-stream.lisp unwind.lisp upath.lisp util.lisp write-patch.lisp -SUBDIRS=doc +info_TEXINFOS=doc/cl-darcs.texi # satisfy ASDF's tarball name convention distdir=$(PACKAGE)_$(VERSION) Modified: cl-darcs/trunk/configure.ac ============================================================================== --- cl-darcs/trunk/configure.ac (original) +++ cl-darcs/trunk/configure.ac Wed Apr 2 17:06:36 2008 @@ -52,5 +52,5 @@ AC_SUBST(SBCL) AC_SUBST(SBCL_FLAGS) -AC_CONFIG_FILES([Makefile doc/Makefile]) +AC_CONFIG_FILES([Makefile]) AC_OUTPUT

1 0

[Cl-darcs-cvs] r197 - cl-darcs/trunk
by mhenoch＠common-lisp.net 02 Apr '08

02 Apr '08

Author: mhenoch Date: Wed Apr 2 17:00:46 2008 New Revision: 197 Modified: cl-darcs/trunk/Makefile.am Log: Satisfy ASDF's tarball name convention Modified: cl-darcs/trunk/Makefile.am ============================================================================== --- cl-darcs/trunk/Makefile.am (original) +++ cl-darcs/trunk/Makefile.am Wed Apr 2 17:00:46 2008 @@ -3,6 +3,9 @@ SUBDIRS=doc +# satisfy ASDF's tarball name convention +distdir=$(PACKAGE)_$(VERSION) + darcs: $(darcs_SOURCES) $(MAKE) build_with_@my_lisp@

1 0

[Cl-darcs-cvs] r196 - cl-darcs/trunk
by mhenoch＠common-lisp.net 02 Apr '08

02 Apr '08

Author: mhenoch Date: Wed Apr 2 17:00:30 2008 New Revision: 196 Modified: cl-darcs/trunk/Makefile.am Log: Don't rebuild darcs unless dependencies changed Modified: cl-darcs/trunk/Makefile.am ============================================================================== --- cl-darcs/trunk/Makefile.am (original) +++ cl-darcs/trunk/Makefile.am Wed Apr 2 17:00:30 2008 @@ -3,7 +3,8 @@ SUBDIRS=doc -darcs: build_with_@my_lisp@ +darcs: $(darcs_SOURCES) + $(MAKE) build_with_@my_lisp@ build_with_clisp: @CLISP@ @CLISP_FLAGS@ @srcdir@/dump-clisp.lisp

1 0