Merge branch 'release-2.140.101'
[feisty_meow.git] / infobase / configuration / cron / aa_cron_defaults.crontab
index f86ce8dd1d3e63c4df0edd1c7b9381681f05ec6a..c8ff3ebe422c2f76cdf9750b78311ab9763181c0 100644 (file)
@@ -4,14 +4,26 @@
 # cron default bits to add at top of crontab...
 # by fred t. hamster, GNU GPL v3 license.
 
-# these stanzas are assumed to be present in every one of the other cron
-# example files.  unfortunately there is no way to include cron files in other
-# cron files, so the functional parts here should just be pasted directly into
-# the user's crontab.
+# every one of the crontab examples in feisty meow depends on the the stanzas
+# below.  (unfortunately there is no way to include cron files in other cron
+# files, so the functional parts here should just be pasted directly into the
+# user's crontab at the top.)
+
+# set a user name for writing unique log files.  this is important because
+# cron doesn't have the normal variable 'USER' defined.  cron does define
+# HOME, which is pretty lucky for us...
+# please change the name to the user running the cronjob, or to whatever
+# unique string you'd like to use:
+CRONUSER=FILL-CRONUSER-HERE
 
 # set the shell to bash.  (not the default for some cron implementations.)
 SHELL=/bin/bash
 
+# set the top-level folder for feisty meow here; important because cron gets
+# almost nothing from the user's environment.  this folder needs to be updated
+# for your own particular install location.
+FEISTY_MEOW_APEX=/opt/feistymeow.org/feisty_meow
+
 # crontab miniature docs:
 #
 # below is the short form key to the crontab positional entries for times:
@@ -30,12 +42,6 @@ SHELL=/bin/bash
 # the wildcard form of a crontab line is this: "* * * * * command"
 # that "command" will execute every single minute.
 
-# set a user name for writing unique log files.  this is important because
-# cron doesn't have the variable USER defined.  cron does define HOME, which
-# is pretty lucky for us...
-# you may want to use a more appropriate user name than mine, which is "fred".
-USER=fred
-
 # the guts of the crontab would follow below.  this usually is a set of valid
 # crontab lines that spell the time or times for commands to be executed.  my
 # crontabs usually have from 3 to 8 entries because i tend to atomicize the
@@ -51,15 +57,15 @@ USER=fred
 # with cron job output on some systems.  you can use the normal output
 # redirection operators to do this (e.g. '>', '2>', '&>', '>>' and '&>>').
 # /dev/null works as an output target if you don't ever want to see the
-# results from your cron jobs.  i usually prefer to write log files in the /tmp
-# directory with the ${USER} variable in the file name.  here's an example of
-# a real command with output that will *append* both output and error streams
-# ('&>>') to an output file.  if your output can be huge, then you may want to
-# overwrite the output file instead ('&>').
+# results from your cron jobs.  i usually prefer to write log files in the
+# /tmp directory with the ${CRONUSER} variable added in the file name.
+# below is a live example which we almost always include, so it's embedded
+# here for convenience.
 
+#[nechung fortune]
 # runs every minute and recreates a fortune for thunderbird signature.
 # a lot of the detail below is to get the feisty meow environment loaded for
-# the command.
-* * * * * (export LIGHTWEIGHT_INIT=true; source $HOME/feisty_meow/scripts/core/launch_feisty_meow.sh; perl $HOME/feisty_meow/scripts/text/new_sig.pl) &>>/tmp/${USER}-cron-nechung_fortune.log
+# the new_sig command.
+* * * * * (source $FEISTY_MEOW_APEX/scripts/core/launch_feisty_meow.sh; perl $FEISTY_MEOW_SCRIPTS/text/new_sig.pl) &>>/tmp/${CRONUSER}-cron-nechung_fortune.log