Skip to content
This repository
Browse code

Merge pull request #866 from uvtc/patch-1

clarify maven repository terminology. Also,
  • Loading branch information...
commit dff77758e02a3e75dad3a65970d5fe2c6f58cdbc 2 parents f214cf8 + 9ec66a8
Michael Klishin authored November 26, 2012

Showing 1 changed file with 12 additions and 7 deletions. Show diff stats Hide diff stats

  1. 19  doc/TUTORIAL.md
19  doc/TUTORIAL.md
Source Rendered
@@ -14,7 +14,7 @@ It manages various project-related tasks, and can:
14 14
  * run the project (if the project is an app)
15 15
  * generate a maven-style "pom" file for the project
16 16
  * compile and package projects for deployment
17  
- * publish libraries to package repositories such as [Clojars](http://clojars.org)
  17
+ * publish libraries to maven artifact repositories such as [Clojars](http://clojars.org)
18 18
  * run custom automation tasks written in Clojure (leiningen plug-ins)
19 19
 
20 20
 If you come from the Java world, Leiningen is "Maven meets Ant without the pain". For Ruby and Python
@@ -24,7 +24,7 @@ folks, Leiningen combines RubyGems/Bundler/Rake and pip/Fabric in a single tool.
24 24
 ## What This Tutorial Covers
25 25
 
26 26
 This tutorial will briefly cover project structure, dependency management, running tests,
27  
-the REPL and topics related to deployment.
  27
+the REPL, and topics related to deployment.
28 28
 
29 29
 For those of you new to the JVM who have never touched Ant or Maven in
30 30
 anger: don't panic. Leiningen is designed with you in mind. This
@@ -44,7 +44,7 @@ configuration, and even this tutorial are also provided.
44 44
 
45 45
 Leiningen works with *projects*. A project is a directory containing a group of Clojure (and, possibly, Java)
46 46
 source files, along with a bit of metadata about them. The metadata is stored in a file named
47  
-`project.clj` (by convention) in the repository root. `project.clj` is how you tell
  47
+`project.clj` (by convention) in the project's root directory. The `project.clj` file is how you tell
48 48
 Leiningen about things like
49 49
 
50 50
  * Project name
@@ -139,7 +139,7 @@ files, JavaScript files or text files with static data.
139 139
 Published JVM libraries have *identifiers* (artifact group, artifact id) and
140 140
 *versions*.
141 141
 
142  
-### Artifact IDs, Groups and Versions
  142
+### Artifact IDs, Groups, and Versions
143 143
 
144 144
 You can [search Clojars](http://clojars.org/search?q=clj-http) using its
145 145
 web interface. On the page for `clj-http` it shows this:
@@ -188,12 +188,17 @@ and `:import` clauses.
188 188
 
189 189
 ### Repositories
190 190
 
191  
-Dependencies are stored in *repositories*. If you are familiar with CPAN, PyPi, rubygems.org
192  
-or NPM, it's the same thing. Leiningen reuses existing JVM repositories infrastructure. There
  191
+Dependencies are stored in a *maven repository* (or, more formally, "maven
  192
+artifact repository", or just "repository" if there's little chance of
  193
+ambiguity).
  194
+If you are familiar with Perl's CPAN, Python's Cheeseshop (aka PyPi), Ruby's rubygems.org,
  195
+or Node.js's NPM, it's the same thing.
  196
+Leiningen reuses existing JVM repositories infrastructure. There
193 197
 are several popular open source repositories. Leiningen by default will use two of them: [clojars.org](http://clojars.org)
194 198
 and [Maven Central](http://search.maven.org/).
195 199
 
196  
-Clojars is the Clojure community's centralized jar repository, while Central is for the wider JVM community.
  200
+[Clojars](https://clojars.org/) is the Clojure community's centralized maven repository,
  201
+while [Central](http://search.maven.org/) is for the wider JVM community.
197 202
 
198 203
 You can add third-party repositories by setting the `:repositories` key
199 204
 in project.clj. See the

0 notes on commit dff7775

Please sign in to comment.
Something went wrong with that request. Please try again.