From 28b35c55a1fd7963227011b1a8a3dae2feb308a3 Mon Sep 17 00:00:00 2001
From: David Lord <davidism@gmail.com>
Date: Sun, 23 Jun 2019 12:27:25 -0700
Subject: [PATCH] update docs config

---
 docs/Makefile                                 |   3 +-
 docs/_static/flask-favicon.ico                | Bin 2238 -> 0 bytes
 docs/_static/{flask.png => flask-icon.png}    | Bin
 .../_static/{logo-full.png => flask-logo.png} | Bin
 docs/_static/touch-icon.png                   | Bin 1297 -> 0 bytes
 docs/conf.py                                  |  29 ++--
 docs/contents.rst.inc                         |  62 ---------
 docs/flaskstyle.sty                           | 124 ------------------
 docs/index.rst                                |  68 +++++++++-
 docs/latexindex.rst                           |   6 -
 docs/logo.pdf                                 | Bin 23915 -> 0 bytes
 docs/make.bat                                 |  71 +++++-----
 docs/requirements.txt                         |   5 +-
 13 files changed, 115 insertions(+), 253 deletions(-)
 delete mode 100644 docs/_static/flask-favicon.ico
 rename docs/_static/{flask.png => flask-icon.png} (100%)
 rename docs/_static/{logo-full.png => flask-logo.png} (100%)
 delete mode 100644 docs/_static/touch-icon.png
 delete mode 100644 docs/contents.rst.inc
 delete mode 100644 docs/flaskstyle.sty
 delete mode 100644 docs/latexindex.rst
 delete mode 100644 docs/logo.pdf

diff --git a/docs/Makefile b/docs/Makefile
index fc19e49d..51285967 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -4,7 +4,6 @@
 # You can set these variables from the command line.
 SPHINXOPTS    =
 SPHINXBUILD   = sphinx-build
-SPHINXPROJ    = Flask
 SOURCEDIR     = .
 BUILDDIR      = _build
 
@@ -17,4 +16,4 @@ help:
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
\ No newline at end of file
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
diff --git a/docs/_static/flask-favicon.ico b/docs/_static/flask-favicon.ico
deleted file mode 100644
index bf0a961573dcfb1eddccf97c1caefd03b807633c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 2238
zcmeIyYb>5;7{Kwr)@$n2SsltS?=Yu1P1&$v&J5d}i<z@+m?=9jS~aY7DDO~*M~Da+
zk|qri64FoA_(FpCg!o3{&^WdZWpB5ondGT2%hE5q@7zzG=lWgOeJ59*+@K(z#>U8>
z%KWYjI)H_I$wPR`*Yo&ULqS0SMMXs<5(!F5N+>HUqoSgMs;Vk#YHFyftD~Wzfu^P=
zT3T9YYipyYr-#12J_ZH`7#bR4WMqU?D#gUa1XEK}%*@O%H#f(^!U9W6ORTJ{u(r0w
z#>NI)TU+ex?69}D$HBn?CnqPIot<%UalzHq6*o6G+}+*r@bJLX(-SW*FTB0I@%8n^
z&(9Bke}4i30tgHYBq%6|;NW0FLP7`)4J9lrjPUSqA|fJ)jEp2IDvIdnXkubwh>eXU
zE-sGv_;?Z$5=cx;Bq=G0<m6;hQc_4wO(iWYjr8<%GBPsA%*-S!D~s&xY;tmP$j!|q
zFE5Y${Co-u3Mecrq^PKf;^JaTN=hg#Ev2lijPmkwDk>_dtgNJ}s*39BYHDg~sI9G~
zuC5N5Oh$cuJq-;FG&MER+}un{OAD>7t+chZ(ca!pM@I*pot<=bb<y43O;1k`y}iBk
z_4U!;-_N~!_qc!mJ_7>-3=R%5G&IEU@Gv7IBaDuYGB!5Gg9i_I`0yd)<KsMf^oWUx
z2_`2enVOnndU~3fnHgqhXPKLuV}5>~g@pwc7Z+JtT4H&5nU$3lR##V9TU%p&eVvVs
z4IV#!%;x4MTU%RfZ*Q}+v%~K0E_-`>JbChjr%#`<zrWAH!2ySdha4Rp@$A_%j*pKy
zIXOA&H~imTK?j8YU^KpT&+7$IZvH-2Qgtme=hW-Pr}HYmPV+U<;gYt*NL}4fD!;c3
z68@19X=lxO>;wD~3cZXiFGpO>3jONF3zvnWcutvQdBExOT0!u7?*%=7sSeiVHO(s)
zLX}I*DfsK7@e6~u-1K#H?^L~hM}&ol%ebmI77I5&YY^i+cWk3B(Nv#NDaQ4#s0xa{
zt-?<wVk{(F1TQsRA=goq8;p3nEH0&1i1}62W8Wpr;g+0IMOpZOH$yMvH{KP#5%upw
zNV<B<T=4j@P}Dz_5Fg$w2)7euqAu0Y5^^);B-U6#ka1o^Ql2i~AV;)3S;Dz@Zptb9
zBT@If^2__5VESEC!!>dL&?oiho7bWPeY}P03XznLFJSp)O3UrLMHdyzMLbJE%{bs&
zOFf&EToILrWEeUIX}(b^u7Xgfgw)`NmY1>6dR;9|ytRLqgt))7_D`t!?QH)y`U<X`
HQ%C**)+P8g

