NEWS 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865
  1. This file records noteworthy changes.
  2. X.X ()
  3. * COMPATIBILITY
  4. -------------
  5. * don't show menu with --no-headers as said in the makeinfo documentation.
  6. * obsolete the --iso command line option.
  7. * obsolete texi2html specific variables. Here is the list with the associated
  8. configuration variables that may be set instead, with --set-init-variable:
  9. --toc-links TOC_LINKS
  10. --short-ext SHORTEXTN
  11. --prefix PREFIX
  12. --short-ref SHORT_REF
  13. --idx-sum IDX_SUMMARY
  14. --def-table DEF_TABLE
  15. --ignore-preamble-text IGNORE_PREAMBLE_TEXT
  16. --html-xref-prefix EXTERNAL_DIR
  17. --l2h L2H
  18. --l2h-l2h L2H_L2H
  19. --l2h-skip L2H_SKIP
  20. --l2h-tmp L2H_TMP
  21. --l2h-file L2H_FILE
  22. --l2h-clean L2H_CLEAN
  23. --use-nodes USE_NODES
  24. --monolithic MONOLITHIC
  25. --top-file TOP_FILE
  26. --toc-file TOC_FILE
  27. --frames FRAMES
  28. --menu SHOW_MENU
  29. --debug DEBUG
  30. --doctype DOCTYPE
  31. --frameset-doctype FRAMESET_DOCTYPE
  32. --test TEST
  33. --dump-texi DUMP_TEXI
  34. * remove completly $INVISIBLE_MARK, $USE_GLOSSARY, $CHECK, $EXPAND,
  35. $ENCODING, $CENTER_IMAGE, $HREF_DIR_INSTEAD_FILE, $USE_MENU_DIRECTIONS,
  36. they have been obsolete, sometimes for many years.
  37. * DATE is now set as today, DOCUMENT_ENCODING as documentencoding,
  38. extension as EXTENSION and DOCUMENT_DESCRIPTION as documentdescription.
  39. * Don't use perl variables for configuration variables anymore. Instead,
  40. they should be set by
  41. set_from_init_file('VARIABLE', value);
  42. For example
  43. $SPLIT = 'node';
  44. should be replaced by
  45. set_from_init_file('SPLIT', 'node');
  46. * configuration variables are not in Texi2HTML::THISDOC directly anymore,
  47. but in Texi2HTML::THISDOC{'variables'}->{$var}. they should be accessed
  48. through get_conf($var).
  49. * remove $Texi2HTML::THISDOC{'program_authors'}. $Texi2HTML::THISDOC{'program_and_version'}
  50. holds the program and version, while $Texi2HTML::THISDOC{'program'} is only
  51. the program name.
  52. * remove $Texi2HTML::THISDOC{'out_dir'}.
  53. 5.0 (2010-06-27)
  54. * NEW FEATURES
  55. ------------
  56. * The program may be called as makeinfo, with a handling of options
  57. and defaults matching makeinfo.
  58. It may also be called as texi2any, with makeinfo defaults and all
  59. the texi2html command-line arguments that are not obsolete.
  60. * new info and plaintext backends, ready for world domination!
  61. Corresponding test results are added.
  62. * main program handles --xml, --docbook, --info, --html and --plaintext.
  63. * Handle @DH{}, @dh{}, @TH{}, @th{}, @headitemfont, @part and
  64. @allowcodebreaks false
  65. * Handle -o /dev/null (or NUL) like makeinfo.
  66. * Read TEXINFO_OUTPUT_FORMAT in env to determine the output format.
  67. * add 0x7F as a comment character.
  68. * When called as texi2html, output the title page at the beginning.
  69. * mediawiki backend completed.
  70. * Translations of error messages available.
  71. * BUG FIXES
  72. ---------
  73. * Handling of @itemize and @table arguments are more in line with makeinfo.
  74. * ignore @setfilename in @include'd files, as told in the texinfo manual.
  75. * many warning messages added, especially for Info to match makeinfo.
  76. * Still provide the default output with --macro-expand.
  77. * Handle correctly @w in info and html.
  78. * COMPATIBILITY
  79. -------------
  80. * complex format handling API changed. $complex_format_map is replaced by
  81. a real hash %complex_format_map and the begin and end are no more
  82. evaluated.
  83. * If file begins with /, ./ or ../ don't search in -I.
  84. * In the default case a gettext-like framework is now used for in document
  85. string translations. The old framework is still available by setting
  86. $I18N_PERL_HASH.
  87. * Information that can be set by @-commands should now be accessed
  88. through get_conf, and also some information about the document (the
  89. information that can change for each manual being processed).
  90. * $format_list_item_texi should now modify directly the @item argument
  91. and apply the @-command given as @table argument. Correspondingly,
  92. some arguments of $table_item have been removed.
  93. * Formatting of titlepage changed, and @title, @subtitle and @author
  94. are now handled by $line_command.
  95. * @verbatiminclude is now a $raw command argument distinct from @verbatim.
  96. * @direntry is formatted like a menu and passed down to $menu_command.
  97. * $SEPARATED_FOOTNOTES has been replaced by $FOOTNOTESTYLE, that takes the
  98. same argument than @footnotestyle.
  99. * replace $LANG by $DOCUMENTLANGUAGE.
  100. * replace $DO_CONTENTS by $CONTENTS and $DO_SCONTENTS by $SHORTCONTENTS.
  101. * replace $TRANSLITERATE_NODE by $TRANSLITERATE_FILE_NAMES.
  102. * replace $SECTION_NAVIGATION by $HEADERS.
  103. * add $NODE_FILENAMES to use node names for files associated with nodes,
  104. such that $NODE_FILES only means creating redirection files.
  105. * Remove the user from footer, and the corresponding USER variable and
  106. $Texi2HTML::THISDOC{user}.
  107. * Don't do anything special anymore when the top element is empty. Also
  108. don't treat especially top element headings.
  109. * Don't skip top element heading if there was a @titlefont.
  110. * Don't treat _setfilename as a value set. It should be available through
  111. get_conf. Same for all the other @-commands previously available as
  112. values.
  113. * Changes in class attribute in html elements:
  114. Change class "toc" for ul to class "no-bullet" ($NO_BULLET_LIST_ATTRIBUTE).
  115. @top and @centerchap have now their command name as class.
  116. @node heading class is now "node-heading", instead of "node".
  117. The whole header is in an element with class "header" (was "node" when
  118. !$HEADER_IN_TABLE).
  119. * print_element_header is obsoleted, things should be directly done in
  120. element_heading.
  121. * Add 'inline_attribute' for an XML attribute that should be closed at
  122. paragraph end and reopened at paragraph begin. Consequently the closing
  123. and opening of 'attribute' isn't done anymore in paragraph and
  124. preformatted.
  125. * USE_ISO now only determines if '', `` --- and -- are transformed
  126. into entities. t2h_default_set_iso_symbols sets or unsets USE_ISO,
  127. %things_map/%pre_map/%simple_format_simple_map_texi,
  128. $OPEN_QUOTE_SYMBOL and $CLOSE_QUOTE_SYMBOL.
  129. %iso_symbols is unused now.
  130. * change in the normal_text function reference API, now there is an
  131. input variable true if in @math.
  132. * change the external_ref API, fourth argument is now the file name and
  133. add the node as an extra argument.
  134. * only install init files from maintained_extra/, they are considered
  135. to be interesting enough and maintained.
  136. * rename $Texi2HTML::THISDOC{css_lines} as $Texi2HTML::THISDOC{css_rule_lines}
  137. 1.82 (2009-01-05)
  138. * NEW FEATURES
  139. ------------
  140. * Add new hooks for user functions, for simple @-commands, and at the start and
  141. end of special regions.
  142. * BUG FIXES
  143. ---------
  144. * Tests are now more cross-platform and more tolerant of missing optional
  145. dependencies.
  146. * Don't use unidecode on unicode characters that are known not to have a good
  147. transliteration. This corresponds with characters with an @-command that
  148. don't have a transliteration, like @exclamdown...
  149. * Misc minor bug fixes.
  150. 1.80 (2009-01-01)
  151. * NEW FEATURES
  152. ------------
  153. * handle @alias, @quote*, @guillem*, @textdegree, @allowcodebreaks,
  154. @fonttextsize, @hyphenation, @click, @clickstyle, @click, @arrow,
  155. @clicksequence, @geq, @leq, @*headingmarks, @*footingmarks, @smallquotation,
  156. @ogonek.
  157. Handle @columnfractions and row prototypes in @multitable better.
  158. * @documentlanguage is used to set the language each time it is seen (except
  159. if the language was set on the command line).
  160. * new option --css-ref, generate reference to a CSS URL.
  161. * new option --transliterate-file-names, produce file names in ASCII
  162. transliteration (set in the default case).
  163. * use accesskey and rel attributes, use link element if set in the init file.
  164. * use node id as targets for sections.
  165. * COMPATIBILITY
  166. -------------
  167. * the API for the formatting of menus completly changed. $simple_menu_link
  168. is removed, everything should be done in $menu_link.
  169. * change handling of @detailmenu and menu comments, with (among other changes)
  170. the menu function reference replaced by the menu_command function reference
  171. also handling @detailmenu.
  172. * tex4ht.init now may use a different external program for @tex and for
  173. @math, and therefore the configuration variables were doubled and
  174. their name changed.
  175. * change in the interface, a new function reference print_element_header
  176. has been added, that should print the heading navigation of an element.
  177. Previously it was done in print_section.
  178. * change in the normal_text function reference API, now there is an
  179. input variable true if in simple text.
  180. * change in the menu_entry and simple_menu_entry function reference API,
  181. the name is always passed, and a new argument tells if there was an
  182. explicit name.
  183. * change in unknown function reference API, now there is a pass argument
  184. to be able to handle unknown macros in other passes than the last.
  185. Report from Reinhold Kainhofer.
  186. * in table_item the text is not formatted with the format command,
  187. the text_formatted argument is.
  188. * definition index entries are now formatted with $definition_index_entry,
  189. not with $definition_category anymore.
  190. * $Texi2HTML::THISDOC{copying} is now $Texi2HTML::THISDOC{copying_comment}.
  191. * TOC_LIST_ATTRIBUTE is now called NO_BULLET_LIST_ATTRIBUTE.
  192. * TOC_LIST_STYLE is now called NO_BULLET_LIST_STYLE.
  193. * changes in command line switches to synchronize with makeinfo:
  194. --number becomes --number-sections
  195. --separated-footnotes becomes --footnote-style
  196. --sec-nav becomes --header
  197. --Verbose becomes --verbose
  198. --lang becomes --document-language
  199. * everything before @setfilename is not outputted, like makeinfo. The previous
  200. behaviour can be restored with $IGNORE_BEFORE_SETFILENAME = 0;
  201. * Now there is an argtype possibility for definition specification
  202. and the arg meaning changed. The whole definition parsing is now more
  203. like makeinfo.
  204. * internal_ref and external_ref don't change inforef to xref anymore.
  205. * change in the heading API. THIS_HEADER is not used anymore.
  206. New function reference, element_heading to format a node or a section
  207. heading, including navigation and label. Accordingly, print_Top and
  208. one_section don't print the element header anymore. Also it is
  209. reported if the element is a new element, is the main element and
  210. more arguments, and top element heading is always done in heading.
  211. * print_element_header and print_navigation now return their result.
  212. * new argument for print_misc and print_misc_header, the misc page name.
  213. * printindex is called if it appears, even if the index is not defined or
  214. there are no index entries.
  215. * image API completly changed. The current behaviour is not stable, so
  216. is not documented.
  217. * new argument (@@-command name) for quotation and quotation_prepend_text.
  218. * image file paths are not completed anymore in the default case. The previous
  219. behaviour can be restored with $COMPLETE_IMAGE_PATHS set to true.
  220. * there is a new 'style' key in $complex_format_map, to be able to
  221. differentiate complex formats inheriting fonts and code_style (like
  222. @format, @display).
  223. * $EXTENSION should be undef if one doesn't want an extension to be added.
  224. * THISDOC{'title'} and similar are now for @title since only one @title
  225. should appear in the document. @settitle is tried first to set fulltitle.
  226. * Configuration variables are not modified anymore, instead the variable
  227. value is put in $Texi2HTML::THISDOC{'VAR'}. This is the case for
  228. DO_CONTENTS, DO_SCONTENTS, CSS_LINES, BODYTEXT, DOCUMENT_DESCRIPTION,
  229. DOCUMENT_ENCODING, IN_ENCODING, ENCODING_NAME, OUT_ENCODING.
  230. For example, if $CSS_LINES is defined, the value is put in
  231. $Texi2HTML::THISDOC{'CSS_LINES'} which is used for formatting, and if
  232. $CSS_LINES is not defined, $Texi2HTML::THISDOC{'CSS_LINES'} is
  233. autodetected.
  234. * When there is no section and $USE_NODES is not set don't split by node.
  235. This behaviour and the previous aren't documented, so it could change
  236. in the future.
  237. * BUG FIXES
  238. ---------
  239. * --no-monolithic is reenabled.
  240. * @, followed by an argument without brace is now handled. Report from
  241. Jorge Barros de Abreu.
  242. * @, is kept with --macro-expand.
  243. * @math is more compatible with makeinfo/texi2dvi when no external program
  244. is used. Using tex4ht for html generation should also lead to a correct
  245. result.
  246. * Handle right @end block commands followed by something else than a
  247. spacing character.
  248. * Remove trailing end of line in @html block.
  249. * @itemize should produce bullets by default. Report from Reinhold Kainhofer.
  250. * handle frame files like other files. Report from Reinhold Kainhofer.
  251. 1.78 (2007-06-05)
  252. * NEW FEATURES
  253. ------------
  254. * Transliterate accented characters in file names. Use Text::Unidecode
  255. if detected.
  256. * Handle @frenchspacing, @tie, @indent, @setcontentsaftertitlepage,
  257. @setshortcontentsaftertitlepage and the obsolete @allow-recursion
  258. and @quote-arg.
  259. * With book style the Table of Contents is put where it is set.
  260. * Use more numeric entities, especially for accented letters.
  261. * The `examples' directory now contains an init file for Mediawiki output.
  262. Mediawiki is the GPL'd wiki used by Wikipedia.
  263. * new init file tex4ht.init. With this init file, httex or htlatex from
  264. tex4ht is used to format @tex and @math.
  265. * Init files now have a chance to override all file names, rather than just
  266. page names.
  267. * Put the images under a double licence by adding back their original GPL
  268. licence.
  269. * If SIMPLE_MENU is true the menu is simply enclosed in a preformatted
  270. environment.
  271. * The user can bypass the texi2html functions and provide his own function
  272. to do things similar that what is done for interfacing with LaTeX2HTML
  273. or tex4ht.
  274. * LaTeX2HTML stuff is moved out of texi2html.pl, to T2h_l2h.pm.
  275. * Add $USER and $DATE variables to override the defaults detected for the
  276. footer.
  277. * COMPATIBILITY
  278. -------------
  279. * $TOP_FILE and $TOC_FILE are only set if set by the user. The elements
  280. file names are in the hash reference $Texi2HTML::THISDOC{'filename'}
  281. for use in init files.
  282. * The API for image, normal_text, paragraph and node_file_name has changed.
  283. * The $ENCODING variable is deprecated, replaced by $ENCODING_NAME
  284. and $OUT_ENCODING.
  285. * utf8 is used as default out file encoding. This should allow for utf8
  286. translations for languages which cannot use @-commands for non ascii
  287. characters.
  288. * Use entities for ``, '', ---, -- and quotes used for some formatting
  289. @-commands if $USE_ISO is set.
  290. * don't set unset MENU-ENTRY-NAME if it is similar with the NODE-NAME,
  291. it is useless as it is a construct that shouldn't happen.
  292. * avoid menu entry and description redundancy in the formatting function
  293. and not in the main program.
  294. * accept - in @-command names (compatibility with makeinfo)
  295. * in user-defined macro arguments a comma in brace is escaped (compatibility
  296. with makeinfo from texinfo 4.8.90)
  297. * don't add the section title to the html title when the document isn't split
  298. * BUG FIXES
  299. ---------
  300. * When the file extension is set to the empty string, a trailing `.' will not
  301. be automatically added to file names.
  302. * The texi2html script is now created by make and not configure.
  303. * It is possible to build the translation files from outside of the
  304. build directory.
  305. * When configure detects that no Data::Dumper is present, the build scripts
  306. will simply copy the files instead of breaking.
  307. * remove handling of quotation second arg, quotation has only one arg.
  308. * handle nested ifset/ifclear.
  309. * Improved handling of @sc and @centerchap.
  310. * More flexible normal_text.
  311. * style_stack really contains the formatting @-commands.
  312. * caching of html generated by latex2html reenabled.
  313. * when not split and no section navigation is output, the about page and
  314. navigation direction are not output for all the elements.
  315. * FOR DEVELOPERS
  316. --------------
  317. * Standardized on Automake 1.10.0
  318. 1.76 (February 3 2005)
  319. * BUG FIXES
  320. ---------
  321. * Perl no longer needs to be installed at build time, but when it is not, the
  322. path to `perl' that will be used at run time must be passed to the
  323. `configure' script.
  324. 1.74 (January 31 2005)
  325. * COMPATIBILITY
  326. -------------
  327. * The argument on def like commands line (@deffn and friends) may be
  328. bracketed, therefore there is no difference between this element and
  329. others. There is no need of items with { in front in the %def_map
  330. anymore.
  331. * NEW FEATURES
  332. ------------
  333. * More @-commands are available to the user, that were ignored before.
  334. Most of these @-commands are those related with structure or printed
  335. output.
  336. * BUG FIXES
  337. ---------
  338. * many deffn and friends line parsing bugs fixed.
  339. 1.72 (December 29 2004)
  340. * NEW FEATURES
  341. ------------
  342. * Handle texinfo 4.7 constructs:
  343. @caption, @shortcaption, @ordf, @ordm, @registeredsymbol, @deftypecv,
  344. @LaTeX, @indicateurl, @docbook, @ifdocbook, @ifnotdocbook, @comma,
  345. @headitem, @quotation second arg, @acronym second arg.
  346. @url is now a synonym for @uref. @ at the end of a @def* line continues the
  347. line.
  348. Handle texinfo 4.8 constructs:
  349. @abbr, @slanted, @euro and @sansserif.
  350. * Cross refs are done according to the specification presented in the texinfo
  351. manual in the node HTML Xref.
  352. * BUG FIXES
  353. ---------
  354. * Re enable compatibility with perl older that 5.6.
  355. 1.70 (March 24 2004)
  356. * BUG FIXES
  357. ---------
  358. * use i18n files even when translations.pl is not included. Include
  359. translations.pl.
  360. * COMPATIBILITY
  361. -------------
  362. * install html manual in $datadir/texinfo/html.
  363. * NEW FEATURES
  364. ------------
  365. * Add a spec file, usefull to build a rpm.
  366. * FOR DEVELOPERS
  367. --------------
  368. * Standardized on Autoconf 2.59 & Automake 1.8.3
  369. 1.68 (March 20 2004)
  370. * COMPATIBILITY
  371. -------------
  372. * When the manual is split the default is to put resulting files in a
  373. directory with name the manual file basename (previously they were left in
  374. the current directory). To avoid that, call texi2html with '-output .'.
  375. * The main configuration files are now ./Config, ~/.texi2html/Config,
  376. $sysconfdir/texi2html/Config and last $datadir/texi2html/Config. They are
  377. sourced in that order.
  378. In the future `/etc/texi2htmlrc' and `~/.texi2htmlrc' will no longer be
  379. sourced and any existing site or user configuration should be moved to the
  380. new locations if you wish it to be used by newer versions of Texi2HTML.
  381. * Translation files are now stored in $datadir/texi2html/i18n/*,
  382. $sysconfdir/texi2html/i18n/*, ~/.texi2html/i18n/*, and sourced in that order.
  383. The translated strings are now associated with the english strings.
  384. Please see the documentation for the format of the new translation files.
  385. * First index page is the first page with a non empty index (with @printindex).
  386. * The glossary and bibliography terms aren't searched anymore. You should use
  387. @macro to simulate these features (look at Tests/macros/glossary.texi for
  388. an example).
  389. * We've standardized on GNU-style `--' prefixed long options, rather than the
  390. old single-dash prefixed long options in the help, but the single-dash style
  391. is still accepted on the command line for the time being.
  392. We also changed `_' to `-' in option names.
  393. * @setref handling is removed as the right corresponding @-command is @anchor.
  394. * No more global variables outside of namespaces.
  395. Global variables are now in the Texi2HTML namespace.
  396. leading T2H_ is stripped from variable, hashes and array names. You should
  397. change your variable names for the new release. As the global variables
  398. (%THISDOC, $THIS_SECTION...) are in the Texi2HTML namespace you should use,
  399. for example, $Texi2HTML::THISDOC{'fulltitle'} now.
  400. functions from the main program should now be qualified in the main
  401. namespace. t2h_ is stripped from the function names too.
  402. t2h_anchor is now a function reference in init file, and thus should
  403. be called like &$anchor(...).
  404. toc file and main file are arguments for print_frame, overview lines are
  405. arguments for print_toc_frame (instead of global variables).
  406. * $THISPROG, $T2H_HOMEPAGE, $T2H_AUTHORS, $T2H_TODAY, $T2H_USER are now
  407. values associated with the following keys in %Texi2HTML::THISDOC:
  408. `program', `program_homepage', `today', `user'.
  409. * Changes in the function reference used for the page layout:
  410. print_section don't do the end of page or section anymore (except when
  411. split at node), end_section does the end of a section, and print_*_footer
  412. does the end of page.
  413. the print_*_header, print_*_footer... functions take a ref on the buttons
  414. array as argument, instead of using the $T2H_BUTTONS global variable.
  415. Have a look at the texi2html.init file to update your configuration files.
  416. * T2H_InitGlobals is not used anymore. Use the function reference init_out
  417. to define $BODYTEXT dynamically and %Texi2HTML::THISDOC values in
  418. print_page_foot and about_body to recreate the address instead of the
  419. $T2H_ADDRESS.
  420. You can have a look at program_string in texi2html.init which recreates
  421. the address. $T2H_ADDRESS isn't used anymore.
  422. * variables for latex2html are not in texi2html init file anymore but in
  423. l2h.init.
  424. * don't expand @ifinfo regions by default.
  425. * option --output obsoletes -out_file and -subdir. It is the same than
  426. --out_file when output is not split, and the same than --subdir when it is
  427. split.
  428. * If not split, the resulting file has a leading directory, and the directory
  429. doesn't exist, it is created.
  430. * If a directory creation fails the program aborts.
  431. * Don't use T2H_CENTER_IMAGE, @center should be used.
  432. * the init_out function redefines dynamically %NAVIGATION_TEXT, %BUTTONS_GOTO
  433. and $BODYTEXT. You should redefine the hash values in that function. If you
  434. want to reuse the values of the default values set by init_out,
  435. you could do something like:
  436. my $default_init_out = $init_out;
  437. $init_out = \&makeinfo_like_init_out;
  438. sub makeinfo_like_init_out()
  439. {
  440. my $encoding = &$default_init_out();
  441. $NAVIGATION_TEXT{'Following'} = ' > ';
  442. return $encoding;
  443. }
  444. * NEW FEATURES
  445. ------------
  446. * Many changes towards output of stricter HTML.
  447. * initialization files for html 3.2, xhtml, html 4.0 with inline style,
  448. no header, utf8 characters outputted, makeinfo style, book style, conversion
  449. to chm files and conversion to roff. Initialization files are searched
  450. in ./, ~/.texi2html, $sysconfdir/texi2html and last $datadir/texi2html.
  451. The file names are html32.init, xhtml.init, inlinestyle.init,
  452. noheaders.init, utf8.init, makeinfo.init, book.init, chm.init and roff.init.
  453. * The test suite is much more comprehensive and uses validate and tidy to
  454. assess the correctness of the HTML.
  455. * Handling of @html, @verbatim, @verb, @sp, @=, @copying, @insertcopying,
  456. @cartouche, @titlefont, @dircategory, @direntry, @shorttitlepage, @\,
  457. @afourlatex, @afourwide, @firstparagraphindent, @exampleindent, @novalidate,
  458. @definfoenclose, @kbdinputstyle, @centerchap, @documentdescription,
  459. @documentencoding, @contents, @shortcontents, @verbatiminclude.
  460. * With --no-validate node cross-reference validation is suppressed (like
  461. @novalidate).
  462. * --expand may be specified more than once such that more than one additional
  463. region could be expanded. --noexpand does the reverse. --iftex, --ifinfo...
  464. and --no-ifinfo... can be used instead.
  465. * add http-equiv="Content-Type" tag for the charset declaration.
  466. * HTML formatting is isolated in customizable functions located in the
  467. initialization files.
  468. * menu comments are in a preformatted context.
  469. * Any combination of caps for `top' leads to the top node.
  470. * @ref{(perl)Top} leads to a ref to the info manual.
  471. * References to external manual in @ref and menus are links to the html
  472. pages (with the same convention than makeinfo --html use).
  473. --html-xref-prefix is the base dir for external manual references.
  474. * With --node-files do a file per node which can be used as a target for
  475. cross references from other manuals (including manuals generated with
  476. makeinfo --html).
  477. * With --use-nodes nodes are sectioning commands whe they are not associated
  478. with a structuring command.
  479. * With --toc-links create links from headings to toc entries.
  480. * distinct directions (next, prev...) for nodes and sections, more directions.
  481. * split at chapter, section or for every node.
  482. * new possibilities for buttons. If this is a ref to a scalar, the text
  483. appears in navigation. If it is an array, the first element is a direction
  484. used for the href, the second element is a scalar ref for the text.
  485. * With --noseparated-footnotes the footnotes are in the same page than the
  486. text.
  487. * %NO_TEXI hash similar with %HREF but without texinfo commands,
  488. %THISDOC{'title_no_texi'}
  489. * "-U value" does the same than "@clear value".
  490. * -P option prepends directory for include files before the document directory.
  491. * -macro-expand generates a file with expanded macros and @include.
  492. * pass $L2H_HTML_VERSION for the html version to latex2html.
  493. * support for css. The --css-include option does the same than in makeinfo
  494. (parse the file, and echo the @import part before the texi2html css rules,
  495. the rules part after the texi2html css rules).
  496. The texi2html css commands may be customized too.
  497. * Text before the first @node or sectioning command is part of the first
  498. section unless -ignore-preamble-text is set.
  499. * if `-' is given to the -output option, output on STDOUT.
  500. * Add images from the Singular project.
  501. * All the strings appearing in the HTML are internationalized.
  502. * centering and flushing is really handled.
  503. * Format titlepage (even though the formatted text isn't used by default).
  504. * Handle all the encodings perl knows about.
  505. * BUG FIXES
  506. ---------
  507. * @multitable size determination, out of bounds columns ignored.
  508. * In @table and @itemize, @item is replaced by the @-command argument.
  509. * nested @-commands are better handled.
  510. * in index keys @-commands are replaced by the right symbols.
  511. * files are omitted in hrefs when they points to the same file.
  512. * $value{_title}... are expanded during HTML generation.
  513. * @H{a} leads to a'' and not á
  514. * cedilla are accepted in node names.
  515. * Any characters are accepted in menu comments.
  516. * frame target is the top file, and not the toc file.
  517. * rewriting of the @macro code completely. This likely fixed some bugs but
  518. this hasn't been verified by running the new, more complex test cases
  519. against the old code.
  520. * rewriting of the document structure resolution.
  521. unnumbered regions are at the right level and splitted indices don't break
  522. the document structure anymore.
  523. index entries and footnotes are more precisely located.
  524. * @-commands ignored are ignored with the line, the arg or following spaces
  525. like makeinfo does.
  526. * FOR DEVELOPERS
  527. --------------
  528. * Standardized on Autoconf 2.59 & Automake 1.8.2
  529. * The --enable-maintainer-mode option is now required by configure to enable
  530. what is considered the maintainer-specific portions of Makefiles. This
  531. includes the portions which automatically rebuild the configure and build
  532. files (configure, aclocal, Makefile.in, etc) when configure.in or other
  533. dependencies are changed.
  534. * The config is in the Texi2HTML::Config namespace. The latex2html related
  535. functions are in the Texi2HTML::LaTeX2HTML namespace. The
  536. internationalization functions are in the Texi2HTML::I18n namespace in
  537. T2h_i18n.pm.
  538. 1.66 (June 8 2002)
  539. * Many bug fixes.
  540. 1.65 (August 26 2001)
  541. * Many bug fixes.
  542. * The operation of the previously broken << (FastBack) and >> (FastForward)
  543. buttons has changed slightly. FastBack now returns to the beginning of the
  544. current chapter and FastForward now jumps to the beginning of the next
  545. chapter.
  546. 1.64 (July 3 2000)
  547. * Incorporated first version of Texi2html Texinfo manual, authored by
  548. Karl Heinz Marbaise <khmarbaise@gmx.de>
  549. * New handling of command line options:
  550. - can be abbreviated to shortest unique prefix
  551. -help now works and is up-to-date
  552. 1.63 (June 23 2000)
  553. * New customization variable:
  554. $T2H_HREF_DIR_INSTEAD_FILE:
  555. if set (e.g., to index.html) replace hrefs to this file
  556. (i.e., to index.html) by ./
  557. * New command-line option:
  558. -toc_file FILE
  559. for those who want the TOC to be in FILE
  560. * bug fixes related to macro invocation
  561. 1.62 (12 April 2000)
  562. * New customization variables:
  563. $T2H_SPLIT_INDEX [default: = 100]
  564. index pages are split at next letter, if more than that many entries
  565. $T2H_NODE_NAME_IN_MENU [default = 0]
  566. for enforcing node names in meny entries
  567. $T2H_AVOID_MENU_REDUNDANCY [default = 1]
  568. to avoid display of duplicate meny entry information
  569. $T2H_INDEX_CHAPTER [default = '']
  570. if set, use chapter of this name for 'Index' Button in
  571. navigation bars, else use first chapter whose name matches
  572. "index" (case insensitive).
  573. $T2H_TOP_HEADING [ default = '']
  574. if non-empty, and no heading is in Top node, then use this as heading
  575. for top node/section; otherwise, use @settitle, @shorttitle.
  576. * index generation: observes typesetting in fixed-width font, @ftable,
  577. @vtable implemented
  578. * Peter Moulder & Teun Burgers: Misc documentation and distribution
  579. changes
  580. * numerous small bugs fixed (handling of menu entries, paragraphs in
  581. lists/tables, etc).
  582. 1.61 (31 March 2000)
  583. * By default, $T2H_TOP_FILE is not set, and so $docu_name.html is used.
  584. * Added T2H_print_chapter_header, T2H_print_chapter_footer for more
  585. fine-grained control of T2H_SPLIT eq 'chapter', added option
  586. -section_navigation, $T2H_SECTION_NAVIGATION to supress output of
  587. navigation panels per section
  588. * naming scheme and calling convention of customizable subs changed:
  589. prefix T2H_, call &$T2H_, assignment $T2H_<name> = \&T2H_DEFAULT_<name>
  590. * mailinglist created: texi2html@mathematik.uni-kl.de
  591. * conversion to standard gnu package with Makefile.am, README,
  592. AUTHORS, etc. (Peter Moulder <reiter@netspace.net.au>)
  593. * Initialization as suggested by Peter Moulder:
  594. 1. /usr/local/etc/texi2htmlrc (or whatever given by --sysconfdir to
  595. configure)
  596. 2. $HOME/.texi2htmlrc
  597. 3. command-line options, including -init_file
  598. where later options override previous ones.
  599. * incoporated patches from Peter Moulder (backward-compatible
  600. command-line options, separate man-page, etc).
  601. * Automatic node pointer creation added
  602. * @enddots, @exclamdown, @pounds, and relatives added.
  603. Major Changes from 1.58 to 1.60
  604. * primitve foreign language support
  605. * support of all "Umlaute"
  606. * anchors, macros
  607. * latex2html incooperation
  608. * customizable page layout (texi2html.init)
  609. * index as table with corresponding sections