[interchange-docs] xmldocs - docelic modified 5 files

[docs at icdevgroup.org]

User:      docelic
Date:      2006-04-08 23:45:55 GMT
Modified:  bin      refs-autogen
Added:     refs     DNSBL External FileDatabase UserControl
Log:
- bin/refs-autogen: Make sure (cvs-head) is printed on all items that are
 present in last devel version. (I added this feature just like a week ago,
 but now I notice it did not print " (cvs-head)" in really all cases.

- refs/*: new items

Revision  Changes    Path
1.107     +2 -2      xmldocs/bin/refs-autogen


rev 1.107, prev_rev 1.106
Index: refs-autogen
===================================================================
RCS file: /var/cvs/xmldocs/bin/refs-autogen,v
retrieving revision 1.106
retrieving revision 1.107
diff -u -r1.106 -r1.107
--- refs-autogen	29 Mar 2006 21:17:15 -0000	1.106
+++ refs-autogen	8 Apr 2006 23:45:55 -0000	1.107
@@ -1252,8 +1252,8 @@
 	# add "(cvs-head)" to the version number. Makes it easier to see
 	# the item is current.
 	$end and $end eq $ENV{XMLDOCS_CUR_DEVEL} and $end .= " (cvs-head)";
-	@orig == 1 and $orig[0] eq $ENV{XMLDOCS_CUR_DEVEL} and
-		$orig[0] .= " (cvs-head)";
+	$orig[$#orig] eq $ENV{XMLDOCS_CUR_DEVEL} and
+		$orig[$#orig] .= " (cvs-head)";
 	
 	local $" = ", ";
 	if ( $cl > 1 ) {



1.1                  xmldocs/refs/DNSBL


rev 1.1, prev_rev 1.0
Index: DNSBL
===================================================================
__NAME__ purpose
specify real-time DNS blocklist servers
__END__


__NAME__ missing
__END__


__NAME__ see also
LockoutCommand
__END__

__NAME__ synopsis
<group choice='req'>
	<arg choice='plain' rep='repeat'><replaceable>hostname</replaceable></arg>
</group>
__END__


__NAME__ description
The directive allows definition of realtime blocklist servers (special-purpose
DNS servers) that should be contacted in order to verify client IP address
"validity". This way, you can deny access to known-bad clients (such
as ones coming in from open proxy servers).
</para><para>
Many fraudulent credit card orders are placed from open proxy machines
to hide the actual identity of the criminal, so denying access to 
open-proxy visitors might be a good idea.
__END__

__NAME__ example: Defining DNSBL
<programlisting>
DNSBL opm.blitzed.org cbl.abuseat.org sbl-xbl.spamhaus.org
</programlisting>
__END__




1.1                  xmldocs/refs/External


rev 1.1, prev_rev 1.0
Index: External
===================================================================
__NAME__ purpose
__END__


__NAME__ synopsis
<group choice='req'>
	<arg choice='plain'>No</arg>
	<arg choice='plain'>Yes</arg>
</group>
__END__


__NAME__ description
__END__

__NAME__ notes
The global &conf-External; must be enabled to allow individual catalog setting.
__END__

__NAME__ example: Defining External as a global configuration directive
<programlisting>
External yes
</programlisting>
__END__

__NAME__ example: Defining External for a specific catalog
<programlisting>
External yes
</programlisting>
__END__




1.1                  xmldocs/refs/FileDatabase


rev 1.1, prev_rev 1.0
Index: FileDatabase
===================================================================
__NAME__ purpose
specify table and column to look up in search for file contents
__END__


__NAME__ synopsis
<arg choice='plain'><replaceable>table_name</replaceable></arg>
<arg choice='opt'>:<replaceable>column_name</replaceable></arg>
__END__


__NAME__ description
Besides retrieving file contents from files on the filesystem (as usual),
&IC; has the ability to retrieve file contents from the &glos-database;.
</para><para>
The standard &conf-FileDatabase; setting includes the appropriate
table and column names.
</para><para>
In case the column is unspecified, it defaults
to the current value of global variable <varname>LANG</varname>. In case
the column named after <varname>LANG</varname> value does not exist, &IC;
finally tries with the column <database class='field'>default</database>.
__END__

__NAME__ notes
The file database must, as always, be registered first with the 
&conf-Database; directive.
</para><para>
Files in the filesystem, if they exist, always take precedence over file
contents in the database.
</para><para>
As you see, this directive allows you to create catalogs that live in the
database space, without a single file stored on disk. Don't, however,
be fooled by this option &mdash; in general, filesystem is the only
right place for your files.
__END__

__NAME__ see also
DirectiveDatabase
__END__

__NAME__ example: Defining FileDatabase
<programlisting>
FileDatabase files:data
</programlisting>
__END__

__NAME__ example: Defining FileDatabase, defaulting to LANG or 'default' column
<programlisting>
FileDatabase files
</programlisting>
__END__



1.1                  xmldocs/refs/UserControl


rev 1.1, prev_rev 1.0
Index: UserControl
===================================================================
__NAME__ purpose
enable enhanced user database functions
__END__

__NAME__ see also
UserDB
__END__

__NAME__ synopsis
<group choice='req'>
	<arg choice='plain'>No</arg>
	<arg choice='plain'>Yes</arg>
</group>
__END__


__NAME__ description
The directive enables enhanced user database functions.
</para><para>
The default &glos-UserDB; functions are programmed in the
<classname>Vend::UserDB</classname> module. When this directive is
enabled, functions from <classname>Vend::UserControl</classname> are used
instead.
__END__

__NAME__ example: Defining UserControl
<programlisting>
UserControl yes
</programlisting>
__END__

__NAME__ missing
what do you get by enabling enhanced userdb functions?
__END__