Fossil: Artifact Content

Artifact 90059388b2ab852657b079c24331503820b8877a

File www/cmd_add.wiki part of check-in [9436bb75c3] - Updated the main page, added add... by kejoki on 2008-11-15 04:08:26.

add

The often used add command is how you tell fossil to include a (usually new) file in the repository.

fossil is designed to manage artifacts whose role is being "source" for something, most probably software program code or other text. One can imagine all kinds of ways to let fossil know just what constitutes a source; the simplest and most direct way it actually finds out is when you give it the fossil add file command.

It's reasonable to think of the import and clone commands as very high-powered versions of the add command that are combined with system level file movement and networking functions. Not particularly accurate, but reasonable.

Typing fossil add myfile causes fossil to put myfile into the repository at the next commit—provided you issue it from within the source tree, of course.

Note that the repository is not changed by the add command, but by the commit command. add myfile tells fossil to "mark" myfile as part of the repository. Only commands which actually manipulate the content of the "source" artifacts can physically put the file into (or remove it from) the repository.

Just to keep things confused, there are also commands that can manipulate the repository without affecting the checked-out sources (see fossil pull, for instance.)