39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
-
-
+
+
-
+
-
+
|
For example, the <i><baseurl></i> for the fossil project itself is
either <b>http://www.fossil-scm.org/fossil</b> or
<b>http://www.hwaci.com/cgi-bin/fossil</b>.
If you launch the web server using the "<b>fossil server</b>" command line,
then the <i><baseurl></i> is usually
<b>http://localhost:8080/</b>.
The <i><version></i> is any unique prefix of the baseline ID for
the baseline containing the documentation you want to access.
The <i><version></i> is any unique prefix of the check-in ID for
the check-in containing the documentation you want to access.
Or <i><version></i> can be one of the keywords "<b>tip</b>" or
"<b>ckout</b>". The "<b>tip</b>" keyword means to use the most recently
checked-in baseline. This is useful if you want to see the very latest
checked-in. This is useful if you want to see the very latest
version of the documentation. The "<b>ckout</b>" keywords means to
pull the documentation file from the local source tree on disk, not
from the any versioned baseline. The "<b>ckout</b>" keyword normally
from the any check-in. The "<b>ckout</b>" keyword normally
only works when you start your server using the "<b>fossil server</b>"
or "<b>fossil ui</b>"
command line and is indented to show what the documentation you are currently
editing looks like before you check it in.
Finally, the <i><filename></i> element of the URL is the full
pathname of the documentation file starting from the root of the source
|
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
-
+
|
repository: /fossil/fossil.fossil
</pre></blockquote>
This is one of three ways to set up a
<a href="quickstart.wiki#serversetup">fossil web server</a>.
The "<b>/tip/</b>" part of the URL tells fossil to use
the documentation files from the baseline that was checked in most
the documentation files from the check-in that was checked in most
recently. This file is stored in the fossil source tree under
the name "<b>www/embeddeddoc.wiki</b>" and so that name forms the
last part of the URL.
As I sit writing this documentation file, I am testing my work by
running the "<b>fossil server</b>" command line and viewing
<b>http://localhost:8080/doc/ckout/www/embeddeddoc.wiki</b> in
Firefox. I am doing this even though I have not yet checked in
the "<b>www/embeddeddoc.wiki</b>" file for the first time. Using
the special "<b>ckout</b>" version identifier on the "<b>/doc</b>" page
it is easy to make multiple changes to multiple files and see how they all
look together before committing anything to the repository.
|