cogito(7)

1COGITO(7)                                                            COGITO(7)
2
3
4

NAME

6       cogito - version control system
7

SYNOPSIS

9       cg-COMMAND <arg>...
10
11

DESCRIPTION

13       Cogito is a version control system layered on top of the git tree
14       history storage system. Amongst some of the noteworthy features, Cogito
15       has support for branching, tagging and multiple backends for
16       distributing repositories (local files, rsync, HTTP, ssh).
17
18       Cogito is implemented as a series of bash(1) scripts on top of git(7)
19       (a content-tracking filesystem) with the goal of providing an interface
20       for working with the GIT database in a manner similar to other SCM
21       tools (like CVS, BitKeeper or Monotone).
22
23

COMMANDS OVERVIEW

25       The Cogito commands can be split into regular commands and advanced
26       commands. The regular commands are those used for normal interacting
27       with the repository, while the advanced commands can be used for
28       administrating the repository and should to some degree be regarded as
29       low-level and in some cases dangerous.
30
31       Below an overview of the available commands are listed. For details on
32       individual commands, do e.g.
33
34
35       cg-help cg-log
36       or
37
38
39       cg-log --long-help
40       You can find the quick overview of the most useful commands and
41       concepts in cg-ref(7).
42
43
44   Regular commands
45       cg-add(1) [-a] [-N] [-r] FILE...
46              Add new files to the repository
47
48       cg-branch-add(1) BRANCH_NAME LOCATION
49              Add new remote branch
50
51       cg-branch-chg(1) BRANCH_NAME NEW_LOCATION
52              Change an existing remote branch repository URL
53
54       cg-branch-ls(1)
55              List configured remote branches
56
57       cg-clean(1) [-d] [-D] [-n] [-q] [-x]
58              Remove untracked files from the working tree
59
60       cg-clone(1) [-l] [-b] [-s] LOCATION [DESTDIR]
61              Clone a remote repository
62
63       cg-commit(1) [-m MESSAGE]... [-e] [-c COMMIT_ID] [OTHER_OPTIONS]
64       [FILE]... [< MESSAGE]
65              Commit changes in the working tree to the repository
66
67       cg-diff(1) [-c] [-m] [-s] [-p] [-r FROM_ID[..TO_ID]] [FILE]...
68              Show changes in the diff format
69
70       cg-export(1) [-r TREE_ID] DESTFILE
71              Export contents of a particular revision
72
73       cg-fetch(1) [-f] [-v] [BRANCH_NAME]
74              Fetch changes from a remote branch to the local repository
75
76       cg-help(1) [-c] [cg-COMMAND | COMMAND]
77              Show help for Cogito commands
78
79       cg-init(1) [-I] [-N] [-e EXCLUDEPATTERN]... [-m MESSAGE]...
80              Initialize new repository
81
82       cg-log(1) [-D DATE] [-r FROM_ID[..TO_ID]] [-d] [-s | --summary]
83       [OTHER_OPTIONS] [FILE]...
84              Show the list of changes
85
86       cg-merge(1) [-n] [-b BASE_COMMIT] [-j] [--squash] [-v] [BRANCH_NAME]
87              Merge a branch to the current branch
88
89       cg-mkpatch(1) [-m] [-s] [-r FROM_ID[..TO_ID] [-d DIRNAME]]
90              Create a patch from a commit or a series of commits
91
92       cg-mv(1) [-f] FILE... DEST
93              Rename or move files in the repository
94
95       cg-object-id(1) [-b | -c | -d | -n | -p | -t] [OBJECT_ID]
96              Get the SHA1 id of an object associated with the given symbolic
97              id
98
99       cg-patch(1) [-c] [-C COMMIT] [-pN] [-R] [-m | -d DIR] [OTHER_OPTIONS] <
100       PATCH
101              Apply a patch from a file, standard input, or a commit
102
103       cg-push(1) [-r LOCAL_BRANCH] [-t TAG]... [REMOTE_BRANCH]...
104              Push changes to a remote repository
105
106       cg-reset(1) [--adds-removes]
107              Reset the state of the working tree
108
109       cg-restore(1) [-f] [-r ID] [FILE]...
110              Restore files in the working tree to the given state
111
112       cg-rm(1) [-a] [-f] [-n] [-r] FILE...
113              Remove files from the repository
114
115       cg-seek(1) [COMMIT_ID]
116              Seek the working tree to a given commit
117
118       cg-status(1) [-g] [[-n] -s STATUS] [-w] [-x] [DIRPATH]
119              Show status of the repository and your working tree
120
121       cg-switch(1) [-f] [-l | -n | -p] [-c | -r COMMIT_ID] BRANCH
122              Switch the working tree to a different (or new) local branch
123
124       cg-tag(1) [-m MESSAGE]... [-e] [-s] [OTHER_OPTIONS] TAG_NAME
125       [OBJECT_ID]
126              Mark certain commit with a tag
127
128       cg-tag-ls(1)
129              List existing tags
130
131       cg-tag-show(1) TAGNAME...
132              Show information about given tag(s)
133
134       cg-update(1) [-f] [--squash] [-v] [BRANCH_NAME]
135              Fetch and merge changes from a remote repository
136
137       cg-version(1) [--lib-dir] [--share-dir]
138              Show the version of the Cogito toolkit
139
140       cg-version.in(1) [--lib-dir] [--share-dir]
141              Show the version of the Cogito toolkit
142
143   Advanced commands
144       cg-admin-cat(1) [-r TREE_ID] FILE...
145              Cat file(s) by filename from given tree or revision
146
147       cg-admin-ls(1) [-t TREE_ID] [PATH]
148              List contents of a particular tree in the repository
149
150       cg-admin-lsobj(1) [OBJECT_TYPE]
151              List unpacked objects in the repository
152
153       cg-admin-rewritehist(1) [-d TEMPDIR] [-r STARTREV]... [-k KEEPREV]...
154       [FILTERS] DESTBRANCH
155              Rewrite revision history
156
157       cg-admin-setuprepo(1) [-g GROUP] REPOSITORY
158              Setup a public repository
159
160       cg-admin-uncommit(1) [-t] [COMMIT_ID]
161              Undo a commit or a series of commits
162
163   Helper commands
164       There are a few helper commands that are not meant to be used from the
165       command line. They provide a library of generic functions used by many
166       of the real Cogito commands. You can safely ignore them, unless you
167       want to contribute to Cogito development.
168
169
170       cg-Xfetchprogress
171              Show a cute progressbar for cg-fetch
172
173       cg-Xfollowrenames
174              git-rev-list | git-diff-tree --stdin following renames
175
176       cg-Xlib
177              Common code shared by the Cogito toolkit
178
179       cg-Xmergefile
180              Merge two revisions of a file
181

