CHANGES of the GAPDoc package 1.6.6 -> 1.6.7 - Better handling of very long words in text version. - Nicer quotation marks in HTML version. - Fixed a few problems with special characters in the LaTeX/PDF version of manuals in texts shown in typewriter font (e.g., "--" was sometimes displayed as single "-"). - Updated various URLs. 1.6.5 -> 1.6.6 - Changed 'XMLValidate' and 'ValidateGAPDoc' to print a warning without error, when the IO package or 'xmllint' is not available. - Accelerated build of LaTeX source. - Introduced optional argument to `ExtractExamples` to include elements. - Fixed a problem with attribute values which are wrongly interpreted as markup for MathJax. 1.6.4 -> 1.6.5 - Added a first version of `StringBibXMLEntry` for Markdown format. - Some more translations from LaTeX to unicode (from examples in MathSciNet). - Now we handle \ge and \le in translations. - Fixed commas in normalized argument lists with complicated optional arguments. - When a BibTeX entry is translated to HTML and it contains `url = ...` information, then the title is now a link to this URL. - Fixed a problem with capital letters in Label attributes. - The GAPDoc style changing javascript code now works with manuals served via https. - Introduced utility functions 'XMLValidate' and 'ValidateGAPDoc' for proper validation using the external program 'xmllint'. - We now normalize whitespace of 'Label' attributes. This allows for long labels, even broken over lines. - Better argument check in 'SetGAPDocTextTheme'. - Changed default color for 'Example's in color text mode. 1.6.3 -> 1.6.4 - Now computing better labels for bibliography entries containing names with certain non-ASCII initials. - Fixed sorting of index entries containing special characters `<`, `>`, `&`, `\` or `_` . - Made labels independent of white space. - Added various new translations from LaTeX markup to UTF-8. 1.6.2 -> 1.6.3 - In Text and HTML versions: Made 'Label' strings independent of whitespace (as is usual in LaTeX). - New optional "nopdf" argument of 'MakeGAPDocDoc'. - 'MakeGAPDocDoc' now produces useful text and HTML versions even if 'bibtex' and 'pdflatex' do not work. - 'HelpData" handler for "pdf" format now returns 'fail' if there are no page numbers in manual.six file. 1.6.1 -> 1.6.2 - Improved 'InitialSubstringUTF8String' by an optional argument to return a string with a suffix. - Change access of javascript code for MathJax to https protocol (such that MathJax works for help pages accessed via https). - Added option ".uri := true" to 'SearchMR' to return URI instead of sending a request to MathSciNet. - Added many cases handled by 'HeuristicTranslationsLaTeX2XML', this is needed because MathSciNet has changed the markup for accented characters in many cases. - Made 'SearchMR' work again using 'wget' or 'curl' (MathSciNet is now only accessible via HTTPS). - Better ordering of help matches if the first word is the query string (patch provided by Max Horn). - Escape the special characters @!|" for 'makeindex' in index entries for LaTeX. - Removed dependency on 'a4wide.sty' file in LaTeX installation. 1.6 -> 1.6.1 - Slightly nicer display of header lines of ManSection's with long names and/or long argument lists. - Added an element to be used in ManSection's on constructors. - Minimal changes to make GAPDoc (translation of manual, and handler functions for the help system) work in any single thread in HPCGAP. 1.5.1 -> 1.6 - Changed and documented the handling of elements; its content is not reformatted. - Can now handle help books with empty bibliography. - Some technical adjustments which make it easier to use GAPDoc with HPC-GAP. - Some cosmetic improvements, mainly for text output and markup of nested elements. - Introduce finer distinction of -elements for HTML with/without MathJax. - 'StringBibXMLEntry' supports now a 'rec(MathJax := true)' option. - Added a new utility function 'InitialSubstringUTF8String'. - 'NormalizedNameAndKey' can now find initials from UTF-8 encoded name strings. - The HTML manuals in Browsers with Javascript now always have the [Style] link, even if no MathJax version is generated. - 'RunExamples' now returns 'true' or 'false'. - Removed support for the "MathML" variant of 'GAPDoc2HTML' which was probably not used anyway. - MakeGAPDocDoc (more precisely AddPageNumbersToSix) will no longer enter a break loop in case of an empty index (noticed by Thomas Breuer). - New function 'LabelsFromBibTeX'. If BibTeX is available this is used to unify the labels used for citations and the ordering of the reference list in the LaTeX, text and HTML version of a GAPDoc document. - 'ComposedDocument' now accepts also file names with absolute paths and relative to GAP roots. (Uses a new function 'FilenameGAP'.) - Documented 'DOCCOMPOSEERROR' for 'ComposedDocument' to ignore missing chunks. - Mention that .bib files for must be in latin1-encoding, and corrected 3k+1.bib accordingly (error noticed by Bill Allombert). - Corrected HorLine in tables without trailing | column (report and fix by Max Horn). - Recognize document encoding in 1.5.1 - Adjustments to GAP's new DeclareUserPreference setup. 1.4 -> 1.5 - Substituted the TestManual functions by new ones based on the new 'Test' functionality in the GAP library: ExtractExamples, RunExamples. (Used this to adjust all manual examples.) - Added a copy of GPL text. - Corrected/improved handling of certain external references, and some other small errors (reported by James Mitchell). - Improved detection of UTF-8 input. - Improved/adjusted manual examples. 1.3 -> 1.4 - Made license statement more direct. - Slight change of the dtd: The elements now permit elements in their content. The converters were adjusted accordingly. - Several layout changes in text version: More unicode characters are used, e.g., for fill strings and table borders (see BOXCHARS). Also mathematical symbols from unicode are used more often. Less colors are used in default text theme. - Several text themes are available in the distribution (more by others are welcome). The preferred theme can be configured by the user via SetGAPDocTextTheme and at startup via a user preference SetUserPreference("GAPDoc", "TextTheme", ...). - Improved markup of elements in function definitions in Text and HTML conversion. - The text version of the manuals now contains more hooks (by pseudo escape sequences) for preprocessing before display. Paragraphs are now reformatted to current screen width. Unicode to latinX translation is now done with multi-character substitution. And markup with visible characters becomes possible, e.g. the "old" text theme (tables are not reformatted which can lead to some problems). - Slightly changed layout of the title page in LaTeX/PDF manuals. - The LaTeX/PDF manuals use less colors by default. - The tables of content contain now references and index (not convinced that this is ok, but was often requested). - Preferred style for viewing the HTML manuals can be configured by the user via user preferences: SetUserPreference("GAPDoc", "HTMLStyle", ...) and SetUserPreference("GAPDoc", "UseMathJax", true/false) - The HTML manuals support style switching (via URL and cookie) with javascript and cookie enabled browsers. Several styles (and combinations) are offered in the distribution (more by others are welcome). - The HTML manuals contain now a hook to use javascript and a few more hooks for CSS style sheets. - All output versions contain now markup for coloring GAP examples as with ColorPrompt(true). (Easy to switch off for text and HTML in user config.) - Link from MathJax HTML manuals to central server http://cdn.mathjax.org to get scripts and fonts. - Added a link to the "Contents" on top and bottom of each HTML manual page. - For LaTeX/PDF conversion of manuals we use now the "psnfss" for postscript fonts. - Added more hooks and simplified customization of LaTeX/PDF manuals (see "SetGapDocLaTeXOptions"). - PDF-verison is now by default generated with bookmarks (for acroread and other viewers), but such that they are not opened by default. - Fixed a bug when displaying multiple hits while ANSI_COLORS=false. 1.2 -> 1.3 - Improved the example ./gapdoc.css file (also used for the GAPDoc manuals): when hovering over a link to a section its subsections are now shown in a separate block. - The Arg attribute in and other elements now allows for GAP options. - Added support for HTML output using MathJax (http://www.mathjax.org/). MakeGAPDocDoc and GAPDoc2HTML now allow an optional argument "MathJax". - Better bound for long index entries to be hyphenated (can now also be changed by setting GAPDoc2LaTeXProcs.MaxIndexEntryWidth). - Improved the \description environment in LaTeX output using the enumitem LaTeX packages. Now works with very long labels. - Now a warning is given if ComposedDocument finds several pieces of documentation with the same label. - Fixed a problem which caused ParseError in rare cases to display the wrong line (reported by Laurent Bartholdi). - Tables without | or HorLine are now distinguished in HTML version, such that they can be configured to be displayed without borders. - There is a new attribute Mode="M" for elements, if this is given the formula is processed as in elements. 1.1 -> 1.2 - New utility to access the MathSciNet data base from within GAP (only if your computer has access, of course), see documentation of 'SearchMR'. - Now letters counting appendices are also printed without trailing dot in references. - Slightly changed HorLine's in text-version of output. - Various changes in tools for bibliography data (many suggested by Thomas Breuer): - Avoid some syntax errors caused by 'NormalizedNameAndKey' in case of first names starting with non-ASCII character (but still cannot correctly handle these cases, use BibXMLext instead). - Improved sorting of bib-entries in HTML/Text output. - Better heuristic functions for translating characters in LaTeX code in BibTeX entries to unicode, see 'HeuristicTranslationsLaTeX2XML'. - Handle (rare) short MathReview numbers. - Better formatted output for HTML version of bib-entries. - Fixed the case of an empty 'strings' list in 'RecBibXMLEntry'. - Apply recoding to strings from BibXMLext data. - Use default markup in StringBibAsText (undocumented, internally used by StringBibXMLEntry) when called with one argument. - Added more simplifications and LaTeX translations of unicode characters. - Improved "RepeatedString". - XML parser: - Could show wrong line number for original position of code with error. - Now the ":" is allowed in element and attribute names, this allows to implement utilities for dealing with XML name spaces (http://www.w3.org/TR/2006/REC-xml-names-20060816/). - Corrected bug in normalization of argument lists (if "," was used as separator). Also the layout was changed in case of leading optional arguments (reported by Laurent Bartholdi). 1.0 -> 1.1 - We allow unicode characters which have useful translations to LaTeX and as simplified string (with one character, for the moment) in mathematical formulae. Introduced entities &CC;, &ZZ;, &NN;, &PP;, &QQ;, &HH;, &RR; for \mathbb characters. - Now chapter numbers in references to chapters are without trailing dot in text and HTML converters. - Fixed bug with vertical spacing for in text converter. - GAPDoc can now be used with other languages than English, see 'SetGapDocLanguage' for details. - Various documentation improvements. - New options "utf8" and "nopslatex" for LaTeX converter, see 'SetGapDocLaTeXOptions'. - Introduced "LaTeXUTF8" encoding (uses known translations but leaves other characters as they are). - Removed support of '\N, \Z, ...' for '{\mathbb N}, {\mathbb Z}, ... (was not documented before). But see &NN; above. - Introduced 'WrapTextAttribute' which takes care of existing escape sequences in the text to wrap. Use it for the text converter to handle elements with markup which are contained in each other correctly. 0.99999 -> 1.0 - Changed the status of the package from "deposited" to "accepted". - GAPDoc language (only few changes, all are fully backward compatible): - Made entities for LaTeX special characters ($tamp;, &percent; and so on) unnecessary (but kept them--with simplified definitions--for backward compatibility). Now just write characters in content and attribute values directly, except for math elements which contain LaTeX code. - A does now allow an optional (I would not like if this would be used extensively, but can be sensible for ManSections which explain several commands.) - does now allow an optional element to specify subkeys with further markup (not possible in 'Subkey' attribute). - , , now allow optional elements and to specify text with further markup (not possible in 'Text' attribute). - New element . Can be used everywhere (e.g., for additional data like source code, or to comment non finished parts of the document). - MakeGAPDocDoc: - Now the text converter is called first to produce labels for (sub-)sections which are independent of their number (see 'Text converter:' below). - Now only the PDF manual is compiled from the LaTeX version. - The .log file written by pdflatex is checked for errors, warnings and overfull boxes; these are displayed. - Bibliography data (see '?GAPDoc: Utilities for Bibliographies'): - Defined a 'BibXMLext' format for bibliographies with DTD bibxmlext.dtd (better data format if not used for LaTeX). - Utilities for parsing BibXMLext data and translating them to various formats (BibTeX, Text, HTML). Includes a utility to approximate BibXMLext data from given BibTeX data. - BibXMLext databases can be specified in (and I suggest to use this possibility). - Labels for references in Text and HTML converter are now similar to those produced by BibTeX. - New functions for extracting and checking the code in all elements, see 'ManualExamples', 'TestManualExamples'. - Unicode strings: - Introduced unicode strings and characters as GAP objects, see '?Unicode'. - Translations between unicode strings and GAP strings in various character encodings, see '?Encode'. (Mainly UTF-8, ISO-8859-X, "XML" and "URL" encodings.) - Some non-injective (partial) maps from unicode: a "LaTeX" encoding, simplifications to ASCII or latin1, conversions to lowercase and uppercase characters. - The internal encoding for the XML parsed data is now UTF-8, this is also recommended for input (all GAPDoc files are now in UTF-8 encoding), but all latin? encodings work as well. - LaTeX converter: - Convert long URLs such that LaTeX can hyphenate them after slashes (but without a maybe confusing hyphenation dash). - Documented SetGapDocLaTeXOptions, see ?GAPDoc2LaTeX. (E.g., settings for hyperref, using colors or not.) - The default LaTeX markup for , is now by slanted typewriter font. - Very long identifier names are now hyphenated in the (two-column) index. - The pdf-manuals now know their paper size. - The pdf-manuals contain the robust labels generated by the text converter (see below). E.g., with xpdf one can display a labeled text directly: xpdf manual.pdf +L.