texinfo - GNU documentation system - Bugs: bug #37686, standalone info ignores text...

You are not allowed to post comments on this tracker with your current authentification level.

bug #37686: standalone info ignores text attribute of image tag

 Submitted by: Karl Berry Submitted on: Wed Nov 7 00:01:15 2012 Category: None Release: Priority: 5 - Normal Severity: 3 - Normal Item Group: None Privacy: Public Open/Closed: Closed Assigned to: Sergey Poznyakoff Status: Fixed

Sat Nov 17 22:04:49 2012, comment #4:

It works as expected. Thanks Sergey!

Patrice Dumas <pertusus>
Sat Nov 17 17:18:28 2012, comment #3:

Sergey Poznyakoff <gray>
Wed Nov 7 23:23:51 2012, comment #2:

that ^H^@[...] stuff is actually documented in the manual, search for the literal string "^H^@" (not control characters) and you will see (there is a little more in the CVS texinfo.txi than in 4.13).

Anyway, it is currently only used for two things: 1) images, and 2) as a marker that "this is an index node" (ie, with @printindex output). This was added so index-search could unambiguously know which nodes to search. I guess standalone info could/should also use this. (Whether it was ever actually used as intended in emacs info, I do not know.) But it's way less important than the image stuff.

Thanks Sergey.

Karl Berry <karl>
Wed Nov 7 05:47:07 2012, comment #1:

Sure, will do. By the way, the ^@^H[...^@^H] construct seems undocumented. Just for the record, what can be inside of it, apart from the "image" stuff?

Sergey Poznyakoff <gray>
Wed Nov 7 00:01:15 2012, original submission:

Hi Sergey,

It seems standalone info is effectively ignoring our wonderful ^@^H[...^@^H] tags in info files.

There is one case where this is a problem (originally reported by arnold robbins for gawk): if an image is available as both .txt and another format (say .png), CVS makeinfo outputs both in the .info file, with the .txt file contents included in the text= attribute, as in:

[image src="ridt.png" text="----------------
|RIDT txt image|
----------------"...

Therefore Info displays nothing. Whereas if the png file does not exist, then makeinfo puts the actual contents of .txt file in the .info output, and thus of course Info displays it fine.

We want to allow users to have both .png and .txt (and whatever else), and we want to include both in the .info file since Emacs Info has the capability of actually displaying the (presumably preferable) .png.

So, would you have time to hack up the source to extract the contents of the text= attribute and display it? I took a quick look at window.c but was unfortunately not inspired to actually write anything :(.

The .texi is just the simplest possible image inclusion:
\input texinfo
@setfilename ridt.info
@node Top
@image{ridt}
@bye

I'll attach a tarball with the various test files for possible convenience, though any image will behave the same way. It's just having both .txt and something else visible at makeinfo time that matters. ("RIDT" is a conference I helped organize in 1991. How time flies. :)

Thanks,
Karl

Karl Berry <karl>

Attached Files
file #26883:  ridt-img.tgz added by karl (7kB - application/x-gzip)

Depends on the following items: None found

Items that depend on this one: None found

Carbon-Copy List
• -unavailable- added by pertusus (Posted a comment)
• -unavailable- added by gray (Posted a comment)
• -unavailable- added by karl (Submitted the item)
•

Do you think this task is very important?
This task has 0 encouragements so far.

Only logged-in users can vote.

Please enter the title of George Orwell's famous dystopian book (it's a date):