File Annotation
Not logged in
9436bb75c3 2008-11-15    kejoki: <h2>add</h2>
9436bb75c3 2008-11-15    kejoki: 
9436bb75c3 2008-11-15    kejoki: The often used <code>add</code> command is how you tell <b>fossil</b> to
9436bb75c3 2008-11-15    kejoki: include a (usually new) file in the repository.
9436bb75c3 2008-11-15    kejoki: 
9436bb75c3 2008-11-15    kejoki: <b>fossil</b> is designed to manage artifacts whose role is being
9436bb75c3 2008-11-15    kejoki: "source" for something, most probably software program code or other
9436bb75c3 2008-11-15    kejoki: text.  One can imagine all kinds of ways to let fossil know just what
9436bb75c3 2008-11-15    kejoki: constitutes a source; the simplest and most direct way it
9436bb75c3 2008-11-15    kejoki: <i>actually</i> finds out is when you give it the
9436bb75c3 2008-11-15    kejoki: <code> fossil add <i>file</i> </code> command.
9436bb75c3 2008-11-15    kejoki: 
9436bb75c3 2008-11-15    kejoki: It's reasonable to think of
9436bb75c3 2008-11-15    kejoki: the <a href="cmd_import.wiki"><code>import</code></a>
9436bb75c3 2008-11-15    kejoki: and <a href="cmd_clone.wiki"><code>clone</code></a>
9436bb75c3 2008-11-15    kejoki: commands as very high-powered versions of the <code>add</code>
9436bb75c3 2008-11-15    kejoki: command that are combined with system level file movement and
9436bb75c3 2008-11-15    kejoki: networking functions.  Not particularly accurate, but reasonable.
9436bb75c3 2008-11-15    kejoki: 
9436bb75c3 2008-11-15    kejoki: Typing <code>fossil add myfile</code> causes fossil to put
9436bb75c3 2008-11-15    kejoki: <i>myfile</i> into the repository at the next
9436bb75c3 2008-11-15    kejoki: <code>commit</code>&#8212;provided you issue it from within the source
9436bb75c3 2008-11-15    kejoki: tree, of course.
9436bb75c3 2008-11-15    kejoki: 
9436bb75c3 2008-11-15    kejoki: Note that the repository is <u>not</u> changed by the <code>add</code>
9436bb75c3 2008-11-15    kejoki: command, but by the <code>commit</code> command.  <code>add</code>
9436bb75c3 2008-11-15    kejoki: <i>myfile</i> tells <b>fossil</b> to "mark" <i>myfile</i> as part of
9436bb75c3 2008-11-15    kejoki: the repository.  Only commands which actually manipulate the content
9436bb75c3 2008-11-15    kejoki: of the "source" artifacts can physically put the file into (or remove
9436bb75c3 2008-11-15    kejoki: it from) the repository.
9436bb75c3 2008-11-15    kejoki: 
9436bb75c3 2008-11-15    kejoki: Just to keep things confused, there are also commands that can
9436bb75c3 2008-11-15    kejoki: manipulate the repository without affecting the checked-out sources
9436bb75c3 2008-11-15    kejoki: (see <a href="cmd_pull.wiki">fossil pull</a>, for instance.)
9436bb75c3 2008-11-15    kejoki: 
9436bb75c3 2008-11-15    kejoki: See also: <a href="cmd_rm.wiki">fossil rm</a>,
9436bb75c3 2008-11-15    kejoki: <a href="cmd_import.wiki">fossil import</a>,
9436bb75c3 2008-11-15    kejoki: <a href="cmd_clone.wiki">fossil clone</a>,
9436bb75c3 2008-11-15    kejoki: <a href="cmd_commit.wiki">fossil commit</a>,
9436bb75c3 2008-11-15    kejoki: <a href="cmd_pull.wiki">fossil pull</a>,
9436bb75c3 2008-11-15    kejoki: <a href="cmd_settings.wiki">fossil setting</a> (async),
9436bb75c3 2008-11-15    kejoki: <a href="reference.wiki">Reference</a>