explain use_latest_release and use_max_tag in README.rst

This commit is contained in:
oldherl 2019-11-03 00:31:53 +08:00 committed by GitHub
parent f677eda656
commit 761c944f19
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -273,7 +273,8 @@ use_last_modified
Check GitHub Check GitHub
------------ ------------
Check `GitHub <https://github.com/>`_ for updates. The version returned is in date format ``%Y%m%d``, e.g. ``20130701``. Check `GitHub <https://github.com/>`_ for updates. The version returned is in date format ``%Y%m%d``,e.g. ``20130701``,
unless ``use_latest_release`` or ``use_max_tag`` is used. See below.
github github
The github repository, with author, e.g. ``lilydjwg/nvchecker``. The github repository, with author, e.g. ``lilydjwg/nvchecker``.
@ -287,13 +288,14 @@ path
use_latest_release use_latest_release
Set this to ``true`` to check for the latest release on GitHub. An annotated Set this to ``true`` to check for the latest release on GitHub. An annotated
tag creates a "release" on GitHub. It's not the same with git tags, which tag creates a "release" on GitHub. It's not the same with git tags, which
includes both annotated tags and lightweight ones. includes both annotated tags and lightweight ones. Will return the release name
instead of date.
use_max_tag use_max_tag
Set this to ``true`` to check for the max tag on GitHub. Unlike Set this to ``true`` to check for the max tag on GitHub. Unlike
``use_latest_release``, this option includes both annotated tags and ``use_latest_release``, this option includes both annotated tags and
lightweight ones, and return the largest one sorted by the lightweight ones, and return the largest one sorted by the
``sort_version_key`` option. ``sort_version_key`` option. Will return the tag name instead of date.
max_page max_page
How many pages do we search for the max tag? Default is 1. This works when How many pages do we search for the max tag? Default is 1. This works when
@ -317,7 +319,7 @@ This source supports `list options`_ when ``use_max_tag`` is set.
Check BitBucket Check BitBucket
--------------- ---------------
Check `BitBucket <https://bitbucket.org/>`_ for updates. The version returned Check `BitBucket <https://bitbucket.org/>`_ for updates. The version returned
is in date format ``%Y%m%d``, e.g. ``20130701``. is in date format ``%Y%m%d``, e.g. ``20130701``, unless ``use_max_tag`` is used. See below.
bitbucket bitbucket
The bitbucket repository, with author, e.g. ``lilydjwg/dotvim``. The bitbucket repository, with author, e.g. ``lilydjwg/dotvim``.
@ -327,7 +329,7 @@ branch
use_max_tag use_max_tag
Set this to ``true`` to check for the max tag on BitBucket. Will return the biggest one Set this to ``true`` to check for the max tag on BitBucket. Will return the biggest one
sorted by ``pkg_resources.parse_version``. sorted by ``pkg_resources.parse_version``. Will return the tag name instead of date.
ignored_tags, sort_version_key ignored_tags, sort_version_key
Deprecated. Use `list options`_ instead. Deprecated. Use `list options`_ instead.
@ -340,7 +342,8 @@ This source supports `list options`_ when ``use_max_tag`` is set.
Check GitLab Check GitLab
------------- -------------
Check `GitLab <https://gitlab.com/>`_ for updates. The version returned is in date format ``%Y%m%d``, e.g. ``20130701``. Check `GitLab <https://gitlab.com/>`_ for updates. The version returned is in date format ``%Y%m%d``, e.g. ``20130701``,
unless ``use_max_tag`` is used. See below.
gitlab gitlab
The gitlab repository, with author, e.g. ``Deepin/deepin-music``. The gitlab repository, with author, e.g. ``Deepin/deepin-music``.
@ -350,7 +353,7 @@ branch
use_max_tag use_max_tag
Set this to ``true`` to check for the max tag on GitLab. Will return the biggest one Set this to ``true`` to check for the max tag on GitLab. Will return the biggest one
sorted by ``pkg_resources.parse_version``. sorted by ``pkg_resources.parse_version``. Will return the tag name instead of date.
host host
Hostname for self-hosted GitLab instance. Hostname for self-hosted GitLab instance.