bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: @strong{NOTE}


From: Bruno Haible
Subject: Re: @strong{NOTE}
Date: Mon, 3 Apr 2006 21:48:31 +0200
User-agent: KMail/1.5

Hello Karl,

Thanks for your rapid answer.

>   1) Change the "info" program to recognize only "*Note" and not "*NOTE"
>      as a hyperlink,
>
> I'm extremely reluctant to break backwards compatibility.

Did makeinfo ever generate info files with "NOTE in uppercase? Or were there
other programs doing that?

>   2) Change the "makeinfo" program to process @strong{NOTE:} just like it
>      would process @strong{FOOBAR:}?
>
> I don't understand.  What does it do differently, besides give the
> warning?

It also turns the colon into an underscore.

> One more personal opinion which you probably don't care about: virtually
> everything I have seen prefaced with @strong{Note} in manuals reads
> better if the "Note" is simply omitted.  "Note" is semantically
> redundant.

It usually serves the purpose of highlighting a sentence. In HTML, for example,
you don't need "NOTE:" because you can put the entire sentence in a bold font.
But in plain text and info format it is not so easy to emphasize a sentence or
paragraph. (An asterisk before the paragraph and an asterisk after the paragraph
is not enough visual strengh compared to the size of the paragraph.)

Bruno





reply via email to

[Prev in Thread] Current Thread [Next in Thread]