COMMAND IDENTIFIERS

183       BRANCH_NAME
184              Indicates a branch name added with the cg-branch-add(1) or
185              cg-switch(1) commands.
186
187       COMMAND
188              Indicates a Cogito command. The cg- prefix is optional.
189
190       LOCATION
191              Indicates a local file path or a URI. See cg-branch-add(1) for a
192              list of supported URI schemes.
193
194       COMMIT_ID, FROM_ID, TO_ID, BASE_COMMIT
195              Indicates an ID resolving to a commit. The following expressions
196              can be used interchangeably as IDs:
197
198              ·  empty string, this or HEAD (current HEAD)
199
200              ·  branch name (as registered with cg-branch-add(1))
201
202              ·  tag name (as registered with cg-tag(1))
203
204              ·  date string (as recognized by the date tool)
205
206              ·  shortcut object hash (shorted unambiguous hash lead)
207
208              ·  commit object hash (as returned by cg-object-id -c)
209
210              ·  tree object hash (as returned by cg-object-id -t)
211
212       TAG_NAME
213              Indicates a free form tag name.
214
215       OBJECT_TYPE
216              Indicates a git object type i.e.: blob, commit, tree or tag.
217
218       USERNAME
219              Indicates a free form user name.
220
221       FILE   Indicates an already existing filename - always relative to the
222              root of the repository.
223

FILES

225       ~/.cgrc
226              This file is read on startup if stdout is a terminal and may
227              contain information about default command line options. Each
228              line consists of a command name and a list of options. Lines not
229              starting with a Cogito command name are ignored. To have cg-log
230              and cg-diff colorize the output put the following in ~/.cgrc:
231
232              log -c
233              diff -c
234
235              You can prevent Cogito from reading ~/.cgrc by setting the
236              CG_NORC environment variable.
237

COPYRIGHT

239       Copyright © Petr Baudis, 2005.
240
241

REFERENCES

248       1. http://git.or.cz/cogito
249          http://git.or.cz/cogito
250
251
252
253                                  12/11/2006                         COGITO(7)