Differences

This shows you the differences between two versions of the page.

--- userdoc:tt_fossil [2015/08/27 16:01] – [AstLinux Fossil Command Scripts] abelbeck
+++ userdoc:tt_fossil [2015/11/02 09:55] (current) – [AstLinux Fossil Command Scripts] droemel
@@ Line 3: / Line 3: @@
 AstLinux now supports the [[http://www.fossil-scm.org/|Fossil]] package, a simple, high-reliability, distributed software configuration management system.
-Code developers have long known the importance of tracking changes by file and timeline.  Managing software configurations, particularly for complex packages such as Asterisk, and even the AstLinux system itself can greatly benefit from the same sort of tools.  Fossil is implemented as a single executable binary, and in AstLinux's case uses a single SQLite database file as the repository, which can track directories and files containing text configurations.  Even changes using the web interface changes a directory full of text files, these changes can be tracked in a timeline using Fossil.
+Code developers have long known the importance of tracking changes by file and timeline using a version control system (VCS).  Managing software configurations, particularly for complex packages such as Asterisk, and even the AstLinux system itself can greatly benefit from the same sort of tools.  Fossil is implemented as a single executable binary, and in AstLinux's case uses a single SQLite database file as the repository, which can track directories and files containing text configurations.  Even changes using the web interface changes a directory full of text files, these changes can be tracked in a timeline using Fossil.
 Additionally, Fossil has a built-in and intuitive web interface with a rich assortment of information pages, also including bug tracking, wiki, and technotes.
-Credit the Open Source packages SQLite and Fossil beginnings to [[https://twit.tv/shows/floss-weekly/episodes/320|D. Richard Hipp]].
+Credit the Open Source packages SQLite and Fossil beginnings to [[https://twit.tv/shows/floss-weekly/episodes/320|D. Richard Hipp]] //(SQLite discussion at 7 min, Fossil at 14 min)//.
-!!Note: AstLinux 1.2.4 or later is required!!
+!!Note: AstLinux 1.2.4.1 or later is required!!
 ==== Fossil Configuration ====
@@ Line 29: / Line 29: @@
 Once Fossil has been enabled and restarted, continue with the Fossil Web Interface, below.
+!!Tip ->!! If you want to automatically track daily file changes, use cron and "fossil-commit" See Below: **[[#astLinux_fossil_command_scripts|AstLinux Fossil Command Scripts]]**
 ==== Fossil Web Interface ====
@@ Line 88: / Line 91: @@
   fossil help diff
-Surely you have been in this situation, actively editing configuration files, got interrupted, and when you resume editing you first want to know "Where am I ?".  The "fossil-diff" command is a tool you will greatly appreciate.
+Surely you have been in this situation, actively editing configuration files, got interrupted, and when you resume editing you first want to know "Where was I ?".  The "fossil-diff" command is a tool you will greatly appreciate.
@@ Line 105: / Line 108: @@
   ##
   ## Fossil daily auto-commit - Do not remove, un-comment to enable
-4 * * * /usr/bin/fossil-commit >/dev/null 2>&1
+23 * * * /usr/bin/fossil-commit >/dev/null 2>&1
-The nice thing is, when nothing has changed, no commit will actually be generated. Keep in mind that even with a daily auto-commit running in the background, changes can still be manually committed with an informative comment-text message whenever desired.
+The nice thing is, when nothing has changed, no commit will actually be generated. Keep in mind that even with a daily auto-commit running in the background, changes can still be manually committed with an informative comment-text message whenever desired. Also the auto-commit comment can be edited later, when you select the commit, and then click 'Edit' (within 'Other Links') at the top section.
@@ Line 138: / Line 141: @@
 Note that you must have your current working directory set somewhere in the /mnt/kd/ tree for some of the native ''fossil'' commands to work.
-!!Note ->!! After the native ''fossil'' command session is completed, be certain to finish with the ''fossil-close'' command.
+!!Note ->!! After the native ''fossil'' command session is completed, be certain to finish with the ''fossil-close'' command, or alternatively the native "fossil close" command.
 **The "fossil-close" command:**
@@ Line 157: / Line 160: @@
   fossil help diff
-And at the [[http://www.fossil-scm.org/index.html/help|Command-Line Help]] on the Fossil website.
+Additionally at the [[http://www.fossil-scm.org/index.html/help|Command-Line Help]] on the Fossil website.
 ==== Reset Fossil Repository ====
@@ Line 180: / Line 183: @@
 would only include the directories and files defined, plus any "Include Dirs" and "Include Files" in the Network tab.
+==== Fossil Tweaks ====
+In the "Fossil Web Interface" if you want to display 'Check-ins' by default on the 'Timeline' button (instead of 'Any Type'), then you need to edit the 'Header' section under the 'Admin/Skins' menu, and add "?y=ci" to the URL for the 'Timeline' button on the menu bar:
+Change:
+  menulink $index_page Home
+  if {[anycap jor]} {
+    menulink /timeline Timeline
+to:
+  menulink $index_page Home
+  if {[anycap jor]} {
+    menulink /timeline?y=ci Timeline