input encodings in info files

[Werner LEMBERG]

The following means some work for the documentation meister.
Theoretically, I could do it by myself, but then it doesn't have any
didactical purpose :-)

texinfo files are very limited w.r.t. input encodings.  Currently,
latin1 is the best choice -- in reality, even this is not handled
gracefully, but see below.  Note that the following doesn't affect
accent handling in lilypond code snippets (I've fixed this right now
in lilyponddefs.tex).

Looking into changing-defaults.itely (checking `Baßtuba') I can see
that this file is encoded in UTF8.  Bad, bad.

The following steps must be done to get decent handling of accents so
that both address@hidden' and `ß' work:

  . Convert *all* texinfo input files to latin1.

  . Set a proper `coding:' property for emacs, this is, convert this

      @c -*-texinfo-*-

    to

      @c -*- coding: latin-1; mode: texinfo; -*-

    Similar things probably exist for `vim' also...

  . Add

      @documentlanguage en
      @documentencoding ISO-8859-1

    at the beginning of the main info files (but *after* the
    @setfilename command).

    In standard texinfo.tex, @documentencoding is a no-op currently
    (but handled by the HTML backend, for example).  Putting the file
    `texinfo.cnf' below into tex/, some additional magic is performed
    for DVI/PDF also.

  . Add

      --enable-encoding

    to all $(MAKEINFO) lines in Documentation/user/GNUmakefile.


      Werner


======================================================================


begin 644 texinfo.cnf
M0&,@5V4@;6%P('-O;64@;&%T:6XM,2!C:&%R86-T97)S('1O(&-O<G)E<W!O
M;F1I;F<@=&5X:6YF;R!M86-R;W,N"@I`=&5X"EQG;&]B86Q<8V%T8V]D96!>
M7F$P7&%C=&EV92`E(&"@)PI<9V1E9EY>83![7'1I97T*7&=L;V)A;%QC871C
M;V1E8%Y>83%<86-T:79E("address@hidden<9V1E9EY>83%[7&5X8VQA;61O=VY]"B5<
M9VQO8F%L7&-A=&-O9&address@hidden,EQA8W1I=F4@)2"B"B5<9V1E9EY>83)[?0I<
M9VQO8F%L7&-A=&-O9&address@hidden,UQA8W1I=F4@)2"C"EQG9&5F7EYA,WM<<&]U
M;F1S?0HE7&=L;V)A;%QC871C;V1E8%Y>831<86-T:79E("address@hidden&=D969>
M7F$T>WT*)5QG;&]B86Q<8V%T8V]D96!>7F$U7&%C=&EV92`E(*4*)5QG9&5F
M7EYA-7M]"B5<9VQO8F%L7&-A=&-O9&address@hidden@)2"F"B5<9V1E
M9EY>839[?0HE7&=L;V)A;%QC871C;V1E8%Y>83=<86-T:79E("address@hidden&=D
M969>7F$W>WT*7&=L;V)A;%QC871C;V1E8%Y>83A<86-T:79E("address@hidden<9V1E
M9EY>83A[7")[('U]"EQG;&]B86Q<8V%T8V]D96!>7F$Y7&%C=&EV92`E(*D*
M7&=D969>7F$Y>UQC;W!Y<FEG:'1]"EQG;&]B86Q<8V%T8V]D96!>7F%A7&%C
M=&EV92`E(*H*7&=D969>7F%A>UQO<F1F?0HE7&=L;V)A;%QC871C;V1E8%Y>
M86)<86-T:79E("address@hidden&=D969>7F%B>WT*)5QG;&]B86Q<8V%T8V]D96!>
M7F%C7&%C=&EV92`E(*P*)5QG9&5F7EYA8WM]"B5<9VQO8F%L7&-A=&-O9&5@
M7EYA9%QA8W1I=F4@)2"M"B5<9V1E9EY>861[?0I<9VQO8F%L7&-A=&-O9&5@
M7EYA95QA8W1I=F4@)2"N"EQG9&5F7EYA97M<<F5G:7-T97)E9'-Y;6)O;'T*
M7&=L;V)A;%QC871C;V1E8%Y>869<86-T:79E("address@hidden<9V1E9EY>869[7#U[
M('U]"EQG;&]B86Q<8V%T8V]D96!>7F(P7&%C=&EV92`E(+`*7&=D969>7F(P
M>UQR:6YG86-C96YT>R!]?0HE7&=L;V)A;%QC871C;V1E8%Y>8C%<86-T:79E
M("address@hidden&=D969>7F(Q>WT*)5QG;&]B86Q<8V%T8V]D96!>7F(R7&%C=&EV
M92`E(+(*)5QG9&5F7EYB,GM]"B5<9VQO8F%L7&-A=&-O9&address@hidden,UQA8W1I
M=F4@)2"S"B5<9V1E9EY>8C-[?0I<9VQO8F%L7&-A=&-O9&address@hidden
M=F4@)2"T"EQG9&5F7EYB-'M<)address@hidden)5QG;&]B86Q<8V%T8V]D96!>7F(U
M7&%C=&EV92`E(+4*)5QG9&5F7EYB-7M]"B5<9VQO8F%L7&-A=&-O9&address@hidden
M-EQA8W1I=F4@)2"V"B5<9V1E9EY>8C9[?0HE7&=L;V)A;%QC871C;V1E8%Y>
M8C=<86-T:79E("address@hidden&=D969>7F(W>WT*7&=L;V)A;%QC871C;V1E8%Y>
M8CA<86-T:79E("address@hidden<9V1E9EY>8CA[7"Q[('U]"B5<9VQO8F%L7&-A=&-O
M9&address@hidden@)2"Y"B5<9V1E9EY>8CE[?0I<9VQO8F%L7&-A=&-O
M9&address@hidden@)2"Z"EQG9&5F7EYB87M<;W)D;7T*)5QG;&]B86Q<
M8V%T8V]D96!>7F)B7&%C=&EV92`E(+L*)5QG9&5F7EYB8GM]"B5<9VQO8F%L
M7&-A=&-O9&address@hidden@)2"\"B5<9V1E9EY>8F-[?0HE7&=L;V)A
M;%QC871C;V1E8%Y>8F1<86-T:79E("address@hidden&=D969>7F)D>WT*)5QG;&]B
M86Q<8V%T8V]D96!>7F)E7&%C=&EV92`E(+X*)5QG9&5F7EYB97M]"EQG;&]B
M86Q<8V%T8V]D96!>7F)F7&%C=&EV92`E(+\*7&=D969>7F)F>UQE>&-L86UD
M;W=N?0I<9VQO8F%L7&-A=&-O9&address@hidden,%QA8W1I=F4@)2#`"EQG9&5F7EYC
M,'M<8$%]"EQG;&]B86Q<8V%T8V]D96!>7F,Q7&%C=&EV92`E(,$*7&=D969>
M7F,Q>UPG07T*7&=L;V)A;%QC871C;V1E8%Y>8S)<86-T:79E("address@hidden@I<9V1E
M9EY>8S)[7%Y!?0I<9VQO8F%L7&-A=&-O9&address@hidden,UQA8W1I=F4@)2##"EQG
M9&5F7EYC,WM<?D%]"EQG;&]B86Q<8V%T8V]D96!>7F,T7&%C=&EV92`E(,0*
M7&=D969>7F,T>UPB07T*7&=L;V)A;%QC871C;V1E8%Y>8S5<86-T:79E("4@
MQ0I<9V1E9EY>8S5[7$%!?0I<9VQO8F%L7&-A=&-O9&address@hidden@
M)2#&"EQG9&5F7EYC-GM<045]"EQG;&]B86Q<8V%T8V]D96!>7F,W7&%C=&EV
M92`E(,<*7&=D969>7F,W>UPL>T-]?0I<9VQO8F%L7&-A=&-O9&address@hidden
M8W1I=F4@)2#("EQG9&5F7EYC.'M<8$5]"EQG;&]B86Q<8V%T8V]D96!>7F,Y
M7&%C=&EV92`E(,D*7&=D969>7F,Y>UPG17T*7&=L;V)A;%QC871C;V1E8%Y>
M8V%<86-T:79E("address@hidden@I<9V1E9EY>8V%[7%Y%?0I<9VQO8F%L7&-A=&-O9&5@
M7EYC8EQA8W1I=F4@)2#+"EQG9&5F7EYC8GM<(D5]"EQG;&]B86Q<8V%T8V]D
M96!>7F-C7&%C=&EV92`E(,P*7&=D969>7F-C>address@hidden&=L;V)A;%QC871C
M;V1E8%Y>8V1<86-T:79E("address@hidden<9V1E9EY>8V1[7"=)?0I<9VQO8F%L7&-A
M=&-O9&address@hidden@)2#."EQG9&5F7EYC97M<7DE]"EQG;&]B86Q<
M8V%T8V]D96!>7F-F7&%C=&EV92`E(,\*7&=D969>7F-F>UPB27T*)5QG;&]B
M86Q<8V%T8V]D96!>7F0P7&%C=&EV92`E(-`*)5QG9&5F7EYD,'M]"EQG;&]B
M86Q<8V%T8V]D96!>7F0Q7&%C=&EV92`E(-$*7&=D969>7F0Q>UQ^3GT*7&=L
M;V)A;%QC871C;V1E8%Y>9#)<86-T:79E("address@hidden@I<9V1E9EY>9#)[7&!/?0I<
M9VQO8F%L7&-A=&-O9&address@hidden,UQA8W1I=F4@)2#3"EQG9&5F7EYD,WM<)T]]
M"EQG;&]B86Q<8V%T8V]D96!>7F0T7&%C=&EV92`E(-0*7&=D969>7F0T>UQ>
M3WT*7&=L;V)A;%QC871C;V1E8%Y>9#5<86-T:79E("address@hidden<9V1E9EY>9#5[
M7'Y/?0I<9VQO8F%L7&-A=&-O9&address@hidden@)2#6"EQG9&5F7EYD
M-GM<(D]]"B5<9VQO8F%L7&-A=&-O9&address@hidden@)2#7"B5<9V1E
M9EY>9#=[?0I<9VQO8F%L7&-A=&-O9&address@hidden@)2#8"EQG9&5F
M7EYD.'M<3WT*7&=L;V)A;%QC871C;V1E8%Y>9#E<86-T:79E("address@hidden<9V1E
M9EY>9#E[7&!5?0I<9VQO8F%L7&-A=&-O9&address@hidden@)2#:"EQG
M9&5F7EYD87M<)U5]"EQG;&]B86Q<8V%T8V]D96!>7F1B7&%C=&EV92`E(-L*
M7&=D969>7F1B>UQ>57T*7&=L;V)A;%QC871C;V1E8%Y>9&-<86-T:79E("4@
MW`I<9V1E9EY>9&-[7")5?0I<9VQO8F%L7&-A=&-O9&address@hidden@
M)2#="EQG9&5F7EYD9'M<)UE]"B5<9VQO8F%L7&-A=&-O9&address@hidden
M=F4@)2#>"B5<9V1E9EY>9&5[?0I<9VQO8F%L7&-A=&-O9&address@hidden
M=F4@)2#?"EQG9&5F7EYD9GM<<W-]"EQG;&]B86Q<8V%T8V]D96!>7F4P7&%C
M=&EV92`E(.`*7&=D969>7F4P>address@hidden&=L;V)A;%QC871C;V1E8%Y>93%<
M86-T:79E("address@hidden<9V1E9EY>93%[7"=A?0I<9VQO8F%L7&-A=&-O9&address@hidden
M,EQA8W1I=F4@)2#B"EQG9&5F7EYE,GM<7F%]"EQG;&]B86Q<8V%T8V]D96!>
M7F4S7&%C=&EV92`E(.,*7&=D969>7F4S>UQ^87T*7&=L;V)A;%QC871C;V1E
M8%Y>931<86-T:79E("address@hidden<9V1E9EY>931[7")A?0I<9VQO8F%L7&-A=&-O
M9&address@hidden@)2#E"EQG9&5F7EYE-7M<86%]"EQG;&]B86Q<8V%T
M8V]D96!>7F4V7&%C=&EV92`E(.8*7&=D969>7F4V>UQA97T*7&=L;V)A;%QC
M871C;V1E8%Y>93=<86-T:79E("address@hidden<9V1E9EY>93=[7"Q[8WU]"EQG;&]B
M86Q<8V%T8V]D96!>7F4X7&%C=&EV92`E(address@hidden&=D969>7F4X>address@hidden&=L
M;V)A;%QC871C;V1E8%Y>93E<86-T:79E("address@hidden<9V1E9EY>93E[7"=E?0I<
M9VQO8F%L7&-A=&-O9&address@hidden@)2#J"EQG9&5F7EYE87M<7F5]
M"EQG;&]B86Q<8V%T8V]D96!>7F5B7&%C=&EV92`E(.L*7&=D969>7F5B>UPB
M97T*7&=L;V)A;%QC871C;V1E8%Y>96-<86-T:79E("address@hidden<9V1E9EY>96-[
M7&![7&1O=&QE<W-[:7U]?0I<9VQO8F%L7&-A=&-O9&address@hidden@
M)2#M"EQG9&5F7EYE9'M<)WM<9&]T;&5S<WMI?7U]"EQG;&]B86Q<8V%T8V]D
M96!>7F5E7&%C=&EV92`E(.X*7&=D969>7F5E>UQ>>UQD;W1L97-S>VE]?7T*
M7&=L;V)A;%QC871C;V1E8%Y>969<86-T:79E("address@hidden<9V1E9EY>969[7")[
M7&1O=&QE<W-[:7U]?0HE7&=L;V)A;%QC871C;V1E8%Y>9C!<86-T:79E("4@
M\`HE7&=D969>7F8P>WT*7&=L;V)A;%QC871C;V1E8%Y>9C%<86-T:79E("4@
M\0I<9V1E9EY>9C%[7'YN?0I<9VQO8F%L7&-A=&-O9&address@hidden,EQA8W1I=F4@
M)2#R"EQG9&5F7EYF,GM<8&]]"EQG;&]B86Q<8V%T8V]D96!>7F8S7&%C=&EV
M92`E(/,*7&=D969>7F8S>UPG;WT*7&=L;V)A;%QC871C;V1E8%Y>9C1<86-T
M:79E("address@hidden<9V1E9EY>9C1[7%YO?0I<9VQO8F%L7&-A=&-O9&address@hidden
M8W1I=F4@)2#U"EQG9&5F7EYF-7M<?F]]"EQG;&]B86Q<8V%T8V]D96!>7F8V
M7&%C=&EV92`E(/8*7&=D969>7F8V>UPB;WT*)5QG;&]B86Q<8V%T8V]D96!>
M7F8W7&%C=&EV92`E(/<*)5QG9&5F7EYF-WM]"EQG;&]B86Q<8V%T8V]D96!>
M7F8X7&%C=&EV92`E(/@*7&=D969>7F8X>UQO?0I<9VQO8F%L7&-A=&-O9&5@
M7EYF.5QA8W1I=F4@)2#Y"EQG9&5F7EYF.7M<8'5]"EQG;&]B86Q<8V%T8V]D
M96!>7F9A7&%C=&EV92`E(/H*7&=D969>7F9A>UPG=7T*7&=L;V)A;%QC871C
M;V1E8%Y>9F)<86-T:79E("address@hidden<9V1E9EY>9F)[7%YU?0I<9VQO8F%L7&-A
M=&-O9&address@hidden@)2#\"EQG9&5F7EYF8WM<(G5]"EQG;&]B86Q<
M8V%T8V]D96!>7F9D7&%C=&EV92`E(/T*7&=D969>7F9D>UPG>7T*)5QG;&]B
M86Q<8V%T8V]D96!>7F9E7&%C=&EV92`E(/X*)5QG9&5F7EYF97M]"EQG;&]B
M86Q<8V%T8V]D96!>7F9F7&%C=&EV92`E(/\*7&=D969>7F9F>UPB>7T*0&5N
&9"address@hidden
`
end