>
> Upon discovering on Wednesday that there was a chunk of documentation
> missing from the external_parsers entry in attrs.html, I decided to
> do a "diff -bu" of it against an older copy (dated Aug 26). I found
> numerous errors were introduced as a result of the move to the new
> cf_generate.pl script. Here's my summary of the problems:
>
> - string list now simply identified as string, which doesn't destinguish
> attributes that allow more than one string
Restored.
> - quoted string list simply identified as "quoted"
All of them were quoted string list and are restored.
> - hrefs to htdig.html now set target='_top' (should be just for
> htsearch.html, which is the only one that opens a new frameset)
> - same for links to htnotify.html, htfuzzy.html, htmerge.html
Fixed cf_generate.pl to handle this case.
> - cf_byprog.html links to htsearch.html without setting target frame
Fixed cf_generate.pl now set target='_top' for htsearch.html only.
> - no commas or ands in "used by" lists
Added comma.
> - default values of "0" are listed as "No default"
Fixed cf_generate.pl (replaced !$value by $value =~ /^\s*$/)
> - <, > and & in default not changed to <, > and &
I did not find this problem. For instance keywords_meta_tag_names
description contains < and > that are < and > as expected. It would
help me if you could point to one specific error.
> - can't give multiple examples anymore, e.g. url_part_aliases
I changed the code so that multiple examples can be displayed using a
table. For instance:
url_part_aliases:
http://search.example.com/~htdig *site \\ <br>
http://www.htdig.org/this/ *1 \\ <br>
.html *2 <br>
url_part_aliases: foo
will be displayed as:
<table border='0'>
<tr>
<td valign='top'>
url_part_aliases:
</td>
<td nowrap>
http://search.example.com/~htdig *site \ <br>
http://www.htdig.org/this/ *1 \ <br>
.html *2 <br>
</td>
</tr>
<tr>
<td valign='top'>
url_part_aliases:
</td>
<td nowrap>
foo
</td>
</tr>
</table>
The table is generated using <url_part_aliases:> as an example separator.
Let me know if this fits your needs.
> - no more multi-line examples for external_parsers, common_url_parts,
> sort_names
Restored multiline for all of them. I must have missed something when
translating because some examples have be preserved as multiline.
> - space after \ in no_page_number_text's multi-line example (bad for
> cut'n'paste of examples)
> - same for server_aliases, star_patterns, template_map, template_patterns,
> url_part_aliases
Fixed (substituted \\ <br> with \\<br>).
> - example of setting to empty doesn't get through for "no_excerpt_text:",
> "no_next_page_text:", "no_prev_page_text:"
Fixed cf_generate.pl to handle this special case.
> - example from no_page_list_header deleted
Restored.
> - description of include directive has been deleted (an entry for
> "include" in defaults.cc shouldn't do any harm)
Included in default.cc.
> - external_parsers missing a big chunk of its description
Ouch. Restored. The program I used to translate existing attrs.html file
to new default.cc must have been confused by something in this description.
> - logging missing a small chunk of its description
Restored. I found what went wrong with the translator : it used </dd>
as a description terminator.
> - search_algorithm missing a big chunk of its description
Restored.
> - same for search_results_footer and search_results_header
Restored.
> - maximum_word_length missing its default (was 32)
Restored.
> - value of -1 for server_max_docs no longer explained
I added a comment at the end of the description.
> - descriptions add BIG strings to programs, which aren't even used by them
> (should maybe be done as comments instead?)
It could be done. It adds roughly 60k to the program. If 60k is considered
unbearable, I can change default.cc so that descriptions are in comments.
My opinion is that 60k is nothing and that these strings could be usefull if
someone wants to implement some kind of online help. Let me know what you
prefer.
> several inconsistencies that were there, and it should be a big help
> in preventing further inconsistencies from creeping in.
Thanks for saying this. I deeply apologize for the trouble. I was
careless in implementing this program and should have spent time verifying
the inconsistencies myself.
Cheers,
--
Loic Dachary
ECILA
100 av. du Gal Leclerc
93500 Pantin - France
Tel: 33 1 56 96 10 85
e-mail: [EMAIL PROTECTED]
URL: http://www.senga.org/
------------------------------------
To unsubscribe from the htdig3-dev mailing list, send a message to
[EMAIL PROTECTED] containing the single word "unsubscribe" in
the SUBJECT of the message.
