2f6bac
Update repository documentation manual.
@@ -225,25 +225,26 @@ repository documentation manual written in a language other than
|
|
225
225
|
English, must include the @samp{@@documentlanguage} and
|
226
226
|
@samp{@@documentencoding} directives in the main document file (e.g.,
|
227
227
|
@file{repository.texinfo}) to provide the language and encoding
|
228
|
-
information, respectively.
|
229
|
-
|
230
|
-
The
|
231
|
-
|
232
|
-
|
233
|
-
|
234
|
-
required in order for Txt and Info outputs
|
235
|
-
defined through Texinfo special way of
|
236
|
-
@samp{@@'a}, @samp{@@~n}, etc.), correctly. In
|
237
|
-
read both Txt and Info files, it is required
|
238
|
-
performing the reading action (e.g.,
|
239
|
-
encoded with the same value you specified
|
240
|
-
documentation manual. Otherwise, special
|
241
|
-
expected. Using Texinfo special way of
|
242
|
-
for @command{texi2html} command to
|
243
|
-
HTML entities (e.g., @samp{á},
|
244
|
-
Pdf output, special characters are
|
245
|
-
some exceptions (e.g., the @samp{@@'i}
|
246
|
-
letter with the accentuation, but put
|
228
|
+
information, respectively. The language information provided by
|
229
|
+
@samp{@@documentlanguage} can be any value specified by ISO-639
|
230
|
+
language code standard. The encoding information provided by
|
231
|
+
@samp{@@documentencoding} can be either @samp{US-ASCII},
|
232
|
+
@samp{ISO-8859-1}, @samp{ISO-8859-15} or @samp{ISO-8859-2}.
|
233
|
+
|
234
|
+
The encoding information is required in order for Txt and Info outputs
|
235
|
+
to show special characters, defined through Texinfo special way of
|
236
|
+
accentuation (e.g., @samp{@@'a}, @samp{@@~n}, etc.), correctly. In
|
237
|
+
this specific case, to read both Txt and Info files, it is required
|
238
|
+
that the terminal you are performing the reading action (e.g.,
|
239
|
+
@command{gnome-terminal}) be encoded with the same value you specified
|
240
|
+
inside the repository documentation manual. Otherwise, special
|
241
|
+
characters may not look as expected. Using Texinfo special way of
|
242
|
+
accentuation is also required for @command{texi2html} command to
|
243
|
+
transform special characters to HTML entities (e.g., @samp{á},
|
244
|
+
@samp{ñ}, etc.). In the Pdf output, special characters are
|
245
|
+
printed well most of times with some exceptions (e.g., the @samp{@@'i}
|
246
|
+
don't replaces the dot over the letter with the accentuation, but put
|
247
|
+
the accentuation over it.).
|
247
248
|
|
248
249
|
|
249
250
|
@strong{Note} Using other codifications but UTF-8 in the terminal
|