2020-06-21 15:36:51

by Luc Van Oostenryck

[permalink] [raw]
Subject: [PATCH] doc: update URL for sparse's tarballs

The URL given to get sparse's tarballs is sparse.wiki.kernel.org
but the wiki will is deprecated in favor of sparse.docs.kernel.org.

So, update this URL to the one where the tarballs can directly
be found.

Signed-off-by: Luc Van Oostenryck <[email protected]>
---
Documentation/dev-tools/sparse.rst | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Documentation/dev-tools/sparse.rst b/Documentation/dev-tools/sparse.rst
index 6f4870528226..8a7055593c31 100644
--- a/Documentation/dev-tools/sparse.rst
+++ b/Documentation/dev-tools/sparse.rst
@@ -73,8 +73,8 @@ sparse would otherwise report a context imbalance.
Getting sparse
--------------

-You can get latest released versions from the Sparse homepage at
-https://sparse.wiki.kernel.org/index.php/Main_Page
+You can get tarballs of the latest released versions from:
+https://www.kernel.org/pub/software/devel/sparse/dist/

Alternatively, you can get snapshots of the latest development version
of sparse using git to clone::
--
2.27.0


2020-06-26 17:28:49

by Jonathan Corbet

[permalink] [raw]
Subject: Re: [PATCH] doc: update URL for sparse's tarballs

On Sun, 21 Jun 2020 17:33:30 +0200
Luc Van Oostenryck <[email protected]> wrote:

> The URL given to get sparse's tarballs is sparse.wiki.kernel.org
> but the wiki will is deprecated in favor of sparse.docs.kernel.org.
>
> So, update this URL to the one where the tarballs can directly
> be found.
>
> Signed-off-by: Luc Van Oostenryck <[email protected]>
> ---
> Documentation/dev-tools/sparse.rst | 4 ++--
> 1 file changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/dev-tools/sparse.rst b/Documentation/dev-tools/sparse.rst
> index 6f4870528226..8a7055593c31 100644
> --- a/Documentation/dev-tools/sparse.rst
> +++ b/Documentation/dev-tools/sparse.rst
> @@ -73,8 +73,8 @@ sparse would otherwise report a context imbalance.
> Getting sparse
> --------------
>
> -You can get latest released versions from the Sparse homepage at
> -https://sparse.wiki.kernel.org/index.php/Main_Page
> +You can get tarballs of the latest released versions from:
> +https://www.kernel.org/pub/software/devel/sparse/dist/

I've applied this, but it also seems like we're losing some information by
going from a wiki straight to a directory listing. It seems maybe we need
a link to the new documentation site in here as well?

Thanks,

jon

2020-06-28 09:52:02

by Luc Van Oostenryck

[permalink] [raw]
Subject: [PATCH] doc: add link to sparse's home page/internal docs

Sparse's home page used to be a wiki (sparse.wiki.kernel.org)
but this wiki only contained a short intro and the release notes.
But nowadays, sparse's main page is sparse.docs.kernel.org,
which contains all what was in the wiki but also other documentation,
mainly oriented about sparse's internals.

So, add a link to this in the kernel documentation.

Signed-off-by: Luc Van Oostenryck <[email protected]>
---
Documentation/dev-tools/sparse.rst | 2 ++
1 file changed, 2 insertions(+)

diff --git a/Documentation/dev-tools/sparse.rst b/Documentation/dev-tools/sparse.rst
index 6f4870528226..e20b8b8b78ed 100644
--- a/Documentation/dev-tools/sparse.rst
+++ b/Documentation/dev-tools/sparse.rst
@@ -9,6 +9,8 @@ Sparse is a semantic checker for C programs; it can be used to find a
number of potential problems with kernel code. See
https://lwn.net/Articles/689907/ for an overview of sparse; this document
contains some kernel-specific sparse information.
+More information on sparse, mainly about its internals, can be found in
+its official pages at https://sparse.docs.kernl.org.


