Author: sebb
Date: Wed Dec 10 16:51:29 2025
New Revision: 1930434
Log:
Fix up docn
Modified:
comdev/reporter.apache.org/trunk/scripts/urlutils.py
Modified: comdev/reporter.apache.org/trunk/scripts/urlutils.py
==============================================================================
--- comdev/reporter.apache.org/trunk/scripts/urlutils.py Wed Dec 10
16:26:34 2025 (r1930433)
+++ comdev/reporter.apache.org/trunk/scripts/urlutils.py Wed Dec 10
16:51:29 2025 (r1930434)
@@ -194,14 +194,16 @@ class UrlCache(object):
The interval parameter is used to determine how often to check if
the URL has changed.
(this is mainly intended to avoid excess URL requests in unit
testing).
If this is set to -1, then the URL will only be downloaded once.
+
@param url: the url to fetch (required)
- @param name: the name to use in the cache (required)
+ @param name: the name to use in the cache
+ (default path basename, else url with non-word chars replaced
by '_')
@param encoding: the encoding to use (default None)
@param errors: If encoding is provided, this specifies the
on-error action (e.g. 'ignore')
(default None)
@param useFileModTime: whether to use the file modification time
as the last check time
- If not, a hidden marker file is used (default false). Set this to
true for URLs that don't
- provide a Last-Modified header
+ If not, a hidden marker file is used (default false). Set this
to true for URLs that don't
+ provide a Last-Modified header
@return: the opened stream, using the encoding if specified.
Otherwise opened in binary mode.
"""
if name == None:
