[Top][All Lists]

[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.)


reply via email to

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