GNU bug report logs - #67826
Broken search mechanism

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 67826 in the body.
You can then email your comments to 67826 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Nicolas <nmorais.st <at> gmail.com>
To: bug-parted <at> gnu.org
Subject: Broken search mechanism
Date: Thu, 14 Dec 2023 11:08:38 -0300

Hello. I don't really know to what e-mail address should I send this 
message, but I just wanted to warn about the search mechanism of 
Parted's documentation, and probably other software made by GNU.

Example: https://www.gnu.org/software/parted/api/search.php?query=partition

The page gets entirely broken when I try to search something.

Best regards,

Nicolas.

Message #8 received at 67826 <at> debbugs.gnu.org (full text, mbox):

From: "Brian C. Lane" <bcl <at> redhat.com>
To: Nicolas <nmorais.st <at> gmail.com>
Cc: 67826 <at> debbugs.gnu.org
Subject: Re: bug#67826: Broken search mechanism
Date: Thu, 14 Dec 2023 17:33:29 -0800

On Thu, Dec 14, 2023 at 11:08:38AM -0300, Nicolas wrote:
> Hello. I don't really know to what e-mail address should I send this
> message, but I just wanted to warn about the search mechanism of Parted's
> documentation, and probably other software made by GNU.
> 
> Example: https://www.gnu.org/software/parted/api/search.php?query=partition
> 
> The page gets entirely broken when I try to search something.

It's probably good it is broken, apparently that hasn't been updated
since "Fri May 4 05:15:31 2007" so it's guaranteed to be inaccurate.

I'll see if I can track down what generates those pages. I'm not even
sure Doxygen will generate useful output with the current codebase, I
know I've never tried.

Thanks,

Brian

-- 
Brian C. Lane (PST8PDT) - weldr.io - lorax - parted - pykickstart

Message #11 received at 67826 <at> debbugs.gnu.org (full text, mbox):

From: bill-auger <bill-auger <at> peers.community>
To: "Brian C. Lane" <bcl <at> redhat.com>
Cc: Nicolas <nmorais.st <at> gmail.com>, 67826 <at> debbugs.gnu.org
Subject: Re: bug#67826: Broken search mechanism
Date: Thu, 14 Dec 2023 21:08:55 -0500

On Thu, 14 Dec 2023 17:33:29 -0800 Brian wrote:
> It's probably good it is broken, apparently that hasn't been updated
> since "Fri May 4 05:15:31 2007" so it's guaranteed to be inaccurate.

FWIW, only the search feature is broken - all of the docs are complete
(and probably inaccurate) - would be better to take the site down if the web
docs can not be repaired

Message #14 received at 67826 <at> debbugs.gnu.org (full text, mbox):

From: Nicolas <nmorais.st <at> gmail.com>
To: bill-auger <bill-auger <at> peers.community>
Cc: 67826 <at> debbugs.gnu.org
Subject: Re: bug#67826: Broken search mechanism
Date: Mon, 18 Dec 2023 09:53:45 -0300

Hello.

Sorry, I didn't notice it hasn't been updated since 2007. If fixing or 
updating the site is not possible, I'd ask the admins to just put a 
warning saying it's outdated, instead of taking it down. I personally 
like web documentations, and I think more users also like them. Even 
this being 16 years outdated (!), most of the things still make sense.

Thanks!


On 14/12/2023 23:08, bill-auger wrote:
> On Thu, 14 Dec 2023 17:33:29 -0800 Brian wrote:
>> It's probably good it is broken, apparently that hasn't been updated
>> since "Fri May 4 05:15:31 2007" so it's guaranteed to be inaccurate.
> FWIW, only the search feature is broken - all of the docs are complete
> (and probably inaccurate) - would be better to take the site down if the web
> docs can not be repaired

Message #17 received at 67826 <at> debbugs.gnu.org (full text, mbox):

From: bill-auger <bill-auger <at> peers.community>
To: Nicolas <nmorais.st <at> gmail.com>
Cc: 67826 <at> debbugs.gnu.org
Subject: Re: bug#67826: Broken search mechanism
Date: Mon, 18 Dec 2023 10:37:08 -0500

Nicolas -

just to note, the nice thing about doxygen is that it that is part if the
code-base - it does not need to be maintained separately or in a database like
those "modern web" deals; and the project does not even need to host it publicly
- any user with the source code can generate their own local website exactly
like the one the project would host - you could probably do that now - in a
only few minutes, you would have a better version of that same website ready
for use, presuming that the program source code is still well-documented (and
still correct)

Message #20 received at 67826 <at> debbugs.gnu.org (full text, mbox):

From: Nicolas <nmorais.st <at> gmail.com>
To: bill-auger <bill-auger <at> peers.community>
Cc: 67826 <at> debbugs.gnu.org
Subject: Re: bug#67826: Broken search mechanism
Date: Mon, 18 Dec 2023 14:56:07 -0300

Thanks for pointing it out, Bill. I generated the documentation locally 
and it feels way better to browse.

Best regards (and a happy new year).

Nicolas.


On 18/12/2023 12:37, bill-auger wrote:
> Nicolas -
>
> just to note, the nice thing about doxygen is that it that is part if the
> code-base - it does not need to be maintained separately or in a database like
> those "modern web" deals; and the project does not even need to host it publicly
> - any user with the source code can generate their own local website exactly
> like the one the project would host - you could probably do that now - in a
> only few minutes, you would have a better version of that same website ready
> for use, presuming that the program source code is still well-documented (and
> still correct)

Message #25 received at 67826-close <at> debbugs.gnu.org (full text, mbox):

From: "Brian C. Lane" <bcl <at> redhat.com>
To: 67826-close <at> debbugs.gnu.org
Subject: Re: bug#67826: Broken search mechanism
Date: Mon, 18 Dec 2023 18:14:29 -0800

https://www.gnu.org/software/parted/api/index.html has been updated for
libparted 3.6 using Doxygen 1.9.6

Brian

-- 
Brian C. Lane (PST8PDT) - weldr.io - lorax - parted - pykickstart

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.