mirror of
https://github.com/Hopiu/linkchecker.git
synced 2026-03-16 22:10:26 +00:00
157 lines
4.8 KiB
Text
157 lines
4.8 KiB
Text
Upgrading
|
|
=========
|
|
|
|
Migrating from 5.0 to 5.1
|
|
-------------------------
|
|
|
|
The --no-anchor-caching option has been deprecated and will be removed
|
|
in a future release. This option should not be used anymore.
|
|
|
|
The exit code of the linkchecker script will be zero now if all
|
|
warnings have been ignored.
|
|
|
|
Migrating from 4.x to 5.0
|
|
-------------------------
|
|
|
|
Python >= 2.5 is now required.
|
|
|
|
The CGI script access control has been removed. Please use the access
|
|
control of your webserver to restrict access to the CGI script.
|
|
An example configuration file for the Apache weberver has been included
|
|
in the distribution.
|
|
|
|
Migrating from 4.4 to 4.5
|
|
-------------------------
|
|
|
|
Configuration file entries that were enumerated (``ignoreX``,
|
|
``nofollowX``, ``noproxyX`` and ``entryX``) now have a new multiline
|
|
syntax. For example the old configuration:
|
|
|
|
::
|
|
|
|
ignore1=^mailto:
|
|
ignore2=^nntp:
|
|
|
|
should be written as:
|
|
|
|
::
|
|
|
|
ignore=
|
|
^mailto:
|
|
# this is a comment
|
|
^nntp:
|
|
|
|
Note the leading spac(es) at the beginning of each line after
|
|
``ignore=``.
|
|
If an indented line starts with a comment sign, it will be ignored.
|
|
|
|
Migrating from 4.2 to 4.3
|
|
-------------------------
|
|
|
|
The deprecated ``--disable-psyco`` option has been removed.
|
|
|
|
Migrating from 4.1 to 4.2
|
|
-------------------------
|
|
|
|
If run under Unix system as the 'root' user, LinkChecker drops
|
|
privileges and runs under the 'nobody' user account.
|
|
The new option --allow-root prevents this, ie. enables the old
|
|
pre-4.2 behaviour.
|
|
|
|
Migrating from 3.x to 4.0
|
|
-------------------------
|
|
|
|
The Python API of the linkcheck module has changed. If you were
|
|
using the library directly instead of the commandline or CGI
|
|
interfaces, you will have to adjust your code.
|
|
|
|
The default intern pattern matches now both http and https. When
|
|
checking a site ``http://example.com/``, all URLs of the form
|
|
``https://example.com/`` will now also be checked recursively.
|
|
|
|
LinkChecker now honors a "Crawl-delay" entry in robots.txt files.
|
|
The delay makes LinkChecker pause between requests to the corresponding
|
|
server, so your checking time might increase if the server enforces
|
|
such a delay through its robots.txt file.
|
|
|
|
URLs with invalid syntax are now cached, and they get matched now by
|
|
the --ingore-url option.
|
|
|
|
Migrating from 3.0 to 3.1
|
|
-------------------------
|
|
|
|
The ``xml`` output logger has been renamed to ``gxml``.
|
|
|
|
|
|
Migrating from 2.x to 3.0
|
|
-------------------------
|
|
|
|
The --warnings option is deprecated since warnings are now printed
|
|
per default. A new --no-warnings has been added if one wants to
|
|
have the old behaviour. Additionally, some old warnings about have
|
|
been removed.
|
|
|
|
The previously deprecated --status option has been removed.
|
|
|
|
The options --intern, --extern and --extern-strict have been replaced
|
|
by --ignore-url and --no-follow-url.
|
|
|
|
The configuration file format has changed. See the distributed
|
|
linkcheckerrc default config for the new syntax.
|
|
|
|
|
|
Migrating from 2.2 to 2.3
|
|
-------------------------
|
|
|
|
The per-user config file is now ``~/.linkchecker/linkcheckerrc``
|
|
(previous location was ``~/.linkcheckerrc`` ).
|
|
|
|
The default blacklist output file is now ``~/.linkchecker/blacklist``
|
|
(previous location was ``~/.blacklist``).
|
|
|
|
Python >= 2.4 is now required.
|
|
|
|
|
|
Migrating from 1.x to 2.0
|
|
-------------------------
|
|
|
|
The --output and --file-output parameters can specify the encoding
|
|
now. You should check your scripts if they support the new option
|
|
syntax.
|
|
|
|
Some added checks might trigger new warnings, so automated scripts
|
|
or alarms can have more output than with 1.x releases.
|
|
|
|
All output (file and console) is now encoded according to a given
|
|
character set encoding which defaults to ISO-8859-15. If you
|
|
relied that output was in a specific encoding, you might want to
|
|
use the output encoding option.
|
|
|
|
|
|
Migrating from 1.12.x to 1.13.0
|
|
-------------------------------
|
|
|
|
Since lots of filenames have changed you should check that any
|
|
manually installed versions prior to 1.13.0 are removed. Otherwise
|
|
you will have startup problems.
|
|
|
|
The default output logger ``text`` has now colored output if the
|
|
output terminal supports it. The old ``colored`` output logger has
|
|
been removed.
|
|
|
|
The ``-F`` option no longer suppresses normal output. The old behaviour
|
|
can be restored by giving the option ``-onone``.
|
|
|
|
The --status option is now the default and has been deprecated. The
|
|
old behaviour can be restored by giving the option ``--no-status``.
|
|
|
|
The default recursion depth is now infinite. The old behaviour
|
|
can be restored by giving the option ``--recursion-level=1``.
|
|
|
|
The option ``--strict`` has been renamed to ``--extern-strict-all``.
|
|
|
|
The commandline program ``linkchecker`` returns now non-zero exit value
|
|
when errors were encountered. Previous versions always return a zero
|
|
exit value.
|
|
For scripts to ignore exit values and therefore restore the old behaviour
|
|
you can append a ``|| true`` at the end of the command.
|