Convert section names to use AsciiDoc markup. Fix a typo and refer to the
cg-* manpages.
Signed-off-by: Jonas Fonseca <[EMAIL PROTECTED]>
---
Documentation/Makefile | 5 ++++-
README | 36 ++++++++++++++++++++++++------------
2 files changed, 28 insertions(+), 13 deletions(-)
diff --git a/Documentation/Makefile b/Documentation/Makefile
--- a/Documentation/Makefile
+++ b/Documentation/Makefile
@@ -4,7 +4,7 @@ CG_SRC=$(filter-out $(CG_IGNORE), $(wild
MAN1_TXT=$(patsubst ../cg-%,cg-%.txt,$(CG_SRC))
MAN7_TXT=cogito.txt
-DOC_HTML=$(patsubst %.txt,%.html,$(MAN1_TXT) $(MAN7_TXT))
+DOC_HTML=$(patsubst %.txt,%.html,$(MAN1_TXT) $(MAN7_TXT)) introduction.html
DOC_MAN1=$(patsubst %.txt,%.1,$(MAN1_TXT))
DOC_MAN7=$(patsubst %.txt,%.7,$(MAN7_TXT))
@@ -54,6 +54,9 @@ clean:
.PRECIOUS: %.txt
+introduction.html: ../README
+ asciidoc -b xhtml11 -d article -f asciidoc.conf -o $@ $<
+
%.html : %.txt
asciidoc -b xhtml11 -d manpage -f asciidoc.conf $<
diff --git a/README b/README
--- a/README
+++ b/README
@@ -1,5 +1,5 @@
- The Cogito Version Control System
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The Cogito Version Control System
+=================================
Cogito is a version control system layered on top of the git tree history
storage system. Note that you can MOSTLY use it in parallel of other GIT
@@ -13,7 +13,8 @@ We shall first describe some quick ways
over each available command one by one.
- Downloading Cogito From Scratch
+Downloading Cogito From Scratch
+-------------------------------
Cogito can be obtained as a tarball from
@@ -39,13 +40,15 @@ The following tools are optional but str
preferred over the BSD variants)
- Starting a Fresh GIT Repository
+Starting a Fresh GIT Repository
+-------------------------------
If you want to start your own project using Cogito, there are two basic ways
to do this. You may start a fresh repository with no files in it, or you may
take an existing directory tree and turn it into a GIT repository.
- Starting an Empty Repository
+Starting an Empty Repository
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
To create a new repository with no files in it, cd into an empty directory,
and give the following command:
@@ -59,7 +62,8 @@ That's it! You're now in your own GIT re
directory. Go into it and look around, but don't change anything in there.
That's what Cogito commands are for.
- Turning an Existing Directory Into a Repository
+Turning an Existing Directory Into a Repository
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you have a directory full of files, you can easily turn this into a
GIT repository. In fact, it is virtually the same as starting an empty
@@ -73,9 +77,11 @@ editor, and you're good to go. All of th
directory are now part of a GIT archive.
- Accessing Someone Else's GIT Repository
+Accessing Someone Else's GIT Repository
+---------------------------------------
- Creating the Repository
+Creating the Repository
+~~~~~~~~~~~~~~~~~~~~~~~
If you want to get started tracking an outside GIT repository, you first
must have Cogito's executables on your $PATH. Next, you need the URL (or
@@ -114,7 +120,8 @@ When you get your prompt back, do an ls
directory.
- Tracking Others' Work
+Tracking Others' Work
+~~~~~~~~~~~~~~~~~~~~~
Of course, once you have cloned a repository, you don't just want to leave
it at that. The upstream sources are constantly being updated, and you want
@@ -170,7 +177,8 @@ since your cg-pull. The alternative and
the cg-merge command, which we shall describe later.
- Other Stuff
+Other Stuff
+~~~~~~~~~~~
If there are any changes, two IDs will be printed (I mean the line saying
"Tree change"). Pass those as parameters to cg-diff and you will get a diff
@@ -222,10 +230,11 @@ Note that we missed out a lot of stuff h
for merging (cg-merge), moving your tree to an older commit (cg-seek), etc.
- Getting Help
+Getting Help
+------------
Cogito commands come with their own helpful documentation. To get help on
-cg-update, for example, give this command:
+cg-pull, for example, give this command:
$ cg-pull --help
@@ -233,6 +242,9 @@ or, for the same information, try this:
$ cg-help cg-pull
+Additionally, the man pages for the individual commands can be used as a
+reference.
+
You can ask thoughtful questions and make suggestions on the GIT mailing list:
git@vger.kernel.org
--
Jonas Fonseca
-
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to [EMAIL PROTECTED]
More majordomo info at http://vger.kernel.org/majordomo-info.html