diff --git a/docs/_static/flask.png b/docs/_static/flask-icon.png
similarity index 100%
rename from docs/_static/flask.png
rename to docs/_static/flask-icon.png
diff --git a/docs/_static/logo-full.png b/docs/_static/flask-logo.png
similarity index 100%
rename from docs/_static/logo-full.png
rename to docs/_static/flask-logo.png
diff --git a/docs/_static/touch-icon.png b/docs/_static/touch-icon.png
deleted file mode 100644
index ef151f15dfddcadc085a8bf456047082e8d336c3..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1297
zcmV+s1@8KZP)<h;3K|Lk000e1NJLTq002M$002M;00000j{+_N000EoNkl<ZSi|j?
zYfO`86vzMX+Y6<D6}41a3Wymn0mY%*RFHb%lCfdL3)5&+f=HZmY|$*)1m|tWWNwRw
zWMtq13^0;RWlEew$M6CHg=7v<0l8QvE7A*vVrkDl6wFKpzOQ`se0-iKznpWPb7crq
z6Bcg(F95dchUZfPe4>1GWJ-V~E7IJj1X#Bj#;G}xb<SDp8>Hh+Act790n7#(iKmPM
zE&{+i$GwFqhi=<n2haj2KS<VI6aXlD9l#He%$H189?m%lxbAG`3%H#CAY|)_z8h5H
z1^{svY#ad$0nn=L0>o)sXhzW5>!tw1n&*DP<AK|KIsd}*&Cvn?5G~txx`pV}%}%n1
zg30XXXhKIA00i%?G>z8%+)G46HLFvjML}O$IROUz;kQ+kPSkRUh={c3_b$L;qG!eD
z44iyWl#$1*O}^XU@_Dwk;Bi-*C_EzaAEyl*15pUvPae3o^-A%hWy>;af%rttDqye(
z+yTog=2mCT`_N<91jH74i2&5d`nduaf>l0kSO);?QQ7(#0DzBd!f&`|qbRXk2eGT_
zY(jdb40Zr8%+T}6#xek^1<EiSrP9hyA|gHQ<rB(AF#rXmiFc@H->Bn!8?RhQ02JYD
zF&WDb)R`UUQCtBm0KDtz=W34IWN*C{Ymz!Fv+}A)e}Mt8^jPv|<DqBE(DBjWZS^7+
z?5?EvEyBJ50B6wI`H)vpjoA<lscU_AuYPz(6;N<a9s7V6Ag*IR%vn+XSB=fmjqONm
z)zL#<Rr$%RBS7TW`2lXzir2T&NUMc*a`b@^0H92;D7AIBYn6SeftvuaKZam-;nP??
z{XPSP!emw+;y92-R`cpi3sRrD06lI=io&sr<(K$%rm8If#7(5jq(L(gQTO6O?r{Jh
z-o6NsE?oOKVPVqyr37?pzU8F>74CQVGeQLK)LfzwPj@|^&O{?IdjLRPR1xXUgb>js
z$rro;bbj|702`@KC0PB8h^z(sw7dYc?VtdV{b5J}G*|6JWct{`3ox*v7{GhoZJq#9
ziKw%A$EyK?+!yYYDC*cQw4SyH^lUTLtn!9z+PynbeCEV>QxpKU>^D=r?~e-sbR{)b
za{fjlB4gSaIRtsx^Q6J*^k0eS%5YE#cM||7dDHf@q|;;xv@2_`7kl{66%HK|hjZ6}
zsC<8w901^)$N&e4Y-@19&hZzBh$wIOaR7k3CzPjr_t<GPR~X*FAs5CaQ`M8N0A^c4
zUA4`N^^FkZJW0#Q8u-r>-DD;ZQF-!ZZ}@@rQUJm*M=0G0$?X`sHf_SO$xI-kra2C@
z8kiM2mecKTF`A-&A~LRnx9$}H(xoweD`f5f<cx20&!6?Dj#Qa1{xp*b+Eo$><lBj8
zbbK6T{&(rB`7UJo%?cX;z{@x)-+s*{e22^BUoMzd`wVvVb_WNxJeCLj?Q_y|f{i7n
zT-84J?pLk~7O)tHZ2Dn&LBPt2XRO%CC<zX;wU;&-!~?zM_W@?YweR;Td4#sDOH|Si
z03y~)eQV^U2kMjrjbsu4FjW6Qc(2!HH8_cdciZ7?9UZ%Hk6&WyS)*acMx4n5we{9L
zCpR~Ng^@h%tM{?V<sKfYNYP6(5;xIXW{M^lvfga2Qw97BDVh|hoMdgo00000NkvXX
Hu0mjf4YFdZ

diff --git a/docs/conf.py b/docs/conf.py
index a6bf4e5b..9fe9d985 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -1,13 +1,11 @@
-# -*- coding: utf-8 -*-
-from __future__ import print_function
-
-from pallets_sphinx_themes import ProjectLink, get_version
+from pallets_sphinx_themes import get_version
+from pallets_sphinx_themes import ProjectLink
 
 # Project --------------------------------------------------------------
 
 project = "Flask"
-copyright = "2010 Pallets Team"
-author = "Pallets Team"
+copyright = "2010 Pallets"
+author = "Pallets"
 release, version = get_version("Flask")
 
 # General --------------------------------------------------------------
@@ -18,10 +16,11 @@ extensions = [
     "sphinx.ext.intersphinx",
     "sphinxcontrib.log_cabinet",
     "pallets_sphinx_themes",
+    "sphinx_issues",
 ]
 intersphinx_mapping = {
     "python": ("https://docs.python.org/3/", None),
-    "werkzeug": ("http://werkzeug.pocoo.org/docs/", None),
+    "werkzeug": ("https://werkzeug.palletsprojects.com/", None),
     "click": ("https://click.palletsprojects.com/", None),
     "jinja": ("http://jinja.pocoo.org/docs/", None),
     "itsdangerous": ("https://itsdangerous.palletsprojects.com/", None),
@@ -29,6 +28,7 @@ intersphinx_mapping = {
     "wtforms": ("https://wtforms.readthedocs.io/en/stable/", None),
     "blinker": ("https://pythonhosted.org/blinker/", None),
 }
+issues_github_path = "pallets/flask"
 
 # HTML -----------------------------------------------------------------
 
@@ -49,25 +49,16 @@ html_sidebars = {
 }
 singlehtml_sidebars = {"index": ["project.html", "localtoc.html"]}
 html_static_path = ["_static"]
-html_favicon = "_static/flask-favicon.ico"
-html_logo = "_static/flask.png"
+html_favicon = "_static/flask-icon.png"
+html_logo = "_static/flask-icon.png"
 html_title = "Flask Documentation ({})".format(version)
 html_show_sourcelink = False
 
 # LaTeX ----------------------------------------------------------------
 
 latex_documents = [
-    (master_doc, "Flask.tex", "Flask Documentation", "Pallets Team", "manual")
+    (master_doc, "Flask-{}.tex".format(version), html_title, author, "manual")
 ]
-latex_use_modindex = False
-latex_elements = {
-    "papersize": "a4paper",
-    "pointsize": "12pt",
-    "fontpkg": r"\usepackage{mathpazo}",
-    "preamble": r"\usepackage{flaskstyle}",
-}
-latex_use_parts = True
-latex_additional_files = ["flaskstyle.sty", "logo.pdf"]
 
 # Local Extensions -----------------------------------------------------
 
diff --git a/docs/contents.rst.inc b/docs/contents.rst.inc
deleted file mode 100644
index f76b1591..00000000
--- a/docs/contents.rst.inc
+++ /dev/null
@@ -1,62 +0,0 @@
-User's Guide
-------------
-
-This part of the documentation, which is mostly prose, begins with some
-background information about Flask, then focuses on step-by-step
-instructions for web development with Flask.
-
-.. toctree::
-   :maxdepth: 2
-
-   foreword
-   advanced_foreword
-   installation
-   quickstart
-   tutorial/index
-   templating
-   testing
-   errorhandling
-   logging
-   config
-   signals
-   views
-   appcontext
-   reqcontext
-   blueprints
-   extensions
-   cli
-   server
-   shell
-   patterns/index
-   deploying/index
-   becomingbig
-
-API Reference
--------------
-
-If you are looking for information on a specific function, class or
-method, this part of the documentation is for you.
-
-.. toctree::
-   :maxdepth: 2
-
-   api
-
-Additional Notes
-----------------
-
-Design notes, legal information and changelog are here for the interested.
-
-.. toctree::
-   :maxdepth: 2
-
-   design
-   htmlfaq
-   security
-   unicode
-   extensiondev
-   styleguide
-   upgrading
-   changelog
-   license
-   contributing
diff --git a/docs/flaskstyle.sty b/docs/flaskstyle.sty
deleted file mode 100644
index cd53c898..00000000
--- a/docs/flaskstyle.sty
+++ /dev/null
@@ -1,124 +0,0 @@
-\definecolor{TitleColor}{rgb}{0,0,0}
-\definecolor{InnerLinkColor}{rgb}{0,0,0}
-
-% Replace Unicode character 'PARTY POPPER' (U+1F389) with a non-breaking space.
-% pdfLaTeX doesn't support Unicode.
-\DeclareUnicodeCharacter{1F389}{\nobreakspace}
-
-\renewcommand{\maketitle}{%
-  \begin{titlepage}%
-    \let\footnotesize\small
-    \let\footnoterule\relax
-    % Apply following fix only on PDF output, i.e. pdfoutput macro is not 
-    % undefined
-    \ifx\pdfoutput\undefined\else
-      \begingroup
-      % This \def is required to deal with multi-line authors; it
-      % changes \\ to ', ' (comma-space), making it pass muster for
-      % generating document info in the PDF file.
-      \def\\{, }
-      \pdfinfo{
-        /Author (\@author)
-        /Title (\@title)
-      }
-      \endgroup
-    \fi
-    \begin{flushright}%
-      %\sphinxlogo%
-      {\center
-        \vspace*{3cm}
-      	\includegraphics{logo.pdf}
-        \vspace{3cm}
-	\par
-        {\rm\Huge \@title \par}%
-        {\em\LARGE \py@release\releaseinfo \par}
-        {\large
-         \@date \par
-         \py@authoraddress \par
-        }}%
-    \end{flushright}%\par
-    \@thanks
-  \end{titlepage}%
-  \cleardoublepage%
-  \setcounter{footnote}{0}%
-  \let\thanks\relax\let\maketitle\relax
-  %\gdef\@thanks{}\gdef\@author{}\gdef\@title{}
-}
-
-\fancypagestyle{normal}{
-  \fancyhf{}
-  \fancyfoot[LE,RO]{{\thepage}}
-  \fancyfoot[LO]{{\nouppercase{\rightmark}}}
-  \fancyfoot[RE]{{\nouppercase{\leftmark}}}
-  \fancyhead[LE,RO]{{ \@title, \py@release}}
-  \renewcommand{\headrulewidth}{0.4pt}
-  \renewcommand{\footrulewidth}{0.4pt}
-}
-
-\fancypagestyle{plain}{
-  \fancyhf{}
-  \fancyfoot[LE,RO]{{\thepage}}
-  \renewcommand{\headrulewidth}{0pt}
-  \renewcommand{\footrulewidth}{0.4pt}
-}
-
-\titleformat{\section}{\Large}%
-            {\py@TitleColor\thesection}{0.5em}{\py@TitleColor}{\py@NormalColor}
-\titleformat{\subsection}{\large}%
-            {\py@TitleColor\thesubsection}{0.5em}{\py@TitleColor}{\py@NormalColor}
-\titleformat{\subsubsection}{}%
-            {\py@TitleColor\thesubsubsection}{0.5em}{\py@TitleColor}{\py@NormalColor}
-\titleformat{\paragraph}{\large}%
-            {\py@TitleColor}{0em}{\py@TitleColor}{\py@NormalColor}
-
-\ChNameVar{\raggedleft\normalsize}
-\ChNumVar{\raggedleft \bfseries\Large}
-\ChTitleVar{\raggedleft \rm\Huge}
-
-\renewcommand\thepart{\@Roman\c@part}
-\renewcommand\part{%
-   \pagestyle{plain}
-   \if@noskipsec \leavevmode \fi
-   \cleardoublepage
-   \vspace*{6cm}%
-   \@afterindentfalse
-   \secdef\@part\@spart}
-
-\def\@part[#1]#2{%
-    \ifnum \c@secnumdepth >\m@ne
-      \refstepcounter{part}%
-      \addcontentsline{toc}{part}{\thepart\hspace{1em}#1}%
-    \else
-      \addcontentsline{toc}{part}{#1}%
-    \fi
-    {\parindent \z@ %\center
-     \interlinepenalty \@M
-     \normalfont
-     \ifnum \c@secnumdepth >\m@ne
-       \rm\Large \partname~\thepart
-       \par\nobreak
-     \fi
-     \MakeUppercase{\rm\Huge #2}%
-     \markboth{}{}\par}%
-    \nobreak
-    \vskip 8ex
-    \@afterheading}
-\def\@spart#1{%
-    {\parindent \z@ %\center
-     \interlinepenalty \@M
-     \normalfont
-     \huge \bfseries #1\par}%
-     \nobreak
-     \vskip 3ex
-     \@afterheading}
-
-% use inconsolata font
-\usepackage{inconsolata}
-
-% fix single quotes, for inconsolata. (does not work)
-%%\usepackage{textcomp}
-%%\begingroup
-%%  \catcode`'=\active
-%%  \g@addto@macro\@noligs{\let'\textsinglequote}
-%%  \endgroup
-%%\endinput
diff --git a/docs/index.rst b/docs/index.rst
index 52acff41..4e80f34a 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -3,7 +3,7 @@
 Welcome to Flask
 ================
 
-.. image:: _static/logo-full.png
+.. image:: _static/flask-logo.png
     :alt: Flask: web development, one drop at a time
     :align: center
     :target: https://palletsprojects.com/p/flask/
@@ -24,4 +24,68 @@ toolkit. The documentation for these libraries can be found at:
 .. _Jinja: https://www.palletsprojects.com/p/jinja/
 .. _Werkzeug: https://www.palletsprojects.com/p/werkzeug/
 
-.. include:: contents.rst.inc
+
+User's Guide
+------------
+
+This part of the documentation, which is mostly prose, begins with some
+background information about Flask, then focuses on step-by-step
+instructions for web development with Flask.
+
+.. toctree::
+   :maxdepth: 2
+
+   foreword
+   advanced_foreword
+   installation
+   quickstart
+   tutorial/index
+   templating
+   testing
+   errorhandling
+   logging
+   config
+   signals
+   views
+   appcontext
+   reqcontext
+   blueprints
+   extensions
+   cli
+   server
+   shell
+   patterns/index
+   deploying/index
+   becomingbig
+
+
+API Reference
+-------------
+
+If you are looking for information on a specific function, class or
+method, this part of the documentation is for you.
+
+.. toctree::
+   :maxdepth: 2
+
+   api
+
+
+Additional Notes
+----------------
+
+Design notes, legal information and changelog are here for the interested.
+
+.. toctree::
+   :maxdepth: 2
+
+   design
+   htmlfaq
+   security
+   unicode
+   extensiondev
+   styleguide
+   upgrading
+   changelog
+   license
+   contributing
diff --git a/docs/latexindex.rst b/docs/latexindex.rst
deleted file mode 100644
index 288197c3..00000000
--- a/docs/latexindex.rst
+++ /dev/null
@@ -1,6 +0,0 @@
-:orphan:
-
-Flask Documentation
-===================
-
-.. include:: contents.rst.inc
diff --git a/docs/logo.pdf b/docs/logo.pdf
deleted file mode 100644
index bd820c24728485ddc545e791da2a64d7794b6e6e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 23915
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
F{{zt|4LSe-

diff --git a/docs/make.bat b/docs/make.bat
index 5ca2df6d..7893348a 100644
--- a/docs/make.bat
+++ b/docs/make.bat
@@ -1,36 +1,35 @@
-@ECHO OFF
-
-pushd %~dp0
-
-REM Command file for Sphinx documentation
-
-if "%SPHINXBUILD%" == "" (
-	set SPHINXBUILD=sphinx-build
-)
-set SOURCEDIR=.
-set BUILDDIR=_build
-set SPHINXPROJ=Flask
-
-if "%1" == "" goto help
-
-%SPHINXBUILD% >NUL 2>NUL
-if errorlevel 9009 (
-	echo.
-	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
-	echo.installed, then set the SPHINXBUILD environment variable to point
-	echo.to the full path of the 'sphinx-build' executable. Alternatively you
-	echo.may add the Sphinx directory to PATH.
-	echo.
-	echo.If you don't have Sphinx installed, grab it from
-	echo.http://sphinx-doc.org/
-	exit /b 1
-)
-
-%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
-goto end
-
-:help
-%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
-
-:end
-popd
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=.
+set BUILDDIR=_build
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.http://sphinx-doc.org/
+	exit /b 1
+)
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+
+:end
+popd
diff --git a/docs/requirements.txt b/docs/requirements.txt
index e667deaa..543ec917 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,3 +1,4 @@
-Sphinx~=1.8.0
-Pallets-Sphinx-Themes~=1.1.0
+Sphinx~=2.1.2
+Pallets-Sphinx-Themes~=1.1.4
 sphinxcontrib-log-cabinet~=1.0.0
+sphinx-issues~=1.2.0