none

diff --git a/TWiki/NewUserTemplate.mdwn b/TWiki/NewUserTemplate.mdwn
index ba63cf6..5ca7075 100644 (file)
--- a/TWiki/NewUserTemplate.mdwn
+++ b/TWiki/NewUserTemplate.mdwn
@@ -12,6 +12,8 @@
 
 **_Personal Preferences (details in [[TWikiVariables]])_**
 
+- Show tool-tip topic info on mouse-over of [[WikiWord]] links, on or off: (see details in [[TWikiPreferences]])
+  - Set LINKTOOLTIPINFO = on
 - Horizontal size of text edit box:
   - Set EDITBOXWIDTH = 70
 - Vertical size of text edit box:

diff --git a/TWiki/TWikiPreferences.mdwn b/TWiki/TWikiPreferences.mdwn
index dfaa4b6..88595c2 100644 (file)
--- a/TWiki/TWikiPreferences.mdwn
+++ b/TWiki/TWikiPreferences.mdwn
@@ -54,6 +54,10 @@ The following are **_site-level_** settings that affect all users in all webs on
 
 %X% **NOTE:** They are typically redefined in topics of individual [[TWikiUsers]]
 
+- Show tool-tip topic info on mouse-over of [[WikiWord]] links. Setting can be on, off, or customized. An empty setting or off setting disables the tool-tips (for better performance). The setting can contain $summary to show the topic summary, $date for the last change date, $rev for the revision, $username for the login name of the last editor, $wikiname for the WikiName, $wikiusername for Main.WikiName, $topic for the topic name, and $web for the web name
+  - Set LINKTOOLTIPINFO = on
+  - #Set LINKTOOLTIPINFO = $username - $date - $rev: $summary
+
 - Horizontal size of text edit box: (can be overwritten by user preferences)
   - Set EDITBOXWIDTH = 70
 

diff --git a/TWiki/TWikiSiteTools.mdwn b/TWiki/TWikiSiteTools.mdwn
index 7311c2f..e975192 100644 (file)
--- a/TWiki/TWikiSiteTools.mdwn
+++ b/TWiki/TWikiSiteTools.mdwn
@@ -9,6 +9,7 @@
         <li><a href="#WebStatistics Site Usage Log"> WebStatistics Site Usage Log</a><ul>
             <li><a href="#Configuring for Automatic Operat"> Configuring for Automatic Operation</a></li>
             <li><a href="#Generating Statistics Manually b"> Generating Statistics Manually by URL</a></li>
+            <li><a href="#Log File Details"> Log File Details</a></li>
           </ul>
         </li>
         <li><a href="#WebSearch"> WebSearch</a><ul>
@@ -62,13 +63,13 @@ You can use an external mail program, like <code>**sendmail**</code>, if the `Ne
 **For Unix platforms:** Edit the `cron` table so that `mailnotify` is called in an interval of your choice. Please consult `man crontab` of how to modify the table that schedules program execution at certain intervals. Example:
 
     % crontab -e
-    15,45 * * * * (cd ~twiki/public_html/bin; ./mailnotify -q)
+    0 2 * * * (cd /path/to/twiki/bin; ./mailnotify -q)
 
-The above line will call mailnotify at 15 minutes and 45 minutes past every hour. The `-q` switch suppresses all normal output.
+The above line will run mailnotify nightly at 02:00. The `-q` switch suppresses all normal output.
 
 **For ISP installations:** Many ISPs don't allow hosted accounts direct cron access, as it's often used for things that can heavily load the server. Workaround scripts are available.
 
-**On Windows NT/2000:** You can use a scheduled task if you have administrative privileges. **_Note:_** AT on an NT machine is pretty limited. Microsoft lists several third-party [replacements](http://www.microsoft.com/ntserver/partners/findoffering/serversolutions/Maintnce.asp#cron) (as of 2001-11-20, none of them free).
+**On Windows NT/2000:** You can use a scheduled task if you have administrative privileges. **_Note:_** AT on an NT machine is pretty limited. Microsoft lists several third-party [replacements](http://www.microsoft.com/ntserver/partners/findoffering/serversolutions/Maintnce.asp#cron). TWiki:Codev/CronTabWin is a free scheduler for Windows.
 
 ## <a name="WebStatistics Site Usage Log"></a><a name="_WebStatistics Site Usage Log"></a> WebStatistics Site Usage Log
 
@@ -79,10 +80,10 @@ You can generate a listing manually, or on an automated schedule, of visits to i
 ### <a name="Configuring for Automatic Operat"></a> Configuring for Automatic Operation
 
 - You can automatically generate usage statistics for all webs. To enable this:
-  - Make sure variable `$doLogTopicView, $doLogTopicSave and $doLogTopicUpload` in `TWiki.cfg` are set. This will generate log entries in file `twiki/data/log<date>.txt` .
+  - Make sure variable `$doLogTopicView, $doLogTopicSave and $doLogTopicUpload` in `TWiki.cfg` are set. This will generate log file entries (see below).
   - The [[WebStatistics]] topic must be present in all webs where you want to have statistics. You can use the topic in the Main web as a template.
   - Call the `twiki/bin/statistics` script from a cron job, once a day is recommended. This will update the [[WebStatistics]] topics in all webs.
-  - **_Attention:_** The script must run as the same user as the CGI scripts are running, which is user `nobody` on most systems. Example crontab entry: <br />`0 0 * * * (cd /path/to/TWiki/bin; ./statistics >/dev/null 2>&1)`
+  - **_Attention:_** The script must run as the same user as the CGI scripts are running, which is user `nobody` on many systems. Example crontab entry: <br />`0 0 * * * (cd /path/to/TWiki/bin; ./statistics >/dev/null 2>&1)`
   - There is a workaround in case you can't run the script as user `nobody` : Run the utility `twiki/bin/geturl` in your cron job and specify the URL of the `twiki/bin/statistics` script as a parameter. Example: <br />`0 0 * * * (cd /path/to/TWiki/bin; ./geturl mydomain.com /urlpath/to/TWiki/bin/statistics >/dev/null 2>&1)`
 
 ### <a name="Generating Statistics Manually b"></a> Generating Statistics Manually by URL
@@ -92,6 +93,79 @@ You can generate a listing manually, or on an automated schedule, of visits to i
   - Update current month for Main web only: <br />`http://mydomain.com/twiki/bin/statistics/Main`
   - Update January 2000 for Main web: <br />`http://mydomain.com/twiki/bin/statistics/Main?logdate=200001`
 
