Skip to content

Commit

Permalink
Add a man page.
Browse files Browse the repository at this point in the history
  • Loading branch information
technomancy committed Jul 1, 2011
1 parent d90affd commit a9910e8
Show file tree
Hide file tree
Showing 2 changed files with 92 additions and 0 deletions.
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -9,3 +9,4 @@ lein-swank/lein-swank*.jar
autodoc/
bin/nom
.lein-failures
/lein.man
91 changes: 91 additions & 0 deletions doc/lein.1
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
./"to render: groff -Tascii -man doc/lein.1 > lein.man"
.TH LEININGEN 1 "2011 June 30"
.SH NAME
lein \- Build Clojure projects

.SH SYNOPSIS

.B lein
[\fITASK\fR [\fIARGS\fR] [\fI, TASK2\fR [\fIARGS\fR] ...\fR]\fR]

.SH DESCRIPTION

Leiningen is a build tool for Clojure designed to not set your hair on fire.

Building Clojure projects with tools designed for Java can be an
exercise in frustration. With Leiningen, you describe your build with
Clojure.

.SH TASKS

.B lein help
will show the complete list of tasks, while
.B lein help TASK
shows usage for a specific one.

.B lein help tutorial
has a detailed walk-through of the various tasks, but the most
commonly-used are:

.TP
\fBlein new NAME\fR
generate a new project skeleton
.TP
\fBlein test [TESTS]\fR
run the tests in the TESTS namespaces, or all tests
.TP
\fBlein repl\fR
launch an interactive REPL session and socket server
.TP
\fBlein jar\fR
package up the whole project as a .jar file
.TP
\fBlein install [NAME VERSION]\fR
install a project

.SH CONFIGURATION

Leiningen reads its configuration from the
.B project.clj
file in your project root. Either use
.B lein new
to create a fresh project from which to work, or see the exhaustive
list of configuration options with
.B lein help sample.

You can also have user-level configuration that applies for all
projects. The
.B ~/.lein/init.clj
file will be loaded every time
Leiningen launches; any arbitrary code may go there. This code is
executed inside Leiningen itself, not in your project. Set the
.B :repl-init
key in project.clj to point to a namespace if you want code executed
inside your project.

You can also manage user-level plugins with the plugin task; see
.B lein help plugin

.SH BUGS

Check https://github.com/technomancy/leiningen/issues to see if your
problem is a known issue. If not, please open a new issue on that site
or join the mailing list at
http://groups.google.com/group/leiningen/. Please include the output of
.B lein version
as well as your
.B project.clj
file and as much of the relevant code from your project as possible.

.SH COPYING

Copyright
.if t \(co
.if n (C)
2009-2011 Phil Hagelberg and contributors.

Distributed under the Eclipse Public License, the same as Clojure
uses. See the file /usr/share/doc/leiningen/copyright.

.SH AUTHOR
This manpage is written by Phil Hagelberg <[email protected]>

0 comments on commit a9910e8

Please sign in to comment.