Community-Lab introduction

Help: open
Login

The "open" command:

Usage: fossil open REPOSITORY ?VERSION? ?OPTIONS?

Open a new connection to the repository name REPOSITORY. A checkout for the repository is created with its root at the current working directory, or in DIR if the "--workdir DIR" is used. If VERSION is specified then that version is checked out. Otherwise the most recent check-in on the main branch (usually "trunk") is used.

REPOSITORY can be the filename for a repository that already exists on the local machine or it can be a URI for a remote repository. If REPOSITORY is a URI in one of the formats recognized by the clone command, then remote repo is first cloned, then the clone is opened. The clone will be stored in the current directory, or in DIR if the "--repodir DIR" option is used. The name of the clone will be taken from the last term of the URI. For "http:" and "https:" URIs, you can append an extra term to the end of the URI to get any repository name you like. For example:

fossil open https://fossil-scm.org/home/new-name

The base URI for cloning is "https://fossil-scm.org/home". The extra "new-name" term means that the cloned repository will be called "new-name.fossil".

Options:

--empty
Initialize checkout as being empty, but still connected with the local repository. If you commit this checkout, it will become a new "initial" commit in the repository.
-f|--force
Continue with the open even if the working directory is not empty.
--force-missing
Force opening a repository with missing content
--keep
Only modify the manifest and manifest.uuid files
--nested
Allow opening a repository inside an opened checkout
--repodir DIR
If REPOSITORY is a URI that will be cloned, store the clone in DIR rather than in "."
--setmtime
Set timestamps of all files to match their SCM-side times (the timestamp of the last checkin which modified them).
--workdir DIR
Use DIR as the working directory instead of ".". The DIR directory is created if it does not exist.

See also: close, clone