2012-02-13 09:10:37

by Michael Opdenacker

[permalink] [raw]
Subject: [trivial] Documentation: fix broken URLs

I found two broken hyperlinks in kernel DocBook documentation.
I found these links by running the klinkstatus tool on our website,
which happens to include a copy of kernel documentation
(http://free-electrons.com/kerneldoc/)

Here are fixes with proposed URL replacements for the same resources.
Don't hesitate to let me know if you find better replacements.

Thanks,

Michael.


2012-02-13 09:10:48

by Michael Opdenacker

[permalink] [raw]
Subject: [PATCH 1/2] [trivial] Documentation: broken URL in filesystems

Fix broken link in Documentation/filesystem, replacing
ftp://ftp.uk.linux.org/pub/linux/sct/fs/jfs/journal-design.ps.gz
by a URL on http://boot.kernel.org

Signed-off-by: Michael Opdenacker <[email protected]>
---
Documentation/DocBook/filesystems.tmpl | 2 +-
1 files changed, 1 insertions(+), 1 deletions(-)

diff --git a/Documentation/DocBook/filesystems.tmpl b/Documentation/DocBook/filesystems.tmpl
index f51f285..2b3de6d 100644
--- a/Documentation/DocBook/filesystems.tmpl
+++ b/Documentation/DocBook/filesystems.tmpl
@@ -387,7 +387,7 @@ an example.
<title>See also</title>
<para>
<citation>
- <ulink url="ftp://ftp.uk.linux.org/pub/linux/sct/fs/jfs/journal-design.ps.gz">
+ <ulink url="http://boot.kernel.org/pub/linux/kernel/people/sct/ext3/journal-design.ps.gz">
Journaling the Linux ext2fs Filesystem, LinuxExpo 98, Stephen Tweedie
</ulink>
</citation>
--
1.7.4.1

2012-02-13 09:10:56

by Michael Opdenacker

[permalink] [raw]
Subject: [PATCH 2/2] [trivial] Documentation: broken URL in libata

Fix broken link to license text:
http://www.opensource.org/licenses/osl-1.1.txt
The text for version 1.1 of the Open Sofware license doesn't seem
to be available anywhere on http://www.opensource.org/ any more.
Replace it with a snapshot from the Internet Wayback Machine.

I first thought about hosting a copy of this file on my
own website, but my website has less authority than
an explicit backup of the original location.

Signed-off-by: Michael Opdenacker <[email protected]>
---
Documentation/DocBook/libata.tmpl | 4 ++--
1 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Documentation/DocBook/libata.tmpl b/Documentation/DocBook/libata.tmpl
index cdd1bb9..bda33c1 100644
--- a/Documentation/DocBook/libata.tmpl
+++ b/Documentation/DocBook/libata.tmpl
@@ -22,8 +22,8 @@
<para>
The contents of this file are subject to the Open
Software License version 1.1 that can be found at
- <ulink url="http://www.opensource.org/licenses/osl-1.1.txt">http://www.opensource.org/licenses/osl-1.1.txt</ulink> and is included herein
- by reference.
+ <ulink url="http://web.archive.org/web/20060924133258/http://www.opensource.org/licenses/osl-1.1.txt">http://web.archive.org/web/20060924133258/http://www.opensource.org/licenses/osl-1.1.txt</ulink>
+ and is included herein by reference.
</para>

<para>
--
1.7.4.1

2012-02-13 17:20:25

by Randy Dunlap

[permalink] [raw]
Subject: Re: [PATCH 1/2] [trivial] Documentation: broken URL in filesystems

On 02/13/2012 01:09 AM, Michael Opdenacker wrote:
> Fix broken link in Documentation/filesystem, replacing
> ftp://ftp.uk.linux.org/pub/linux/sct/fs/jfs/journal-design.ps.gz
> by a URL on http://boot.kernel.org

Please drop the "boot." portion. It is not needed.

http://kernel.org/pub/linux/kernel/people/sct/ext3/
works fine.

> Signed-off-by: Michael Opdenacker <[email protected]>
> ---
> Documentation/DocBook/filesystems.tmpl | 2 +-
> 1 files changed, 1 insertions(+), 1 deletions(-)
>
> diff --git a/Documentation/DocBook/filesystems.tmpl b/Documentation/DocBook/filesystems.tmpl
> index f51f285..2b3de6d 100644
> --- a/Documentation/DocBook/filesystems.tmpl
> +++ b/Documentation/DocBook/filesystems.tmpl
> @@ -387,7 +387,7 @@ an example.
> <title>See also</title>
> <para>
> <citation>
> - <ulink url="ftp://ftp.uk.linux.org/pub/linux/sct/fs/jfs/journal-design.ps.gz">
> + <ulink url="http://boot.kernel.org/pub/linux/kernel/people/sct/ext3/journal-design.ps.gz">
> Journaling the Linux ext2fs Filesystem, LinuxExpo 98, Stephen Tweedie
> </ulink>
> </citation>


--
~Randy
*** Remember to use Documentation/SubmitChecklist when testing your code ***

2012-02-13 17:23:13

by Randy Dunlap

[permalink] [raw]
Subject: Re: [PATCH 2/2] [trivial] Documentation: broken URL in libata

On 02/13/2012 01:09 AM, Michael Opdenacker wrote:
> Fix broken link to license text:
> http://www.opensource.org/licenses/osl-1.1.txt
> The text for version 1.1 of the Open Sofware license doesn't seem
> to be available anywhere on http://www.opensource.org/ any more.
> Replace it with a snapshot from the Internet Wayback Machine.

That's one option.
Too bad opensource.org doesn't provide archives.

OSL v1.1 is also available here:
http://fedoraproject.org/wiki/Licensing:OSL1.1

and here:
http://www.samurajdata.se/opensource/mirror/licenses/osl.php

Jeff, I don't suppose there is any chance of changing this file's license?
(since the Debian people found it to be a problem .. long ago)


> I first thought about hosting a copy of this file on my
> own website, but my website has less authority than
> an explicit backup of the original location.
>
> Signed-off-by: Michael Opdenacker <[email protected]>
> ---
> Documentation/DocBook/libata.tmpl | 4 ++--
> 1 files changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/DocBook/libata.tmpl b/Documentation/DocBook/libata.tmpl
> index cdd1bb9..bda33c1 100644
> --- a/Documentation/DocBook/libata.tmpl
> +++ b/Documentation/DocBook/libata.tmpl
> @@ -22,8 +22,8 @@
> <para>
> The contents of this file are subject to the Open
> Software License version 1.1 that can be found at
> - <ulink url="http://www.opensource.org/licenses/osl-1.1.txt">http://www.opensource.org/licenses/osl-1.1.txt</ulink> and is included herein
> - by reference.
> + <ulink url="http://web.archive.org/web/20060924133258/http://www.opensource.org/licenses/osl-1.1.txt">http://web.archive.org/web/20060924133258/http://www.opensource.org/licenses/osl-1.1.txt</ulink>
> + and is included herein by reference.
> </para>
>
> <para>


--
~Randy
*** Remember to use Documentation/SubmitChecklist when testing your code ***