Using sparse for typechecking
--
2.27.0

2020-06-28 09:53:38

by Luc Van Oostenryck

[permalink] [raw]
Subject: Re: [PATCH] doc: update URL for sparse's tarballs

On Fri, Jun 26, 2020 at 11:23:49AM -0600, Jonathan Corbet wrote:
>
> I've applied this, but it also seems like we're losing some information by
> going from a wiki straight to a directory listing. It seems maybe we need
> a link to the new documentation site in here as well?

Yes. I hesitated to do this because:
- the wiki contained very very few useful informations
- the new documentation doesn't contain for a user / kernel
dev perspective.

I'm sending a new patch that can be applied separately
or be squashed with this one if you prefer so.

Thanks,
-- Luc

2020-06-29 21:39:16

by Mike Rapoport

[permalink] [raw]
Subject: Re: [PATCH] doc: add link to sparse's home page/internal docs

On Sun, Jun 28, 2020 at 11:50:34AM +0200, Luc Van Oostenryck wrote:
> Sparse's home page used to be a wiki (sparse.wiki.kernel.org)
> but this wiki only contained a short intro and the release notes.
> But nowadays, sparse's main page is sparse.docs.kernel.org,
> which contains all what was in the wiki but also other documentation,
> mainly oriented about sparse's internals.
>
> So, add a link to this in the kernel documentation.
>
> Signed-off-by: Luc Van Oostenryck <[email protected]>
> ---
> Documentation/dev-tools/sparse.rst | 2 ++
> 1 file changed, 2 insertions(+)
>
> diff --git a/Documentation/dev-tools/sparse.rst b/Documentation/dev-tools/sparse.rst
> index 6f4870528226..e20b8b8b78ed 100644
> --- a/Documentation/dev-tools/sparse.rst
> +++ b/Documentation/dev-tools/sparse.rst
> @@ -9,6 +9,8 @@ Sparse is a semantic checker for C programs; it can be used to find a
> number of potential problems with kernel code. See
> https://lwn.net/Articles/689907/ for an overview of sparse; this document
> contains some kernel-specific sparse information.
> +More information on sparse, mainly about its internals, can be found in
> +its official pages at https://sparse.docs.kernl.org.

Nit: ^ kernel

>
>
> Using sparse for typechecking
> --
> 2.27.0
>

--
Sincerely yours,
Mike.

2020-07-05 20:32:20

by Jonathan Corbet

[permalink] [raw]
Subject: Re: [PATCH] doc: add link to sparse's home page/internal docs

On Sun, 28 Jun 2020 11:50:34 +0200
Luc Van Oostenryck <[email protected]> wrote:

> Sparse's home page used to be a wiki (sparse.wiki.kernel.org)
> but this wiki only contained a short intro and the release notes.
> But nowadays, sparse's main page is sparse.docs.kernel.org,
> which contains all what was in the wiki but also other documentation,
> mainly oriented about sparse's internals.
>
> So, add a link to this in the kernel documentation.
>
> Signed-off-by: Luc Van Oostenryck <[email protected]>
> ---
> Documentation/dev-tools/sparse.rst | 2 ++
> 1 file changed, 2 insertions(+)
>
> diff --git a/Documentation/dev-tools/sparse.rst b/Documentation/dev-tools/sparse.rst
> index 6f4870528226..e20b8b8b78ed 100644
> --- a/Documentation/dev-tools/sparse.rst
> +++ b/Documentation/dev-tools/sparse.rst
> @@ -9,6 +9,8 @@ Sparse is a semantic checker for C programs; it can be used to find a
> number of potential problems with kernel code. See
> https://lwn.net/Articles/689907/ for an overview of sparse; this document
> contains some kernel-specific sparse information.
> +More information on sparse, mainly about its internals, can be found in
> +its official pages at https://sparse.docs.kernl.org.

Applied, thanks.

jon