From adc118ed06d332d88cb37152ced7d4709a4f5e19 Mon Sep 17 00:00:00 2001
From: Ken Coar
Date: Wed, 1 Dec 1999 22:10:32 +0000
Subject: [PATCH] Add the long-awaited IndexOptions DescriptionWidth
keyword. It was waiting for a way to avoid breaking HTML tags, but
that's already been done as much as possible -- we can't do anything
about breaking HTML elements without putting a full parser in.
PR: 2324
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@84210 13f79535-47bb-0310-9956-ffa450edef68
---
docs/manual/mod/mod_autoindex.html | 23 ++++++++++++++++++++++-
1 file changed, 22 insertions(+), 1 deletion(-)
diff --git a/docs/manual/mod/mod_autoindex.html b/docs/manual/mod/mod_autoindex.html
index fde790b571..b39ed5c0f8 100644
--- a/docs/manual/mod/mod_autoindex.html
+++ b/docs/manual/mod/mod_autoindex.html
@@ -215,6 +215,17 @@ added if the directory is covered by an
IndexOptions SuppressSize
, and 19 bytes may be
added if IndexOptions SuppressLastModified
is
in effect. The widest this column can be is therefore 49 bytes.
+
+As of Apache 1.3.10, the
+DescriptionWidth
+IndexOptions keyword allows you to adjust this width
+to any arbitrary size.
+
+Caution: Descriptive text defined with AddDescription
+may contain HTML markup, such as tags and character entities. If the
+width of the description column should happen to truncate a tagged
+element (such as cutting off the end of a bolded phrase), the results
+may affect the rest of the directory listing.
@@ -545,13 +556,23 @@ IndexIgnore README .htaccess *~
REL="Help"
>Compatibility: '+/-' syntax and merging of multiple
IndexOptions directives is only available with
- Apache 1.3.3 and later; the FoldersFirst option is only
+ Apache 1.3.3 and later; the FoldersFirst and
+ DescriptionWidth options are only
available with Apache 1.3.10 and later
The IndexOptions directive specifies the behavior of the directory indexing.
Option can be one of
+- DescriptionWidth=[n | *]
+ (Apache 1.3.10 and later)
+
-
+The DescriptionWidth keyword allows you to specify the
+width of the description column in characters. If the keyword value
+is '*', then the column is automatically sized to the
+length of the longest filename in the display.
+See the section on AddDescription
+for dangers inherent in truncating descriptions.
- FancyIndexing
-
This turns on fancy indexing of directories.
--
2.40.0