<!--
  Licensed to the Apache Software Foundation (ASF) under one
  or more contributor license agreements.  See the NOTICE file
  distributed with this work for additional information
  regarding copyright ownership.  The ASF licenses this file
  to you under the Apache License, Version 2.0 (the
  "License"); you may not use this file except in compliance
  with the License.  You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing,
  software distributed under the License is distributed on an
  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
  KIND, either express or implied.  See the License for the
  specific language governing permissions and limitations
  under the License.
-->
<section id="tools_modification_logs_view">
	<title>Modification Logs view</title>
	<para>
		The Modification Logs view shows all sucessful and failed modifications. 
	</para>
	
	<simplesect id="tools_modification_logs_view_concept">
		<title>Concept</title>
		<para>
			All modify operations are logged to a logfile in LDIF format. Additionally 
			the result (OK or ERROR) is prepended as LDIF comment to every log record.
		</para>	
		<para>
			Example log of a sucessfully performed modification:
			<code language="LDIF">
				<sbr />
				#!RESULT OK
				<sbr />
				#!CONNECTION ldap://localhost:389
				<sbr />
				#!DATE 2006-11-04T21:32:40.134
				<sbr />
				dn: cn=Ted Geisel,ou=People,o=JNDITutorial
				<sbr />
				changetype: modify
				<sbr />
				add: mail
				<sbr />
				mail: Ted.Geisel@JNDITutorial.com
				<sbr />
				-
				<sbr />
			</code>
			
		</para>
		<para>
			Example log of a failed modification:
			<code language="LDIF">
				<sbr />
				#!RESULT ERROR
				<sbr />
				#!CONNECTION ldap://localhost:389
				<sbr />
				#!DATE 2006-11-04T21:33:05.739
				<sbr />
				#!ERROR [LDAP: error code 20 - modify/add: mail: value #0 already exists]
				<sbr />
				dn: cn=Ted Geisel,ou=People,o=JNDITutorial
				<sbr />
				changetype: modify
				<sbr />
				add: mail
				<sbr />
				mail: Ted.Geisel@JNDITutorial.com
				<sbr />
				-
				<sbr />
			</code>
		</para>	
		<para>
			The modification logging mechanism works with logfile rotation. 
			By default 10 logfiles each with 100KB per connection are used, 
			you may change these settings in the
			<link linkend="preferences_modificatoin_logs_view">
				Modification Logs preferences
			</link>. 
		</para>
	</simplesect>
			
	<simplesect id="tools_modification_logs_view_screenshot">
		<title>Example screenshot</title>
		<para>
			<screenshot>
				<mediaobject>
					<imageobject>
						<imagedata width="15cm"
							fileref="images/tools_modification_logs_1.png" format="PNG" />
					</imageobject>
				</mediaobject>
			</screenshot>
		</para>
	</simplesect>

	<simplesect id="tools_modification_logs_view_toolbar">
		<title>Toolbar</title>
		<informaltable frame='all' >
			<tgroup cols='3'>
				<colspec colname="Icon" align="center" colwidth="1*" />
				<colspec colname="Action" colwidth="2*" />
				<colspec colname="Description" colwidth="4*" />
				<thead>
					<row>
					  <entry>Icon</entry>
					  <entry>Action</entry>
					  <entry>Description</entry>
					</row>
				</thead>
				<tbody>
					<row>
					  <entry><guiicon><inlinemediaobject><imageobject><imagedata scale="50" fileref="icons/clear.gif" format="GIF"/></imageobject></inlinemediaobject></guiicon></entry>
					  <entry>Clear</entry>
					  <entry>Clears the current modification logfile.</entry>
					</row>
					<row>
					  <entry><guiicon><inlinemediaobject><imageobject><imagedata scale="50" fileref="icons/refresh.gif" format="GIF"/></imageobject></inlinemediaobject></guiicon></entry>
					  <entry>Refresh</entry>
					  <entry>Reloads the current modification logfile.</entry>
					</row>
					<row>
					  <entry><guiicon><inlinemediaobject><imageobject><imagedata scale="50" fileref="icons/previous.gif" format="GIF"/></imageobject></inlinemediaobject></guiicon></entry>
					  <entry>Older</entry>
					  <entry>Loads an older modification logfile.</entry>
					</row>
					<row>
					  <entry><guiicon><inlinemediaobject><imageobject><imagedata scale="50" fileref="icons/next.gif" format="GIF"/></imageobject></inlinemediaobject></guiicon></entry>
					  <entry>Newer</entry>
					  <entry>Loads a newer modification logfile.</entry>
					</row>
					<row>
					  <entry><guiicon><inlinemediaobject><imageobject><imagedata scale="50" fileref="icons/export.gif" format="GIF"/></imageobject></inlinemediaobject></guiicon></entry>
					  <entry>Export Modification Logs...</entry>
					  <entry>Exports the modification logs to a file.</entry>
					</row>
				</tbody>
			</tgroup>
		</informaltable>						
	</simplesect>
	
	<simplesect id="tools_modification_logs_view_drop_down_menu">
		<title>Drop Down Menu</title>
		<para>
			The drop down menu contains the following items:
			<itemizedlist>
				<listitem>
					<para>
						Enable Modification Logs: Enables/Disables the modification logs.
					</para>
				</listitem>
				<listitem>
					<para>
						Preferences...: Opens the
						<link linkend="preferences_modification_logs_view">
							Modification Logs preferences
						</link>
						dialog.
					</para>
				</listitem>
			</itemizedlist>
		</para>
	</simplesect>
	
	<simplesect id="tools_modification_logs_view_rotation">
	</simplesect>	
	
<!-- 
	Comment format, rotation
 -->	
</section>