+### <a name="Log File Details"></a> Log File Details
+
+TWiki generates monthly log files which are used by the statistics
+
+- The log directory is defined by the `$logDir` variable in TWiki.cfg
+- The file name is `log<year><month>.txt`
+- Example path name: `twiki/data/log201006.txt`
+- Each access gets logged as: %BR% `| <time> | <wikiusername> | <action> | <web>.<topic> | <extra info> | <IP address> |`
+- Example log entry: %BR% `| 29 Jun 2010 - 11:45 | Main.TWikiGuest | view | TWiki.WebRss |  | 66.124.232.02 |`
+- Actions are logged if enabled in TWiki.cfg by the `$doLogTopic<action>` flags
+- Logged actions: <table border="1" cellpadding="0" cellspacing="0">
+  <tr>
+    <th bgcolor="#99CCCC"><strong> Script </strong></th>
+    <th bgcolor="#99CCCC"><strong> Action name </strong></th>
+    <th bgcolor="#99CCCC"><strong> Extra info </strong></th>
+  </tr>
+  <tr>
+    <td> attach </td>
+    <td><code>attach</code></td>
+    <td> when viewing attach screen of previous uploaded attachment: <code>filename</code></td>
+  </tr>
+  <tr>
+    <td> changes </td>
+    <td><code>changes</code></td>
+    <td>   </td>
+  </tr>
+  <tr>
+    <td> edit </td>
+    <td><code>edit</code></td>
+    <td> when editing non-existing topic: <code>(not exist)</code></td>
+  </tr>
+  <tr>
+    <td> register </td>
+    <td><code>register</code></td>
+    <td> E-mail address </td>
+  </tr>
+  <tr>
+    <td> save </td>
+    <td><code>save</code></td>
+    <td> when replacing existing revision: <code>repRev 1.3</code> %BR% when user checks the minor changes box: <code>dontNotify</code></td>
+  </tr>
+  <tr>
+    <td> search </td>
+    <td><code>search</code></td>
+    <td> search string </td>
+  </tr>
+  <tr>
+    <td> rdiff </td>
+    <td><code>rdiff</code></td>
+    <td><code>1.4 1.3</code></td>
+  </tr>
+  <tr>
+    <td> rename </td>
+    <td><code>rename</code></td>
+    <td> when moving topic: <code>moved to Newweb.NewTopic</code></td>
+  </tr>
+  <tr>
+    <td> rename </td>
+    <td><code>move</code></td>
+    <td> when moving attachment: <code>Attachment filename moved to Newweb.NewTopic</code></td>
+  </tr>
+  <tr>
+    <td> upload </td>
+    <td><code>upload</code></td>
+    <td> filename </td>
+  </tr>
+  <tr>
+    <td> view </td>
+    <td><code>view</code></td>
+    <td> when viewing non-existing topic: <code>(not exist)</code> %BR% when viewing previous topic revision: <code>r1.3</code></td>
+  </tr>
+</table>
+
 ## <a name="WebSearch"></a><a name="_WebSearch"></a> WebSearch
 
 [[WebSearch]] is an extremely fast and flexible search facility, part of the core TWiki feature set. Options include:
@@ -120,4 +194,4 @@ This is simply a preset `SEARCH`. The number of topics listed by the `limit` par
 
 > %SEARCH{"\.*" scope="topic" regex="on" nosearch="on"}%
 
--- [[MikeMannix]] - 01 Dec 2001 %BR% -- [[PeterThoeny]] - 30 Jan 2003
+-- TWiki:Main.MikeMannix - 01 Dec 2001 %BR% -- TWiki:Main.PeterThoeny - 24 Apr 2004