@@ -1,8 +1,8 @@ <h2>ls</h2> -The <code>ls</code> command is informational, it doesn't do anything to +The <code>ls</code><a href="#notes">*</a> command is informational, it doesn't do anything to a checked-out project, but it tells you something about it. A project consists of a "source tree" of "artifacts" (see <a href="doc/tip/www/concepts.wiki">Fossil concepts</a>.) From a practical standpoint this is a set of files and directories rooted at a main project directory. The files that are under source control aren't @@ -10,11 +10,11 @@ <code>extra</code> commands provide this information. <code>fossil ls</code> produces a listing of the files which are under source control <i>and</i> their status within the repository. The output is a simple list of STATUS/filepath pairs on separate lines. The status of a file will -likely be one of ADDED, UNCHANGED, UPDATED, or DELETED. +likely be one of ADDED, UNCHANGED, UPDATED, or DELETED. <a href="#notes">*</a> It's important to realize that this is the status <i>relative to the repository</i>, it's the status as <b>fossil</b> sees it and has nothing to do with filesystem status. If you're new to source-management/version-control systems, you'll probably get bit by this concept-bug at least once. @@ -41,10 +41,10 @@ The <code>ls</code> command is almost, but not quite entirely, the exact opposite of the <a href="wiki?name=fossil+extra"><code>extra</code> command</a>. -Notes: - * There are more states for a file to be in than those listed, including MISSING, EDITED, RENAMED and a couple of others. - * If you come from the <b>Windows</b> world, it will help to know that 'ls' is the usually <b>unix</b> command for listing a directory. +<a name="notes">Notes:</a> + * If you come from the <b>Windows</b> world, it will help to know that 'ls' is the usual <b>unix</b> command for listing a directory. + * There are more states for a file to be in than those listed, including MISSING, EDITED, RENAMED and a couple of others. See also: [fossil add], [fossil rm], [fossil extra], [fossil commit], <a href="doc/tip/www/concepts.wiki">Fossil concepts</a>, [Reference]