Fossil Tips And Usage Hints
Not logged in
  1. Click on nodes of any timeline graph to see diffs between the two selected versions.
  1. Add the "--tk" option to "fossil diff" commands to get a pop-up window containing a complete side-by-side diff. (NB: The pop-up window is run as a separate Tcl/Tk process, so you will need to have Tcl/Tk installed on your machine for this to work. Visit http://www.activestate.com/activetcl to for a quick download of Tcl/Tk if you do not already have it on your system.)
  1. The "fossil clean -f" command makes a great alternative to "make clean".
  1. Use "fossil all changes" to look for any uncommitted edits in any of your Fossil projects. Use "fossil all pull" on your laptop prior to going off network (for example, on a long plane ride) to make sure you have all the latest content locally. Then run "fossil all push" when you get back online to upload your changes.
  1. Sub-menu options on Timelines lets you select either 20 or 200 records. But you can manual edit the "n=" query parameter in the URL to get any number of records you desire. To see a complete timeline graph, set n to some ridiculously large value like 10000000.
  1. You can manually add a "c=CHECKIN" query parameter to the timeline URL to get a snapshot of what was going on about the time of some checkin. The "CHECKIN" can be any valid check-in or version name, including tags, branch names, and dates. For example, to see what was going on in the Fossil repository on 2008-01-01, visit http://www.fossil-scm.org/fossil/timeline?c=2008-01-01.
  1. Further to the previous two hints, there are lots of query parameters that you can add to timeline pages. The available query parameters are tersely documented here.
  1. You can run "fossil test-diff --tk $file1 $file2" to get a pop-up window with side-by-side diffs of two files, even if neither of the two files is part of any Fossil repository. Note that this command is "test-diff", not "diff".
  1. On web pages showing the content of a file (for example http://www.fossil-scm.org/fossil/artifact/c7dd1de9f) you can manually add a query parameter of the form "ln=FROM,TO" to the URL that will cause the range of lines indicated to be highlighted. This is useful in pointing out a few lines of code using a hyperlink in a email or text message. Example: http://www.fossil-scm.org/fossil/artifact/c7dd1de9f?ln=28,30. Adding the "ln" query parameter without any argument simply turns on line numbers. This feature only works right with files with a mimetype of text/plain, of course.
  1. When editing documentation to be checked in as managed files, you can preview what the documentation will look like by using the special "ckout" branch name in the "doc" URL while running "fossil ui". See the embedded documentation for details.