GNU bug report logs - #77012
Documentation problem: odd characters in ASCII text format manual

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Paul Eggert <eggert <at> cs.ucla.edu>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#77012: closed (Documentation problem: odd characters in ASCII
 text format manual)
Date: Mon, 17 Mar 2025 20:00:02 +0000

[Message part 1 (text/plain, inline)]

Your message dated Mon, 17 Mar 2025 12:59:05 -0700
with message-id <89805f25-93fa-4fbc-b188-840d34b2f6ee <at> cs.ucla.edu>
and subject line Re: bug#77012: Documentation problem: odd characters in ASCII text format manual
has caused the debbugs.gnu.org bug report #77012,
regarding Documentation problem: odd characters in ASCII text format manual
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
77012: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=77012
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Giacomo De Bello <giacomodebello <at> hotmail.it>
To: "bug-grep <at> gnu.org" <bug-grep <at> gnu.org>
Subject: Documentation problem: odd characters in ASCII text format manual
Date: Fri, 14 Mar 2025 09:22:23 +0000

Greetings, the manual file in ASCII text format is filled with odd characters, and maybe this is a character conversion problem during the file generation.
In example, you can see the problem in the third line of the plain text manual online

https://www.gnu.org/software/grep/manual/grep.txt

I quote:

2 Invoking ‘grep’

It should be

2 Invoking grep

or

2 Invoking 'grep'

or something else. As far as I can see, the HTML format of the manual has the word "grep" between <code> tags, and I guess the problem is or was somewhat related to that, in docbook2txt or gendocs.sh; I said "was" because maybe just relaunching gendocs.sh will fix that, as the document was last updated May 13, 2023. Regards.

[Message part 3 (message/rfc822, inline)]

From: Paul Eggert <eggert <at> cs.ucla.edu>
To: Giacomo De Bello <giacomodebello <at> hotmail.it>
Cc: savannah-hackers <at> gnu.org, 77012-done <at> debbugs.gnu.org
Subject: Re: bug#77012: Documentation problem: odd characters in ASCII text
 format manual
Date: Mon, 17 Mar 2025 12:59:05 -0700

Thanks for the further investigation. I solved the problem for grep by 
installing the following patch, and am closing the bug report.

https://web.cvs.savannah.gnu.org/viewvc/grep/grep/.htaccess?r1=1.1&r2=1.2

Presumably GNU project web pages should routinely have .htaccess files 
that say something like this:

  <Files "*.txt">
    AddDefaultCharset utf-8
    ForceType text/plain
  </Files>

as the old Windows-1252 default no longer makes sense. I'll take a look 
at doing this for the projects I help maintain.

Alternatively (and more efficiently) this could be addressed by changing 
the Apache configuration on Savannah; however, I lack admin access for that.

Previous Next

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