This perl module handles the SOAP protocol. The first implementation
is SOAP1.1, which is still most often used. The SOAP1.2 definition
is provided via the separate distribution XML::Compile::SOAP12.
Many (professional) applications process XML messages based on a
formal specification, expressed in XML Schemas. XML::Compile
translates between XML and Perl with the help of such schemas. Your
Perl program only handles a tree of nested HASHes and ARRAYs, and
does not need to understand namespaces and other general XML and
schema nastiness.
The XML::Compile module suite has extensive regression testing.
Probably, you want to do regression testing as well. This module
provide functions which simplify writing tests for XML::Compile
related distributions.
Upstream changes:
podlators 4.09 (unreleased)
[Pod::Text] Use Pod::Simple's logic to determine the native code
points for NO BREAK SPACE and SOFT HYPHEN instead of hard-coding the
ASCII values. Hopefully fixes the case of mysterious disappearing
open brackets on EBCDIC systems. (#118240)
podlators 4.08 (2016-09-24)
[Pod::Man] Partially revert change in 4.00 to require the name option
(--name to pod2man) when generating man pages from standard input.
Historically, pod2man silently tolerated this, and there turned out to
be a lot of software that depended on this, making the change too
disruptive. Instead, silently set the man page title to STDIN in this
case, but warn about it in the documentation. (#117990)
[Pod::Man] Fix rendering bug for "TRUE (1)", which was recognized as
needing small caps and then erroneously as a man page reference,
resulting in escaped nroff. (Found by Dan Jacobson with the
XML::LibXML::Element man page.) (Debian Bug#836831)
[Pod::Man] Fix rendering bug causing "\s0(1)" to be mistakenly marked
as a man page reference, later confusing backslash escaping.
[Pod::Man] Add new lquote and rquote options (and corresponding
--lquote and --rquote flags to pod2man) to set the left and right
quotes for C<> text independently. (#103298)
Remove test for nested L<> markup, since an upcoming version of
Pod::Simple will drop support for this. (#114075)
Changes in 1.7.7:
At the suggestion of Peter Spiess-Knafl, we will bump the
SOVERSION independent of the MAJOR.MINOR.MICRO version, in case
we break binary compatibility.
Changes in 1.7.6:
Prevent possible SEGV. (Thanks to @ngg.)
Add RPATH for OSX libs. (Please let us know if this causes a problem.)
Changes in 1.7.5:
Fix locale for decimal points
Plus a fix for Android
int64_t for 64-bit integers
Optionally suppress space after comma
Avoid null for empty stringValue
Fix null ctor/dtor, using a "Meyers Singleton"
Thanks to @marklakata and @BillyDonahue in #488 in #490.
[Changes contributed by Nick Morrott]
- Fix typo in POD documentation (fixes#730).
[Changes contributed by Olly Betts]
- Allow building against xapian-core 1.4.x as well as xapian-core
1.2.x.
omindex:
+ Also index leafname with _ and & replaced by spaces. Literal spaces are
often avoided in filenames, and "hello_world.txt" ought to be searchable for
via "hello" and "world". Partly addresses #618, reported by Julien
Pfefferkorn.
+ Make named entity look-up (e.g. é -> 233) use the same keyword-lookup
table approach we already use for HTML tags and built-in MIME content-types,
rather than a std::map, which makes it faster while using less memory.
+ Avoid using the shell to run most external commands as it's unnecessary
overhead. For the built-in filters, the only cases which now use a shell
are where we run two unzip commands. For user-specified commands, a simple
and slightly conservative test is used, which should avoid a shell in most
common cases where it isn't needed. Notably, environment variables set
before the command are handled.
+ Track files which couldn't be indexed in the user metadata and skip them by
default on subsequent runs to avoid the costs of repeatedly running a
filter on a file it can't handle. Run omindex with --retry-failed to retry
such files.
+ Overhaul the "per-site" terms:
- 'H' prefix is hostname as before, except that if the term would be > 240
bytes (unlikely but possible) the end is hashed is the same way 'U'
prefix terms are.
- 'P' terms are now added for every directory level, not just the start
URL's path.
- A new 'J' prefix term is added with the start URL (less any trailing
'/'), which means all files indexed from a particular "site" are now
indexed by one term. See #376.
+ Add 'skip' pseudo-mimetype which extensions can be mapped to, and they will
then be reported and skipped (to complement the existing 'ignore'
pseudo-mimetype which causes files with the specified extension to be
quietly ignored).
+ Treat a command of 'true' specially as meaning make the text extraction a
no-op (as actually running /bin/true effectively would). This provides a
way to index some file types by only meta-data. Fixes#519, reported by
Brian Burton.
+ Add support for wildcard mimetypes */* and *. Combined with filter command
``true`` for indexing by meta-data only, you can specify a fall back case
of indexing by meta-data only using ``--filter '*:true'``. From a
suggestion by Brian Burton on xapian-discuss.
+ Index message/rfc822 and message/news. These are individually saved email
messages and news articles.
+ Index archived web page formats MAFF and MHTML.
+ Handle .xla, yet another XL extension.
+ Handle metadata in LibreOffice HTML export (dcterms.subject,
dcterms.description, dcterms.creator and dcterms.contributor).
+ Use zlib's gzopen() instead of invoking "gzip -dc" for compressed Abiword
documents.
+ Add support for %f in command passed to --filter to allow specifying
commands where the input file is not the final argument. Fixed#570,
reported by Charles Atkinson.
+ Allow --filter to handle commands which produce output in a temporary file
rather than on stdout.
+ Allow --filter to specify the character set of the output the filter
produces.
+ Handle application/vnd.ms-excel, text/x-perl and application/x-dvi via
default --filter settings instead of hardcoded cases (now possible thanks
to the new abilities that --filter has).
+ Add support for specifying a MIME subtype of '*' in --filter arguments.
+ Add -track-ctime option to allow omindex to pick up changes to file
ownership and permissions.
+ Index terms from the leafname with an 'F' prefix, rather than treating them
as more body text. (Fixes#633, reported by Emmanuel Garette)
+ The starting URL wasn't previously URL encoded. In 1.2.18, a minimally
intrusive fix was implemented. In 1.3.2, we now encode the starting URL
as we do for the rest of the filename.
+ Don't assume .doc is application/msword but let libmagic decide, since .doc
files may actually be RTF, and sometimes people use .doc for plain-text
documentation.
+ Add support for indexing 'topic' and 'created date' meta-data for
OpenDocument format and HTML.
+ Index "topic" for PDF documents.
+ Commit changes and exit, rather than skipping the current file on most
unexpected errors reading directories or initialising libmagic - otherwise
we can end up deleting a lot of database entries on errors like EHOSTDOWN
when indexing network mounts.
+ Add --opendir-sleep=SECS option to allow working around problems with
indexing files on Microsoft DFS shares.
+ If we get ENOTDIR trying to index a file, skip it quietly (unless in
verbose mode) as we already do if we get ENOENT, since ENOTDIR is what we
get if the file and the directory it was in got removed between us getting
the filename and trying to open it.
+ Handle ENOENT, ENOTDIR and EACCES from readdir().
+ If we've already opened the file (as we often will have if using a modern
libmagic with magic_descriptor() available), then use fstat() on that fd
rather than stat()/lstat() on the pathname.
+ Pass error message string and errno value in ReadError exceptions.
+ Report strerror(errno) if we can't read a file.
+ Filtering via text/html now handles HTML documents which specify a charset.
+ Add support for indexing Microsoft Publisher files using pub2xhtml.
+ Restrict the length of what we consider to be an extension, currently to 7
characters or whatever the longest extension in the mime_map is if it is
longer.
+ Avoid '//' in temporary filenames (cosmetic only).
+ Extend --filter to handle commands which produce HTML on stdout.
+ Don't report an error if a file is deleted (or renamed) between us reading
the directory entry for it and trying to read the file itself by default.
In --verbose mode, the situation is still reported, but now with a
specific message.
+ If omindex receives any of the signals SIGHUP, SIGINT, SIGQUIT or SIGTERM,
then kill any active external filter child process, then handle the signal
as we did before. If setpgid() is available, put each external filter in
its own process group and kill the whole process group when we get a
signal.
+ Use magic_descriptor() if the version of libmagic we're building against
is new enough to have it. This eliminates an extra opening of a file
being indexed in certain cases.
+ Use rst2html to handle .rst and .rest files.
+ Index title with an 'S' prefix rather than no prefix.
+ If the document with the highest existing docid before the run was updated,
we were reporting it as "added", but now we correctly report it as
"updated".
+ Catch and report std::exception explicitly, so failing to allocate memory
is no longer reported as "Unknown exception".
omindex-list: New tool to list URLs of all the documents in a database
(or list of databases) indexed by omindex.
* The HTML parser now explicitly handles <APPLET>, <OBJECT> and <TR>.
* Use a generated compact and efficient table to convert HTML tag names
to enum codes - this is both faster and smaller than the approach we were
using, with the benefit that the table is auto-generated.
* Always use our built-in conversion code for the character sets it can handle
(previously we'd use iconv if available; now we only use iconv for other
character sets). This gives us more consistent results, and in particular
means we now handle BOMs better (at least when using GNU iconv).
* A lot of data labelled as "iso-8859-1" is actually "windows-1252". The two
only differ in characters which are control characters in iso-8859-1, so
assume the latter when we see the former.
scriptindex:
+ Remove special error handling case noting that index=nopos was replaced
with indexnopos - this was removed in 1.1.0 so there's been enough time to
upgrade.
omega:
* Add support for sorting by more than one value - e.g. SORT=+1,-2
* Add $msizelower and $msizeupper which provide access to the lower and upper
bounds on the number of matches.
* Add support for $set{weighting,coord}.
* Add weightingpurefilter option. Normally a query consisting only of filter
terms won't have relevance weights calculated. This new option allows you to
specify a weighting scheme to use for such queries, with the same values
supported as for the existing weighting option. For example,
$set{weightingpurefilter,coord} will weight such queries by how many filter
terms match each document.
* $filters now includes DATEVALUE, which means we'll force the first page when
reloading or changing page starting from existing URLs upon upgrade to 1.4.1,
but the exact same existing URL could be for a search without the date filter
where we want to force the first page, so there's an inherent ambiguity
there. Forcing first page in this case seems the least problematic
side-effect.
* Implement $match command for omegascript. Patch from Richhiey Thomas.
* Add optional prefix argument to $terms.
* $snippet now uses MSet::snippet() instead of the Snipper class.
* Add $contains{STRING1,STRING2}. Contributed by Ayush Gupta.
* Add support for negated boolean filter terms, specified by CGI parameter "N".
* Support a direction prefix on SORT: '+' for ascending, '-' for descending.
SORTREVERSE set to non-0 now flips the direction. Fixes#697, reported by
Andy Chilton.
* Add options argument to $transform.
* Cache compiled regexps used in $transform.
* Add $ord OmegaScript command which returns the Unicode codepoint for the
first character of a UTF-8 string.
* Add $chr OmegaScript command which returns the UTF-8 string for given Unicode
codepoint.
* Add $csv OmegaScript command which escapes a string for use as a field in a
CSV file ("always quote" mode inspired by patch from Gaurav Arora.)
* New $filters encoding which avoids collisions. We also compare CGI parameter
xFILTERS to what $filters would have returned in previous releases, so that
on upgrades old format serialised filters are handled correctly.
* Fix $jsonarray not to prepend ']' to the first array element.
* Skip weighting scheme setup for a pure date range query - it won't be
weighted anyway, so we can avoid having to parse weighting scheme parameters,
etc.
* Use value ranges when date range filtering by value. Should be more
efficient than a MatchDecider, and will automatically take advantage of any
future value range optimisations in xapian-core.
* Add default_db and default_template config options. These allow the default
template and default database name to be set via the config file, rather than
being stuck with the respective defaults of "default" and "query". Fixes
#310, reported by Marco Hennigs.
* Add support for non-exclusive filters. Fixes#234, reported by Thomas
Viehmann.
* Fix handling of multiple P.<prefix> fields - previously only the first seen
was used. These fields are also now taken into account when deciding if the
query has changed. $query now returns an OmegaScript list with one entry for
each CGI parameter passed.
* Allow setting query expansion scheme to "bo1".
* Make the $json and $jsonarray force the text to be valid UTF-8, since
otherwise the output isn't valid JSON.
* Check parameters to $set{weighting,bm25 ...} and $set{weighting,trad ...}
converted OK. Based on patch from Aarsh Shah.
* Add support to $set{weighting,...} for bb2, dlh, dph, ifb2, ineb2, inl2, lm,
pl2 when we're built against a xapian-core which is new enough to have these
schemes.
* Add $snippet to generate a snippet of text tailored to the search.
* Add new $json and $jsonarray OmegaScript commands to support producing JSON
output.
* Add $truncate command which truncates a string after a word.
* Add support for $set{weighting,tfidf} to allow the new TfIdfWeight weighting
scheme to be used.
+ DEFAULTOP now defaults to AND rather than OR, since that matches what pretty
much every search engine does these days. Closes ticket#512.
* Allow mapping a query string prefix to more than one term prefix (which
xapian-core has supported since 1.0.4).
* Add support for search inputs for multiple probabilistic prefixes, with
support for per-prefix stemmers.
* Drop legacy support for handling '.' separated terms in xP - that changed in
Omega 0.9.7, more than 5 years ago now.
* Remove support for OLDP CGI parameter which was superseded by xP
approximately a decade ago, and isn't even documented!
* Drop special handling for R-prefixed terms in $prettyterm - we stopped
generating these in Xapian 1.0.
templates:
* Lower case all HTML tags, attributes and values; explicitly close <option>
tags. Patches from Vivek Pal and Nirmal Singhania.
* Migrate Omega Templates to HTML5. Patch from Nirmal Sighania.
* templates/query: Remove stray double quote from generated URL for spelling
suggestion when THRESHOLD is set. Patch from Nirmal Singhania.
* templates/opensearch: Change response feeds to support OpenSearch 1.1.
Patch from Nirmal Singhania.
* templates/query: Fix setting setting of prefix map for P - in 1.3.2, this
would failed to also search in the subject. Now it also searches in the
subject and topic.
* templates/query:
+ We now map unprefixed queries to include S-prefixed terms to match the
change in omindex to prefixing terms from the title with S. You may want
to make the same update to your own templates.
+ Set up prefixes for 'author:' and 'title:'.
API:
* Constructing a Query for a non-reference counted PostingSource object will
now try to clone the PostingSource object (as happened in 1.3.4 and
earlier). This clone code was removed as part of the changes in 1.3.5 to
support optional reference counting of PostingSource objects, but that breaks
the case when the PostingSource object is on the stack and goes out of scope
before the Query object is used. Issue reported by Till Schäfer and analysed
by Daniel Vrátil in a bug report against Akonadi:
https://bugs.kde.org/show_bug.cgi?id=363741
* Add BM25PlusWeight class implementing the BM25+ weighting scheme, implemented
by Vivek Pal (https://github.com/xapian/xapian/pull/104).
* Add PL2PlusWeight class implementing the PL2+ weighting scheme, implemented
by Vivek Pal (https://github.com/xapian/xapian/pull/108).
* LMWeight: Implement Dir+ weighting scheme as DIRICHLET_PLUS_SMOOTHING.
Patch from Vivek Pal.
* Add CoordWeight class implementing coordinate matching. This can be useful
for specialised uses - e.g. to implement sorting by the number of matching
filters.
* DLHWeight,DPHWeight,PL2Weight: With these weighting schemes, the formulae
can give a negative weight contribution for a term in extreme cases. We
used to try to handle this by calculating a per-term lower bound on the
contribution and subtracting this from the contribution, but this idea
is fundamentally flawed as the total offset it adds to a document depends on
what combination of terms that document matches, meaning in general the
offset isn't the same for every matching document. So instead we now clamp
each term's weight contribution to be >= 0.
* TfIdfWeight: Always scale term weight by wqf - this seems the logical
approach as it matches the weighting we'd get if we weighted every non-unique
term in the query, as well as being explicit in the Piv+ formula.
* Fix OP_SCALE_WEIGHT to work with all weighting schemes - previously it was
ignored when using PL2Weight and LMWeight.
* PL2Weight: Greatly improve upper bound on weight:
+ Split the weight equation into two parts and maximise each separately as
that gives an easily solvable problem, and in common cases the maximum is
at the same value of wdfn for both parts. In a simple test, the upper
bounds are now just over double the highest weight actually achieved -
previously they were several hundred times. This approach was suggested by
Aarsh Shah in: https://github.com/xapian/xapian/pull/48
+ Improve upper bound on normalised wdf (wdfn) - when wdf_upper_bound >
doclength_lower_bound, we get a tighter bound by evaluating at
wdf=wdf_upper_bound. In a simple test, this reduces the upper bound on
wdfn by 36-64%, and the upper bound on the weight by 9-33%.
* PL2Weight: Fix calculation of upper_bound when P2>0. P2 is typically
negative, but for a very common term it can be positive and then we should
use wdfn_lower not wdfn_upper to adjust P_max.
* Weight::unserialise(): Check serialised form is empty when unserialising
parameter-free schemes BoolWeight, DLHWeight and DPHWeight.
* TermGenerator::set_stopper_strategy(): New method to control how the Stopper
object is used. Patch from Arnav Jain.
* QueryParser: Fix handling of CJK query over multiple prefixes. Previously
all the n-gram terms were AND-ed together - now we AND together for each
prefix, then OR the results. Fixes#719, reported by Aaron Li.
* Add Database::get_revision() method which provides access to the database
revision number for chert and glass, intended for use by xapiand. Marked
as experimental, so we don't have to go through the usual deprecation cycle
if this proves not to be the approach we want to take. Fixes#709,
reported by German M. Bravo.
* Mark RangeProcessor constructor as `explicit`.
* Update to Unicode 9.0.0.
* Reimplement ESet and ESetIterator as we did for MSet and MSetIterator in
1.3.5. ESetIterator internally now counts down to the end of the ESet, so
the end test is now against 0, rather than against eset.size(). And more of
the trivial methods are now inlined, which reduces the number of relocations
needed to load the library, and should give faster code which is a very
similar size to before.
* MSetIterator and ESetIterator are now STL-compatible random_access_iterators
(previously they were only bidirectional_iterators).
* TfIdfWeight: Support freq and squared IDF normalisations. Patch from Vivek
Pal.
* New Xapian::Query::OP_INVALID to provide an "invalid" query object.
* Reject OP_NEAR/OP_PHRASE with non-leaf subqueries early to avoid a
potential segmentation fault if the non-leaf subquery decayed at
just the wrong moment. See #508.
* Reduce positional queries with a MatchAll or PostingSource subquery to
MatchNothing (since these subqueries have no positional information, so
the query can't match).
* Deprecate ValueRangeProcessor and introduce new RangeProcessor class as
a replacement. RangeProcessor()::operator()() method returns Xapian::Query,
so a range can expand to any query. OP_INVALID is used to signal that
a range is not recognised. Fixes#663.
* Combining of ranges over the same quantity with OP_OR is now handled by
an explicit "grouping" parameter, with a sensible default which works
for value range queries. Boolean term prefixes and FieldProcessor now
support "grouping" too, so ranges and other filters can now be grouped
together.
* Formally deprecate WritableDatabase::flush(). The replacement commit()
method was added in 1.1.0, so code can be switched to use this and still
work with 1.2.x.
* Fix handling of a self-initialised PIMPL object (e.g. Xapian::Query q(q);).
Previously the uninitialised pointer was copied to itself, resulting in
undefined behaviour when the object was used to destroyed. This isn't
something you'd see in normal code, but it's a cheap check which can probably
be optimised away by the compiler (GCC 6 does).
* The Snipper class has been replaced with a new MSet::snippet() method.
The implementation has also been redone - the existing implementation was
slower than ideal, and didn't directly consider the query so would sometimes
selects a snippet which doesn't contain any of the query terms (which users
quite reasonably found surprising). The new implementation is faster, will
always prefer snippets containing query terms, and also understands exact
phrases and wildcards. Fixes#211.
* Add optional reference counting support for ErrorHandler, ExpandDecider,
KeyMaker, PostingSource, Stopper and TermGenerator. Fixes#186, reported
by Richard Boulton. (ErrorHandler's reference counting isn't actually used
anywhere in xapian-core currently, but means we can hook it up in 1.4.x if
ticket #3 gets addressed).
* Deprecate public member variables of PostingSource. The new getters and/or
setters added in 1.2.23 and 1.3.5 are preferred. Fixes#499, reported by
Joost Cassee.
* Reimplement MSet and MSetIterator. MSetIterator internally now counts down
to the end of the MSet, so the end test is now against 0, rather than against
mset.size(). And more of the trivial methods are now inlined, which reduces
the number of relocations needed to load the library, and should give faster
code which is a very similar size to before.
* Only issue prefetch hints for documents if MSet::fetch() is called. It's not
useful to send the prefetch hint right before the actual read, which was
happening since the implementation of prefetch hints in 1.3.4. Fixes#671,
reported by Will Greenberg.
* Fix OP_ELITE_SET selection in multi-database case - we were selecting
different sets for each subdatabase, but removing the special case check for
termfreq_max == 0 solves that.
* Remove "experimental" marker from FieldProcessor, since we're happy with the
API as-is. Reported by David Bremner on xapian-discuss.
* Remove "experimental" marker from Database::check(). We've not had any
negative feedback on the current API.
* Databse::check() now checks that doccount <= last_docid.
* Database::compact() on a WritableDatabase with uncommitted changes could
produce a corrupted output. We now throw Xapian::InvalidOperationError in
this case, with a message suggesting you either commit() or open the database
from disk to compact from. Reported by Will Greenberg on #xapian-discuss
* Add Arabic stemmer. Patch from Assem Chelli in
https://github.com/xapian/xapian/pull/45
* Improve the Arabic stopword list. Patch from Assem Chelli.
* Make functions defined in xapian/iterator.h 'inline'.
* Don't force the user to specify the metric in the geospatial API -
GreatCircleMetric is probably what most users will want, so a sensible
default.
* Xapian::DBCHECK_SHOW_BITMAP: This was added in 1.3.0 (so has never been in
a stable release) and was superseded by Xapian::DBCHECK_SHOW_FREELIST in
1.3.2, so just remove it.
* Make setting an ErrorHandler a no-op - this feature is deprecated and we're
not aware of anyone using it. We're hoping to rework ErrorHandler in 1.4.x,
which will be simpler without having to support the current behaviour as well
as the new. See #3.
* Update to Unicode 8.0.0. Fixes#680.
* Overhaul database compaction API. Add a Xapian::Database::compact() method,
with the Database object specifying the source database(s).
Xapian::Compactor is now just a functor to use if you want to control
progress reporting and/or the merging of user metadata. The existing API
has been reimplemented using the new one, but is marked as deprecated.
* Add support for a default value when sorting. Fixes#452, patch from
Richard Boulton.
* Make all functor objects non-copyable. Previously some were, some weren't,
but it's hard to correctly make use of this ability. Fixes#681.
* Fix use after free with WILDCARD_LIMIT_MOST_FREQUENT. If we tried to open a
postlist after processing such a wildcard, the postlist hint could be
pointing to a PostList object which had been deleted. Fixes#696, reported
by coventry.
* Add support for optional reference counting of MatchSpy objects.
* Improve Document::get_description() - the output is now always valid UTF-8,
doesn't contain implementation details like "Document::Internal", and more
clearly reports if the document is linked to a database.
* Remove XAPIAN_CONST_FUNCTION marker from sortable_serialise_() helper, as it
writes to the passed in buffer, so it isn't const or pure. Fixes
decvalwtsource2 testcase failure when compiled with clang.
* Make PostingSource::set_maxweight() public - it's hard to wrap for the
bindings as a protected method. Fixes#498, reported by Richard Boulton.
* Database:
+ Add new flag Xapian::DB_RETRY_LOCK which allows opening a database for
writing to wait until it can get a write lock. (Fixes#275, reported by
Richard Boulton).
+ Fix Database::get_doclength_lower_bound() over multiple databases when some
are empty or consist only of zero-length documents. Previously this would
report a lower bound of zero, now it reports the same lowest bound as a
single database containing all the same documents.
+ Database::check(): When checking a single table, handle the ".glass"
extension on glass database tables, and use the extension to guide the
decision of which backend the table is from.
* Query:
+ Add new OP_WILDCARD query operator, which expands wildcards lazily, so now
we create the PostList tree for a wildcard directly, rather than creating
an intermediate Query tree. OP_WILDCARD offers a choice of ways to limit
wildcard expansion (no limit, throw an exception, use the first N by term
name, or use the most frequent N). (See tickets #48 and #608).
* QueryParser:
+ Add new set_max_expansion() method which provides access to OP_WILDCARD's
choice of ways to limit expansion and can set limits for partial terms as
well as for wildcards. Partial terms now default to the 100 most frequent
matching terms. (Completes #608, reported by boomboo).
+ Deprecate set_max_wildcard_expansion() in favour of set_max_expansion().
* Add support for optional reference counting of FieldProcessor and
ValueRangeProcessor objects.
* Update Unicode character database to Unicode 7.0.0.
* New Xapian::Snipper class from Mihai Bivol's GSOC 2012 project. (mostly
fixes#211)
* Fix all get_description() methods to always return UTF-8 text. (fixes#620)
* Database::check():
+ Alter to take its "out" parameter as a pointer to std::ostream instead of a
reference, and make passing NULL mean "do not produce output", and make
the second and third parameters optional, defaulting to a quiet check.
+ Escape invalid UTF-8 data in keys and tags reported by xapian-check, using
the same code we use to clean up strings returned by get_description()
methods.
+ Correct failure message which talks above the root block when it's actually
testing a leaf key.
+ Rename DBCHECK_SHOW_BITMAP to DBCHECK_SHOW_FREELIST (old name still
provided for now, but flagged as deprecated - DBCHECK_SHOW_BITMAP was new
in 1.3.0, so will likely be removed before 1.4.0).
* Methods and functions which take a string to unserialise now consistently
call that parameter "serialised".
* Weight: Make number of distinct terms indexing each document and the
collection frequency of the term available to subclasses. Patch from
Gaurav Arora's Language Modelling branch.
* WritableDatabase: Add support for multiple subdatabases, and support opening
a stub database containing multiple subdatabases as a WritableDatabase.
* WritableDatabase can now be constructed from just a pathname (defaulting to
opening the database with DB_CREATE_OR_OPEN).
* WritableDatabase: Add flags which can be bitwise OR-ed into the second
argument when constructing:
+ Xapian::DB_NO_SYNC: to disable use of fsync, etc
+ Xapian::DB_DANGEROUS: to enable in-place updates
+ Xapian::DB_BACKEND_CHERT: if creating, create a chert database
+ Xapian::DB_BACKEND_GLASS: if creating, create a glass database
+ Xapian::DB_NO_TERMLIST: create a database without a termlist (see #181)
+ Xapian::DB_FULL_SYNC flag - if this is set for a database, we use the Mac
OS X F_FULL_SYNC instead of fdatasync()/fsync()/etc on the version file
when committing.
* Database: Add optional flags argument to constructor - the following can be
bitwise OR-ed into it:
+ Xapian::DB_BACKEND_CHERT (only open a chert database)
+ Xapian::DB_BACKEND_GLASS (only open a glass database)
+ Xapian::DB_BACKEND_STUB (only open a stub database)
* Xapian::Auto::open_stub() and Xapian::Chert::open() are now deprecated in
favour of these new flags.
* Add LMWeight class, which implements the Unigram Language Modelling weighting
scheme. Patch from Gaurav Arora.
* Add implementations of a number of DfR weighting schemes (BB2, DLH, DPH,
IfB2, IneB2, InL2, PL2). Patches from Aarsh Shah.
* Add support for the Bo1 query expansion scheme. Patch from Aarsh Shah.
* Add Enquire::set_time_limit() method which sets a timelimit after which
check_at_least will be disabled.
* Database: Trying to perform operations on a database with no subdatabases now
throws InvalidOperationError not DocNotFoundError.
* Query: Implement new OP_MAX query operator, which returns the maximum weight
of any of its subqueries. (see #360)
* Query: Add methods to allow introspection on Query objects - currently you
can read the leaf type/operator, how many subqueries there are, and get a
particular subquery. For a query which is a term, Query::get_terms_begin()
allows you to get the term. (see #159)
* Query: Only simplify OP_SYNONYM with a single subquery if that subquery is a
term or MatchAll.
* Avoid two vector copies when storing term positions in most common cases.
* Reimplement version functions to use a single function in libxapian which
returns a pointer to a static const struct containing the version
information, with inline wrappers in the API header which call this. This
means we only need one relocation instead of 4, reducing library load time a
little.
* Make TermGenerator flags an anonymous enum, and typedef TermGenerator::flags
to int for backward compatibility with existing user code which uses it.
* Stem: Fix incorrect Unicode codepoints for o-double-acute and u-double-acute
in the Hungarian Snowball stemmer. Reported by Tom Lane to snowball-discuss.
* Stem: Add an early english stemmer.
* Provide the stopword lists from Snowball plus an Arabic one, installed in
${prefix}/share/xapian-core/stopwords/. Patch from Assem Chelli, fixes#269.
* Improve check for direct inclusion of Xapian subheaders in user code to
catch more cases.
* Add simple API to help with creating language-idiomatic iterator wrappers
in <xapian/iterator.h>.
* Give an compilation error if user code tries to include API headers other
than xapian.h directly - these other headers are an internal implementation
detail, but experience has shown that some people try to include them
directly. Please just use '#include <xapian.h>' instead.
* Update Unicode character database to Unicode 6.2.0.
* Add FieldProcessor class (ticket#128) - currently marked as an experimental
API while we sort out how best to sort out exactly how it interacts with
other QueryParser features.
* Add implementation of several TF-IDF weighting schemes via a new TfIdfWeight
class.
* Add ExpandDeciderFilterPrefix class which only return terms with a particular
prefix. (fixes#467)
* QueryParser: Adjust handling of Unicode opening/closing double quotes - if a
quoted boolean term was started with ASCII double quote, then only ASCII
double quote can end it, as otherwise it's impossible to quote a term
containing Unicode double quotes.
* Database::check(): If the database can't be opened, don't emit a bogus
warning about there being too many documents to cross-check doclens.
* TradWeight,BM25Weight: Throw SerialisationError instead of NetworkError if
unserialise() fails.
* QueryParser: Change the default stemming strategy to STEM_SOME, to eliminate
the API gotcha that setting a stemmer is ignored until you also set a
strategy.
* Deprecate Xapian::ErrorHandler. (ticket#3)
* Stem: Generate a compact and efficient table to decode language names. This
is both faster and smaller than the approach we were using, with the added
benefit that the table is auto-generated.
* xapian.h:
+ Add check for Qt headers being included before us and defining
'slots' as a macro - if they are, give a clear error advising how to work
around this (previously compilation would fail with a confusing error).
+ Add a similar check for Wt headers which also define 'slots' as a macro
by default.
* Update Unicode character database to Unicode 6.1.0. (ticket#497)
* TermIterator returned by Enquire::get_matching_terms_begin(),
Query::get_terms_begin(), Database::synonyms_begin(),
QueryParser::stoplist_begin(), and QueryParser::unstem_begin() now stores the
list of terms to iterate much more compactly.
* QueryParser:
+ Allow Unicode curly double quote characters to start and/or end phrases.
+ The set_default_op() method will now reject operators which don't make
sense to set. The operators which are allowed are now explicitly
documented in the API docs.
* Query: The internals have been completely reimplemented (ticket#280). The
notable changes are:
+ Query objects are smaller and should be faster.
+ More readable format for Query::get_description().
+ More compact serialisation format for Query objects.
+ Query operators are no longer flattened as you build up a tree (but the
query optimiser still combines groups of the same operator). This means
that Query objects are truly immutable, and so we don't need to copy Query
objects when composing them. This should also fix a few O(n*n) cases when
building up an n-way query pair-wise. (ticket#273)
+ The Query optimiser can do a few extra optimisations.
* There's now explicit support for geospatial search (this API is currently
marked as experimental). (ticket#481)
* There's now an API (currently experimental) for checking the integrity of
databases (partly addresses ticket#238).
* Database::reopen() now returns true if the database may have been reopened
(previously it returned void). (ticket#548)
* Deprecate Xapian::timeout in favour of POSIX type useconds_t.
* Deprecate Xapian::percent and use int instead in the API and our own code.
* Deprecate Xapian::weight typedef in favour of just using double and change
all uses in the API and our own code. (ticket#560)
* Rearrange members of Xapian::Error to reduce its size (from 48 to 40 bytes on
x86-64 Linux).
* Assignment operators for PositionIterator and TermIterator now return *this
rather than void.
* PositionIterator, PostingIterator, TermIterator and ValueIterator now
handle their reference counts in hand-crafted code rather than using
intrusive_ptr/RefCntPtr, which means the compiler can inline the destructor
and default constructor, so a comparison to an end iterator should now
optimise to a simple NULL pointer check, but without the issues which the
ValueIteratorEnd_ proxy class approach had (such as not working in templates
or some cases of overload resolution).
* Enquire:
+ Previously, Enquire::get_matching_terms_begin() threw InvalidArgumentError
if the query was empty. Now we just return an end iterator, which is more
consistent with how empty queries behave elsewhere.
+ Remove the deprecated old-style match spy approach of using a MatchDecider.
* Remove deprecated Sorter class and MultiValueSorter subclass.
* Xapian::Stem:
+ Add stemmers for Armenian (hy), Basque (eu), and Catalan (ca).
+ Stem::operator= now returns a reference to the assigned-to object.
testsuite:
* OP_SCALE_WEIGHT: Check top weight is non-zero - if it is zero, tests which
try to check that OP_SCALE_WEIGHT works will always pass.
* testsuite: Check SerialisationError descriptions from Xapian::Weight
subclasses mention the weighting scheme name.
* Merge queryparsertest and termgentest into apitest. Their testcases now use
the backend manager machinery in the testharness, so we don't have to
hard-code use of inmemory and chert backends, but instead run them under all
backends which support the required features. This fixes some test failures
when both chert and glass are disabled due to trying to run spelling tests
with the inmemory backend.
* Avoid overflowing collection frequency in totaldoclen1. We're trying to test
total document length doesn't wrap, so avoid collection freq overflowing in
the process, as that triggers errors when running the testsuite under ubsan.
We should handle collection frequency overflow better, but that's a separate
issue.
* Add some test coverage for ESet::get_ebound().
* Fix testcase notermlist1 to check correct table extension - ".glass" not
".DB" (chert doesn't support DB_NO_TERMLIST).
* unittest: We can't use Assert() to unit test noexcept code as it throws an
exception if it fails. Instead set up macros to set a variable and return if
an assertion fails in a unittest testcase, and check that variable in the
harness.
* Add unit test for internal C_isupper(), etc functions.
* If command line option --verbose/-v isn't specified, set the verbosity level
from environmental variable VERBOSE.
* Re-enable replicate3 for glass, as it no longer fails.
* Add more test coverage for get_unique_terms().
* Don't leave an extra fd open when starting xapian-tcpsrv for remotetcp tests.
* Extend checkstatsweight1 to check that Weight::get_collection_freq() returns
the same number as Database::get_collection_freq().
* queryparsertest: Add testcase for FieldProcessor on boolean prefix with
quoted contents.
* queryparsertest: Enable some disabled cases which actually work (in some
cases with slightly tweaked expected answers which are equivalent to those
that were shown).
* Make use of the new writable multidatabase feature to simplify the
multi-database handling in the test harness.
* Change querypairwise1_helper to repeat the query build 100 times, as with a
fast modern machine we were sometimes trying with so many subqueries that we
would run out of stack.
* apitest: Use Xapian::Database::check() in cursordelbug1. (partly addresses
#238)
* apitest: Test Query ops with a single MatchAll subquery.
* apitest: New testcase readonlyparentdir1 to ensure that commit works with a
read-only parent directory.
* tests/generate-api_generated: Test that the string returned by a
get_description() method isn't empty.
* Use git commit hash in title of test coverage reports generated from a git
tree.
* Make unittest use the test harness, so it gets all the valgrind and fd leak
checks, and other handy features all the other tests have.
* Improve test coverage in several places.
* Compress generated HTML files in coverage report.
matcher:
* Fix stats passed to Weight with OP_SYNONYM. Previously the number of
unique terms was never calculated, and a term which matched all documents
would be optimised to an all-docs postlist, which fails to supply the
correct wdf info.
* Use floating point calculation for OR synonym freq estimates. The division
was being done as an integer division, which means the result was always
getting rounded down rather than rounded to the nearest integer.
* Fix upper bound on matches for OP_XOR. Due to a reversed conditional, the
estimate could be one too low in some cases where the XOR matched all the
documents in the database.
* Improve lower bound on matches for OP_XOR. Previously the lower bound was
always set to 0, which is valid, but we can often do better.
* Optimise value range which is a superset of the bounds. If the value
frequency is equal to the doccount, such a range is equivalent to MatchAll,
and we now avoid having to read the valuestream at all.
* Optimise OP_VALUE_RANGE when the upper bound can't be exceeded. In this
case, we now use ValueGePostList instead of ValueRangePostList.
* Streamline collation of statistics for use by weighting schemes - tests show
a 2% or so increase in speed in some cases.
* If a term matches all documents and its weight doesn't depend on its wdf, we
can optimise it to MatchAll (the previous requirement that maxpart == 0 was
unnecessarily strict).
* Fix the check for a term which matches all documents to use the sub-db
termfreq, not the combined db termfreq.
* When we optimise a postlist for a term which matches all documents to use
MatchAll, we still need to set a weight object on it to get percentages
calculated correctly.
* Drop MatchNothing subqueries in OR-like situations in add_subquery() rather
than adding them and then handling it later.
* Handle the left side of AND_NOT and AND_MAYBE being MatchNothing in
add_subquery() rather than in done().
* Handle QueryAndLike with a MatchNothing subquery in add_subquery() rather
than done().
* Query: Multi-way operators now store their subquery pointers in a custom
class rather than std::vector<Xapian::Query>. The custom class take the
same amount of space, or often less. It's particularly efficient when
there are two subqueries, which is very desirable as we no longer flatten a
subtree of the same operator as we build the query.
* Optimise an unweighted query term which matches all the documents in a
subdatabase to use the "MatchAll" postlist. (ticket#387)
glass backend:
* Fix allterms with prefix on glass with uncommitted changes. Glass aims to
flush just the relevant postlist changes in this case but the end of the
range to flush was wrong, so we'd only actually flush changes for a term
exactly matching the prefix. Fixes#721.
* Fix Database::check() parsing of glass changes file header. In practice this
was unlikely to actually cause problems.
* Make glass the default backend. The format should now be stable, except
perhaps in the unlikely event that a bug emerges which requires a format
change to address.
* Don't explicitly store the 2 byte "component_of" counter for the first
component of every Btree entry in leaf blocks - instead use one of the upper
bits of the length to store a "first component" flag. This directly saves 2
bytes per entry in the Btree, plus additional space due to fewer blocks and
fewer levels being needed as a result. This particularly helps the position
table, which has a lot of entries, many of them very small. The saving would
be expected to be a little less than the saving from the change which shaved
2 bytes of every Btree item in 1.3.4 (since that saved 2 bytes multiple times
for large entries which get split into multiple items). A simple test
suggests a saving of several percent in total DB size, which fits that. This
change reduces the maximum component size to 8194, which affects tables
with a 64KB blocksize in normal use and tables with >= 16KB blocksize with
full compaction.
* Refactor glass backend key comparison - == and < operations are replaced by
a compare() function returns negative, 0 or positive (like strcmp(), memcmp()
and std::string::compare()). This allows us to avoid a final compare to
check for equality when binary chopping, and to terminate early if the binary
chop hits the exact entry.
* If a cursor is moved to an entry which doesn't exist, we need to step back to
the first component of previous entry before we can read its tag. However we
often don't actually read its tag (e.g. if we only wanted the key), so make
this stepping back lazy so we can avoid doing it when we don't want to read
the tag.
* Avoid creating std::string objects to hold data when compressing and
decompressing tags with zlib.
* Store minimum compression length per table in the version file, with 0
meaning "don't compress". Currently you can only change this setting with a
hex editor on the file, but now it is there we can later make use of it
without needing a database format change.
* Database::check() now performs additional consistency checks for glass.
Reported by Jean-Francois Dockes and Bob Cargill via xapian-discuss.
* Database::check(): check docids don't exceed db_last_docid when checking
a single glass table.
* We now throw DatabaseCorruptError in a few cases where it's appropriate
but we didn't previously, in particular in the case where all the files in a
DB have been truncated to zero size (which makes handling of this case
consistent with chert).
* Fix compaction to a single file which already exists. This was hanging.
Noted by Will Greenberg on #xapian.
* Shave 2 bytes of every Btree item (which will probably typically reduce
database size by several percent).
* More compact item format for branch blocks - 2 bytes per item smaller. This
means each branch block can branch more ways, reducing the number of Btree
levels needed, which is especially helpful for cold-cache search times.
* Track an upper bound on spelling word frequency. This isn't currently used,
but will be useful for improving the spelling algorithm, and we want to
stabilise the glass backend format. See #225, reported by Philip Neustrom.
* Support 64-bit docids in the glass backend on-disk format. This changes the
encoding used by pack_uint_preserving_sort() to one which supports 64 bit
values, and is a byte smaller for values 16384-32767, and the same size for
all other 32 bit values. Fixes#686, from original report by James Aylett.
* Use memcpy() not memmove() when no risk of overlap.
* Store length of just the key data itself, allowing keys to be up to 255 bytes
long - the previous limit was 252.
* Change glass to store DB stats in the version file. Previously we stored
them in a special item in the postlist table, but putting them in the version
file reduces the number of block reads required to open the database, is
simpler to deal with, and means we can potentially recalculate tight upper
and lower bounds for an existing database without having to commit a new
revision.
* Add support for a single-file variant for glass. Currently such databases
can only be opened for reading - to create one you need to use
xapian-compact (or its API equivalent). You can embed such databases within
another file, and open them by passing in a file descriptor open on that file
and positioned at the offset the database starts at). Database::check() also
supports them. Fixes#666, reported by Will Greenberg (and previously
suggested on xapian-discuss by Emmanuel Engelhart).
* Avoid potential DB corruption with full-compaction when using 64K blocks.
* Where posix_fadvise() is available, use it to prefetch postlist Btree blocks
from the level below the root block which will be needed for postlists of
terms in the query, and similarly for the docdata table when MSet::fetch() is
called. Based on patch by Will Greenberg in #671.
* When reporting freelist errors during a database check, distinguish between a
block in use and in the freelist, and a block in the freelist more than once.
* Fix compaction and database checking for the change to the format of keys
in the positionlist table which happened in 1.3.2.
* After splitting a block, we always insert the new block in the parent right
after the block it was split from - there's no need to binary chop.
* Avoid infinite recursion when we hit the end of the freelist block we're
reading and the end of the block we're writing at the same time.
* Fix freelist handling to allow for the newly loaded first block of the
freelist being already used up.
* 'brass' backend renamed to 'glass' - we decided to use names in ascending
alphabetical order to make it easier to understand which backend is newest,
and since 'flint' was used recently, we skipped over 'd', 'e' and 'f'.
* Change positionlist keys to be ordered by term first rather than docid first,
which helps phrase searching significantly. For more efficient indexing,
positionlist changes are now batched up in memory and written out in key
order.
* Use a separate cursor for each position list - now we're ordering the
position B-tree by term first, phrase matching would cause a single cursor
to cycle between disparate areas of the B-tree and reread the same blocks
repeatedly.
* Reference count blocks in the btree cursor, so cursors can cheaply share
blocks. This can significantly reduce the amount of memory used by cursors
for queries which contain a lot of terms (e.g. wildcards which expand to a
lot of terms).
* Under glass, optimise the turning of a query into a postlist to reuse the
cursor blocks which are the same as the previous term's postlist. This is
particularly effective for a wildcard query which expands to a lot of terms.
* Keep track of unused blocks in the Btrees using freelists rather than
bitmaps. (fixes#40)
* Eliminate the base files, and instead store the root block and freelist
pointers in the "iamglass" file.
* When compacting, sync all the tables together at the end.
* In DB_DANGEROUS mode, update the version file in-place.
* Only actually store the document data if it is non-empty. The table which
holds the document data is now lazily created, so won't exist if you never
set the document data.
* Iterating positional data now decodes it lazily, which should speed up
phrases which include common words.
* Compress changesets in brass replication. Increments the changeset version.
Ticket #348
* Restore two missing lines in database checking where we report a block with
the wrong level.
* When checking if a block was newly allocated in this revision, just look
at its revision number rather than consulting the base file's bitmap.
remote backend:
* Improve handling of invalid remote stub entries: Entries without a colon now
give an error rather than being quietly skipped; IPv6 isn't yet supported,
but entries with IPv6 addresses now result in saner errors (previously the
colons confused the code which looks for a port number).
* Fix hook for remote support of user weighting schemes. The commented-out
code used entirely the wrong class - now we use the server object we have
access to, and forward the method to the class which needs it.
* Avoid dividing zero by zero when calculating the average length for an empty
database.
* Bump remote protocol version to 38.0, due to extra statistics being tracked
for weighting.
* Make Weight::Internal track if any max_part values are set, so we don't need
to serialise them when they've not been set.
* Prefix compress list of terms and metadata keys in the remote protocol.
This requires a remote protocol major version bump.
* When propagating exceptions from a remote backend server, the protocol now
sends a numeric code to represent which exception is being propagated, rather
than the name of the type, as a number can be turned back into an exception
with a simple switch statement and is also less data to transfer.
(ticket#471)
* Remote protocol (these changes require a protocol major version bump):
+ Unify REPLY_GREETING and REPLY_UPDATE.
+ Send (last_docid - doccount) instead of last_docid and (doclen_ubound -
doclen_lbound) instead of doclen_ubound.
* Remove special check which gives a more helpful error message when a modern
client is used against a remote server running Xapian <= 0.9.6.
chert backend:
* When using 64-bit Xapian::docid, consistently use the actual maximum valid
docid value rather instead of the maximum value the type can hold.
* Where posix_fadvise() is available, use it to prefetch postlist Btree blocks
from the level below the root block which will be needed for postlists of
terms in the query, and similarly for the record table when MSet::fetch() is
called. Based on patch by Will Greenberg in #671.
* Fix problems with get_unique_terms() on a modified chert database.
* Fix xapian-check on a single chert table, which seg faulted in 1.3.2.
* Improve DBCHECK_FIX:
+ if fixing a whole database, we now take the revision from the first table
we successfully look at, which should be correct in most cases, and is
definitely better than trying to determine the revision of each broken
table independently.
+ handle a zero-sized .DB file.
+ After we successfully regenerate baseA, remove any empty baseB file to
prevent it causing problems. Tracked down with help from Phil Hands.
* Iterating positional data now decodes it lazily, which should speed up
phrases which include common words.
flint backend:
* Remove flint backend.
Changelog - uritemplate
=======================
3.0.0 - 2016-08-29
------------------
- Merge uritemplate.py into uritemplate
Changelog - uritemplate.py
==========================
2.0.0 - 2016-08-20
------------------
- Relicense uritemplate.py as Apache 2 and BSD (See
https://github.com/sigmavirus24/uritemplate/pull/23)
1.0.1 - 2016-08-18
------------------
- Fix some minor packaging problems.
1.0.0 - 2016-08-17
------------------
- Fix handling of Unicode values on Python 2.6 and 2.7 for urllib.quote.
- Confirm public stable API via version number.
Upstream changes:
0.39 Tues Sept 26 2016
This release simply corrects the rev number
0.38 Mon Sept 26 2016
118069: MYMETA must not be included
0.37 Fri Sept 23 2016
101145 Add support for IO::String and "in memory" files
107301 prStrWidth returns undef when string is '0'
41287 It seems that filehandles of TTF files are not closed
79703 Allow a handle to be provided instead of a file name
107299 Warnings on empty strings in prStrWidth/prText
117892 Could not open 'Reuse.pm' (0.36_02)
93049 PDF::Reuse Bookmarks bug and fix
97290 fix for uninitialized value $param{"Index"} when reading PDF version 1.5 file
43232 Wrong prototype for findFont()
46202 PDF-Reuse 0.35 prDoc/xrefSection problem
48804 Bad PDF Spins CPU
59359 qQ imbalance in Reuse.pm
104874 prMbox() not dealing with 0 ux/uy
Thanks to all who contributed patches for these fixes!
This is a Python implementation of the WHATWG Encoding standard.
In order to be compatible with legacy web content when interpreting
something like Content-Type: text/html; charset=latin1, tools need
to use a particular set of aliases for encoding labels as well as
some overriding rules. For example, US-ASCII and iso-8859-1 on the
web are actually aliases for windows-1252, and an UTF-8 or UTF-16
BOM takes precedence over any other encoding declaration. The
Encoding standard defines all such details so that implementations
do not have to reverse-engineer each other.
This module has encoding labels and BOM detection, but the actual
implementation for encoders and decoders is Python's.
This is not a legal value for CCVER anymore. The legal values are
"gcc47" or "gcc50". However, "gcc47" should be avoid. For now everything
should build with the primary base compiler on DragonFly.
Local changes:
- reuse upstream INSTALL_TARGET dirs
- depend on documentation installed by default
Upstream changelog
==================
1.6.1: August 9, 2014
- handle unicode arguments under Windows
1.6.0: June 12, 2014
- get rid of "helpful" message about namespaces
- update user guide
- Enhancements:
- add --stop option to val
- add global option --no-doc-namespace
- Build:
- let the make install target succeed even if docs aren't built.
1.5.0: Jul 7, 2013
- Bugs:
- avoid segfault on pyx non-existant file
- fix unescaping of entities straddling 4K byte boundary (Bug #102)
- Enhancements:
- unescape hex entities (&#xXX;)
- give a helpful message if doc has default namespace and
nothing matched
- add "_" and "DEFAULT" as names for document's top-level
default namespace
- Adding a global quiet option
- ed: Allow omitting value argument to create empty element.
- use default attribute values in sel subcommand
- Build:
- fix test variables to work with newer automake (1.11 -> 1.13)
- fix usage2c.awk for mawk
- scripts for building on mingw
1.4.2: Dec 28, 2012
- pyx: avoid segfault on documents with multiple attributes (Bug
#3595212)
1.4.1: Dec 8, 2012
- avoid segfault when attempting to edit the document node (Bug
#3575722)
- Packaging:
- include doc/xmlstar-fodoc-style.xsl in the dist so that the
--enable-build-docs option works from the tarball (Bug
#3580667)
- AC_SUBST PACKAGE_TARNAME for automake so that documentation is
installed to the right place (Bug #3561958)
- Test Suite:
- avoid test failures due to XML formatting and whitespace
changes (also fixes Bug #3572789)
- use automake's parallel test suite
- make bigxml tests much faster by using whitespace instead of nodes
- don't test str:replace() with ed: it doesn't work outside of
xslt in new libxslt
- ignore extra errors from libxml 2.9.0 bug
- let tests run using busybox
- add runAllTests.sh to run tests without make
1.4.0: Aug 26, 2012
- Documentation:
- executable name used in documentation now matches
--transform-program-name (Bug #3283713)
- added Makefile rules for generating documentation
(./configure --enable-build-docs)
- ed subcommand:
- relative XPaths are now handled correctly (Bug #3527850)
- the last nodeset inserted by an edit operation can be
accessed as the XPath variable $prev (or $xstar:prev)
- add --var option to define XPath variables
- allow ed -u -x to insert nodesets instead of converting to
string
- remove hard limit for number of edit operations (Bug
#3488240)
- pyx now handles namespaces correctly
3.1.5
* Avoid Rails 5 deprecation warning about original_exception
* No longer generates <a rel="start"> for first page link since "start"
is an invalid rel value
3.1.4 (seems not released)
3.1.3
* Rails 5 compatibility for inheriting query params in pagination links
* Fix locale load path so that application can override will_paginate's
built-in translations.
3.1.2
* Further fix security vulnerability when generating pagination URLs in
Rails.
3.1.1
* Fixed security vulnerability when generating pagination URLs in Rails.
3.1.0
* Rails 5.0 support
* Drop support for old Active Record finder params to paginate():
# now unsupported:
User.paginate(:page => 1, :order => 'created_at DESC', :conditions => ...)
# convert to Arel syntax instead:
User.order('created_at DESC').where(...).paginate(:page => 1)
# or, even better:
User.order('created_at DESC').where(...).page(1)
* Add support for pagination with Mongoid
# 0.9.5 - July 22nd, 2016
- `yard doc` will now generate `.yardoc/processing` and `.yardoc/complete` files
to allow other tools to properly detect when YARD is in the middle of parsing
source files, and when it has completed writing the database.
- Added support for on-demand generation of LibraryVersion objects using the
`:disk` source type. LibraryVersion objects pointing to a .yardoc database
directory will now auto-generate if there is a `source_path` attached.
- Added warning for macros attached to non-method objects.
- Fixed a few more parsing errors.
pkgsrc change: Remove overriding gemspec to fix parslet dependency
* Drop support for Ruby 1.8.
* Fix Rison.dump to encode numeric hash keys as strings
pkgsrc change: Add support for pkg_alternatives.
== 4.3.2 / May 23rd, 2016
* Fix additional case for CVE-2012-6684 [Joshua Siler]
== 4.3.1 / May 17th, 2016
* Fix additional case for CVE-2012-6684 [Joshua Siler]
== 4.3.0 / April 29th, 2016
* Remove JRuby and Windows cross compilation and support
* Add Ruby 2.2.3 testing and support
* include CVE-2012-6684 fix [Tomas Pospisek]
* fix by [Antonio Terceiro]
* see http://sources.debian.net/src/ruby-redcloth/4.2.9-4/debian/patches/0001-Filter-out-javascript-links-when-using-filter_html-o.patch/
* vulnerability reported by [Kousuke Ebihara]
* see http://co3k.org/blog/redcloth-unfixed-xss-en
== 4.2.9.1 / February 24, 2015
* Lazy-load latex_entities.yml [Charlie Somerville]
=== 1.6.8.1 / 2016-10-03
==== Dependency License Notes
Removes required dependency on the `pkg-config` gem. This dependency
was introduced in v1.6.8 and, because it's distributed under LGPL, was
objectionable to many Nokogiri users (#1488, #1496).
This version makes `pkg-config` an optional dependency. If it's
installed, it's used; but otherwise Nokogiri will attempt to work
around its absence.
=== 1.6.8 / unreleased
==== Security Notes
[MRI] Bundled libxml2 is upgraded to 2.9.4, which fixes many security issues. Many of these had previously been patched in the vendored libxml 2.9.2 in the 1.6.7.x branch, but some are newer.
See these libxml2 email posts for more:
* https://mail.gnome.org/archives/xml/2015-November/msg00012.html
* https://mail.gnome.org/archives/xml/2016-May/msg00023.html
For a more detailed analysis, you may care to read Canonical's take on these security issues:
* http://www.ubuntu.com/usn/usn-2994-1
[MRI] Bundled libxslt is upgraded to 1.1.29, which fixes a security issue as well as many long-known outstanding bugs, some features, some portability improvements, and general cleanup.
See this libxslt email post for more:
* https://mail.gnome.org/archives/xslt/2016-May/msg00004.html
==== Features
Several changes were made to improve performance:
* [MRI] Simplify NodeSet#to_a with a minor speed-up. (#1397)
* XML::Node#ancestors optimization. (#1297) (Thanks, Bruno Sutic!)
* Use Symbol#to_proc where we weren't previously. (#1296) (Thanks, Bruno Sutic!)
* XML::DTD#each uses implicit block calls. (Thanks, @glaucocustodio!)
* Fall back to the `pkg-config` gem if we're having trouble finding the system libxml2. This should help many FreeBSD users. (#1417)
* Set document encoding appropriately even on blank document. (#1043) (Thanks, @batter!)
==== Bug Fixes
* [JRuby] fix slow add_child (#692)
* [JRuby] fix load errors when deploying to JRuby/Torquebox (#1114) (Thanks, @atambo and @jvshahid!)
* [JRuby] fix NPE when inspecting nodes returned by NodeSet#drop (#1042) (Thanks, @mkristian!)
* [JRuby] fix nil attriubte node's namespace in reader (#1327) (Thanks, @codekitchen!)
* [JRuby] fix Nokogiri munging unicode characters that require more than 2 bytes (#1113) (Thanks, @mkristian!)
* [JRuby] allow unlinking an unparented node (#1112, #1152) (Thanks, @esse!)
* [JRuby] allow Fragment parsing on a frozen string (#444, #1077)
* [JRuby] HTML `style` tags are no longer encoded (#1316) (Thanks, @tbeauvais!)
* [MRI] fix assertion failure while accessing attribute node's namespace in reader (#843) (Thanks, @2potatocakes!)
* [MRI] fix issue with GCing namespace nodes returned in an xpath query. (#1155)
* [MRI] Ensure C strings are null-terminated. (#1381)
* [MRI] Ensure Rubygems is loaded before using mini_portile2 at installation. (#1393, #1411) (Thanks, @JonRowe!)
* [MRI] Handling another edge case where the `libxml-ruby` gem's global callbacks were smashing the heap. (#1426). (Thanks to @bbergstrom for providing an isolated test case!)
* [MRI] Ensure encodings are passed to Sax::Parser xmldecl callback. (#844)
* [MRI] Ensure default ns prefix is applied correctly when reparenting nodes to another document. (#391) (Thanks, @ylecuyer!)
* [MRI] Ensure Reader handles non-existent attributes as expected. (#1254) (Thanks, @ccutrer!)
* [MRI] Cleanup around namespace handling when reparenting nodes. (#1332, #1333, #1444) (Thanks, @cuttrer and @bradleybeddoes!)
* unescape special characters in CSS queries (#1303) (Thanks, @twalpole!)
* consistently handle empty documents (#1349)
* Update to mini_portile2 2.1.0 to address whitespace-handling during patching. (#1402)
* Fix encoding of xml node namespaces.
* Work around issue installing Nokogiri on overlayfs (commonly used in Docker containers). (#1370, #1405)
==== Other Notes
* Removed legacy code remaining from Ruby 1.8.x support.
* Removed legacy code remaining from REE support.
* Removing hacky workarounds for bugs in some older versions of libxml2.
* Handling C strings in a forward-compatible manner, see https://github.com/ruby/ruby/blob/v2_2_0/NEWS#L319
== 2.9.0 / 2016-06-13 Charlie Savage
* Revamp libxml-ruby's memory management to not cause crashes when used with Nokogiri (James Laird-Wah)
* Fix garbage collection issue that sometimes caused the library to hang (Charlie Savage)
* Improved multi-threading support (Charlie Savage)
* Fix crash sometimes caused by a xml node being being freed twice (Charlie Savage)
* Fix memory leak when setting the text content of a node (Charlie Savage)
* Set a default task in the Rakefile - use "test" (Robert Haines)
* Add "hanna_gudao" gem and add "rake-compiler" to develpoment dependencies (Robert Haines)
* Use Process.getrlimit instead of `ulimit` in the tests (Robert Haines)
* Build on smartos (Steven Williamson)
* Fix compiler warnings (Charlie Savage)
* Add Xcode project for easier debugging on OSX (Charlie Savage)
* Switch from unit test to minitest (Charlie Savage)
kramdown 1.12.0 released Published on Monday, 15 August 2016
This release features two enhancements for definition lists:
1. IALs can now be applied to definition terms:
{:.classy} term
: and its definition
2. IDs for definition terms can now be created automatically (similar to
header IDs) and optionally assigned a prefix:
{:auto_ids}
term1
: definition
term2
: definition
^
{:auto_ids-prefix}
term1
: definition
term2
: definition
Furthermore, compatibility of the GFM parser has been improved in regards
to list/blockquotes/codeblocks that are used directly after a paragraph
(i.e. without a blank line).
Changes
* 4 minor change:
- Allow using an IAL for definition terms (<dt>) as is already possible with
definitions themselves (<dd>)
- Added automatic generation of IDs (with optional prefix) for terms of
definition lists (fixes#355, requested by Greg Wilson)
- Removed obfuscation for e-mail links (fixes#343, requested by Anton
Tsyganenko)
- New option ¡Ægfm_quirks¡Ç for enabling/disabling parsing differences of
the GFM parser with respect to the kramdown parser
* 4 bug fixes:
- Added support for HTML5 element <main> (fixes#334, reported by
Jean-Michel Lacroix)
- Fixed math element output for HTML converter when no math engine is set
(fixes#342, reported by Adrian Sampson)
- Fixed problem when using custom HTML formatter for syntax highlighter
rouge (fixes#356, patch by Alexey Vasiliev)
- Better compatibility with GFM when lists/blockquotes/codeblocks are used
directly after a paragraph (fixes#336 (reported by Shuanglei Tao), #359
(reported by Matti Schneider) via the patch #358 by Shuanglei Tao)
* 3 other fixes and enhancements:
- Added some more examples for how list indentation works (fixes#353,
requested by Robbert Brak)
- Using RbConfig instead of deprecated Config for determining data directory
(fixes#345, patch by C«±dric Boutillier)
- JRuby is now also tested via TravisCI (fixes#363, patch by Shuanglei Tao)
kramdown 1.11.1 released Published on Sunday, 01 May 2016
This release fixes an emphasis parsing regression introduced in the last
version.
Changes
* 1 bug fix:
- Fixed emphasis parsing regression (fixes#333, reported by Marcus
Stollsteimer)
kramdown 1.11.0 released Published on Sunday, 01 May 2016
This release fixes some bugs and includes one minor change in regards to HTML
syntax highlighting.
Changes
* 1 minor change:
- The syntax highlighting language is now always included in the output as
class name even if a syntax highlighter is used (fixes#328, requested by
SLaks)
* 3 bug fixes:
- Fixed the GFM fenced code block parser to correctly split a provided
highlighter name into language name and options parts
- Fixed problem with underscores being processed even if inside a word
(fixes#323, reported by Haruki Kirigaya)
- Fixed HTML/XML parser to correctly, case sensitively parse XML (fixes
#310, reported by cabo)
* 2 other fixes:
- Updated copyright year (fixes#331, reported by Oscar Bj«Órkman)
- Updated supported Ruby version on installation page (reported by cabo)
Upstream changes:
2.030 2016-10-13
- Fix a font naming issue introduced while satisfying
Perl::Critic.
2.029 2016-10-10
- [RT #113293] Files with cross-reference streams weren't
correctly setting the max object number (report and
troubleshooting by Marco Pessotto).
- Handle TIFF images with strips that are wider than the image
(report and patch by Jeffrey Ratcliffe).
- [RT #98574] Increase test coverage of PDF::API2::Content (tests
by Phil Perry).
- A bunch of code cleanup and documentation updates by Paul
Cochrane.
- Add a missing prereq on Win32 systems (patch by Michiel Beijen).
- [RT #113514, #98552] Fix the dash() and renderingintent()
methods in ExtGState (reported by Vadim Repin and Phil Perry).
- Satisfy all Perl::Critic severity 5 policies.
- [RT #117940] Allow PNG, GIF, and PNM files to be opened from
filehandles in addition to filenames (patch by Johan Vromans).
- [RT #33970] Fail fast when a referenced file can't be opened
(requested by Barrie Slaymaker a mere 8.5 years ago).
- Add -simplex, -duplexfliplongedge and -duplexflipshortedge as
options to $pdf->preferences() (requested by Doug Poulin).
Upstream changes:
4.015 2016-10-14 20:48:13-04:00 America/New_York
- fix bugs introduced in 4.014 that would cause [Bugs] and [Legal]
to run even when they should've skipped
4.014 2016-09-18 22:25:51-04:00 America/New_York
- make links in [Bugs] use L<> (thanks, David Zurborg!)
- added debug level logging to the weaver, plugins, and
section. GitHub #42. (thanks, Dave Rolsky)
2016.9.19
=========
----
* Default image alt text option created and set to a default of empty string "" to maintain backward compatibility
* Fix#136: --default-image-alt now takes a string as argument
* Fix#113: Stop changing quiet levels on \/script tags.
* Merge #126: Fix deprecation warning on py3 due to html.escape
* Fix#145: Running test suite on Travis CI for Python 2.6.
