********************************************** * * * CHANGELOG of uman() (Scilab ATOMS Package) * * * ********************************************** * Author: Samuel GOUGEON * ---------------------------------- CHANGES 3.1.1 => 3.2 (2023-03-26) ---------------------------------- General * Portage to Scilab 2023.0 b mode: * portage to gitlab (Scilab and its forges) * "ba" now works as well for scilab forges @ mode: "@s" implemented REFERENCES ADDED ---------------- * Redirections to Scilab: fseek, resample, substr, source (O), strcmpi, system * ATOMS: dataint, gui2bitmap, odesolver, SegmentedTurningDesign * Other external: labview (ref updated) * List of Removed functions: 33 references added. BUG FIXED * A variable named String defined in the console disabled uman, with an error "jimport: An error occurred: A variable with this name is already existing" ---------------------------------- CHANGES 3.1 => 3.1.1 (2022-01-05) ---------------------------------- w mode: The redirection from numerous missing online pages for 6.1.1 to corresponding 6.1.0 pages is removed. The 6.1.1 online help has been republished today in a complete way. -------------------------------- CHANGES 3.0 => 3.1 (2021-12-22) -------------------------------- General * uman can now be used in the advanced console, since UTF8 characters can now be correctly displayed in NW mode (since Scilab 6.1.0). * uman can now address pages of unregistered modules (stored out of ATOMS, SCI\contrib\, or other known paths specified in the user preferences); * `uman … w` works around missing online pages for 6.1.1 * Display of mathematical formulae in the console is improved: x^2 → x², etc. b mode * Now "ba" forces listing all reports, including Resolved ones, whatever is the show_only_resolved_bugs user's preferences setting. @ mode * @ mode updated to address mailing list archives moved to https://www.mail-archive.com * uman item @d allows querring dev@lists.scilab.org mailing list archives w mode * Online pages missing for Scilab 6.1.1 now redirect to their 6.1.0 version REFERENCES ADDED ---------------- * Redirections - internal: WFILE_f (obs) - to Scilab: bartlett, blackman, commandhistory, charpoly, computer, cot, fplot, hamming, hann, hanning, join, newline, quiver, rotate3d, spalloc, time, yyaxis - to external: expm1, lambertw, log1p, pascal * ATOMS: quickplot, sciTorch, sci_sundials, xlreadwrite BUG FIXED --------- * `uman …` crashed Scilab 6.1.1 (https://gitlab.com/scilab/scilab/-/issues/16771 regression) * `uman … @` uses now https://www.mail-archive.com/users%40lists.scilab.org and https:www.mail-archive.com/dev%40lists.scilab.org * `uman and_op u` displayed no synopsis. * In lists of terms, when the definition of a term is not set in a =>
tag, it was ignored. Example: uman uman_config * `uman scilab`, and `uman prettyprintv yielded an error due to "&" in areas. * `See also` sections were badly displayed for items without short description. * When an internal Scilab function is overwritten by a local user function, the 'x' option still targeted the native version instead of user's one. * Multiline LaTeX formulae specified in alt="..\n..\n.." for alternate text rendering were poorly handled. Example: uman kron d * For pages whose synopses are organized in blocks separated with an empty line, uman() removed separating empty lines. Example: `uman grand u` * `uman setdiff d` and `uman spec d` badly displayed the heading line of the table including some colspanned titles. * In the uman and uman_internal pages, links to uman and removed ATOMS modules were wrong. * Preferences => Paths to other packages: When a path is not valid, uman silently failed indexing aimed resources. * After installing or uninstalling some ATOMS toolbox, the uman's update of installed toolboxes list could yield an error "Unknown field : WebSite." * When myfun is in a unregistered module, `uman myfun g` displayed myfun head_comments in addition to calling the help browser. This occurs when the item is in a lib out of ATOMS * `uman item gl##` required first closing the help browser by hand. It is now done automatically in a proper way (since Scilab 6.1.1). * uman ignored the user's preferred web browser for the b w @ options. * `uman atoms> b` silently did nothing. ------------------------------- CHANGES 2.1 => 3.0 (2019-08-22) ------------------------------- NEW FEATURES ------------ PREFERENCES uman has now its Preferences tab in the Scilab preferences() GUI, as a toolboxes subsection. All uman configuration parameters are now set through this preferences interface. They are stored in the SCIHOME/uman_preferences.xml file. GENERAL * REMOVED Functions and features: In console, web or helpbrowser modes, when querying information about a removed feature, now - 'uman' displays an explicit message about last supporting Scilab version, - 'uman' proposes a possible replacement (if any), - 'uman' suggests targeting the archived online help page (if any), or actually targets it if the 'w' web mode is used. In addition, a new module https://atoms.scilab.org/toolboxes/removed gathering all help pages of old removed Scilab functions is available on ATOMS, in complement to 'uman'. If it is installed, 'uman' uses it whenever it is relevant. * 'uman' now automatically detects whether any ATOMS module has been installed or uninstalled during the session, and rescans resources accordingly. The reloading 'r' option is still available. It can be used when you install contribs other than ATOMS ones, or if you write and test your own help pages. * 'uman' now uses automatically the ATOMS packages list downloaded by your ATOMS manager to complete its own set of ATOMS references. Hence, 'uman' is now always up-to-date about all available ATOMS ressources, even uninstalled ones, provided that your ATOMS manager is so. * uman messages can now be translated. There are already available for french. Native speakers are welcome to translate messages in ./locales/en_US.po in other languages. * Querying bugs now requires simply the 'b' option instead of the 'wb' pair. The former 'b' option alone was almost useless. * ~100 unitary tests are added for all uman modes. DISPLAY IN CONSOLE: * New 'p' option to display the Parameters section of a page. The display of this section is no longer mandatory. The former uman behavior can be restored by including 'p' among default sections in uman preferences. * formulae are now displayed as text in the console, provided that a text-readable equivalent is provided in the alt attribute in the source file of the page. Example: uman inductor d * See also section: A one-line compact display listing only items without their short description is now available. Set the new umanSeeAlsoOnlyKeywords flag in uman Preferences. * Display of tables : Support to complex contents in table cells has been improved: - itemized or ordered lists are now supported in table cells. This holds for the history section, and in , and sections: Itemized or numbered lists lost their itemization and were puzzled. They are now correctly displayed. - Cells with simple contents spanning on multiple columns are now supported. Try 'uman typeof d' - Wide tables can now be displayed beyond the umanMaxLineWidth limit, within the console's width, thanks to the new umanAllowWideTables config boolean parameter. Ex: uman atomsSetConfig d - Excerpts of code are now correctly displayed in cells. Ex: uman m2sci_diag e - The balance of columns widths and the internal row wrapping are now better performed (some further improvement planned). - In a column, the unbreakability of some wide contents that imposed an extra-wide column is now managed in a more comprehensive way. - nested tables are now (partly) supported: Try 'uman codechecking_criteria d' IMPROVEMENTS ------------ * All 'uman section/author>.. b' 'uman author/section>.. b' 'uman section>..b' and 'uman author>.. b' can now be used. This makes searching by author or/and section much simpler. Don't care about the order! * See also section: External links are now displayed. Ex: uman xmlXPath or uman gettext * Internal and external links can now be displayed. The display style can be chosen in uman Preferences. For text, - the 'content' mode will display only 'text' (as with uman 2.1) - the '[content]' mode will display '[text]', showing that there is a link, without displaying its URL - the 'content [url]' mode will display 'text [url]', showing both. Exceptions: Internal URL are never displayed in Summaries nor in See also sections. * Xcos pages: the display in console is improved: - Useless sections 'Module' and 'Palette' are now ignored. - Sections 'Block Screenshot' and 'Contents' are irrelevant in console mode and are now ignored. - If no uman content option is used, 'a' (all) is now forced. * 'uman .. g' no longer prints in the console a copy of the help page opened in the help browser. Printing is kept only when no content can be displayed in the browser (feature of an external unloaded module ; local user's function, ...) * Unavailable web page of an installed ATOMS or contrib module: Now, the full page is printed by default. If at least one explicit content option is set at calling time, then the page is printed as usual: Default and explicit contents options are taken into account. REFERENCES ADDED ---------------- * Redirections - Scilab => Scilab: Atoms, event, events=>xclick - External => Scilab: blkdiag, argv, celldisp, columns, completion_matches, contains, endsWith, erase, exist, extractAfter, extractBefore, fgetl, flintmax, flip, fputs, func2str, get_home_directory, image, index, int2str, intmax, intmin, isa, is_absolute_filename, is_valid_file_id, isalnum, isfolder, isguirunning, length, lstat, mat2str, (moment,) msgbox, OCTAVE_HOME, openvar, pkg, polygcd, prctile, puts, rande, randg, randp, replace, residue, reverse, rows, source, startsWith, stat, stdin, stdout, stderr, str2func, strings, strlength, strread, strrep, strtrunc, substr, terminal_size, tolower, toupper, typeinfo, uitable, yyaxis. * Other external: - ATOMS: CEMEF-UTN, COMPleib, plotplots, removed, scicv, scipython, xcos_stm32_toolbox BUG FIXED --------- * uman failed on Windows when the SCIHOME path includes some spaces. * 'uman %i s' now displays '* %i -- ..' instead of '* percenti -- ..' * '&&' sequences in a page yielded an XML parsing error. * Titles of subsections tags were not processed and appeared with their native
tags. Ex: 'uman colorbar e' * The '<' characters present in area were not displayed. This occurred for instance with 'uman optim d' * 'uman atomsInstall p' displayed tables rows with some uncleaned tabulations. * In a , terms with an id were not displayed. * 'uman xset dlfr' : some lines were lengthened with inner blanks and were not wrapped. * 'uman xset d' : wrapping sometimes output some extra empty lines. * Numbered lists were badly indented. Ex: uman uman d // Known limitations * Some '¤' characters used as unbreakable spaces were not replaced with actual blanks before display. * In a list of terms, the ones being quite long could have uncleaned extra spaces. * For very long syntaxes wrapped on several lines, only the first line was displayed. See for instance 'uman dneupd u'. * 'uman m2sci_isa d' yielded an error. * 'uman sysconv d' : in the table, at the n1 row and n2 column, the new_line was not taken into account in the cell. * 'uman int8 h' : The table in the History section was puzzled. * 'uman addModulePreferences' yielded an error instead of telling that addModulePreferences has no help page. * 'uman scicos_graphics' yielded an 'Unknown field: sections' error. * 'uman CUMSUM s': ids of CUMSUM and RICC were followed by a hash code. * 'uman scilab s' yielded 'operation +[]' warnings and finally an error. uman .. w : * 'uman CUMSUM w' dit not find the CUMSUM online page. * 'uman iodelay w' opened help.scilab.org instead of the iodelay ATOMS page. uman .. g : * 'uman CUMSUM g' and 'uman Type g' dit not find the targeted page. * 'uman cshift g' displayed a message as if cshift was a module. The displayed recommandation was 'uman cshift wg // should work.' instead of 'uman cshift w // should work.' uman .. @ : * 'uman author>topic.. @' was broken. * 'uman author*>.. @' was broken. * 'uman det([]) @' yielded an error on the server. [] are now protected. uman .. b : * 'uman .. wb' with any query including some double quote failed. * 'uman .. wb' with an item including ';' yielded a Bugzilla error * 'uman plot xwb' no longer filtered the list of plotlib bugs against 'plot' (provided that plotlib is installed). * 'uman >>1 wb' to search ">1" on Bugzilla yielded a Scilab Invalid index error * 'uman <1< wb' searches for '<1<' instead of '<1' with no age condition. * 'uman dynpeak wb' and 'uman dynpeak w' misworked: Dynpeak was registered twice. * 'uman iodelay wb' did not open the iodelay ATOMS page, and did nothing. * 'uman wiki/> wb' did not work (empty list), nor for any other web component. * 'uman unsorted/> wb' yielded an empty list. * 'uman "Input / output>" wb' yielded an empty list, due to "/" in the section's name. * 'uman item wb' trimmed the regexp querry for any item ending with a figure. * 'uman "operation +" wb' was misprocessed and displayed no result. * The Bugzilla list of categories needed to be updated. ------------------------------- CHANGES 2.0 => 2.1 (2016-10-30) ------------------------------- NEW FEATURES ------------ * New configuration variable umanAlignSyntaxes = '' | 'l' | 'r' (default) IMPROVEMENTS ------------ * Help pages are now available in french. * Console mode: - For a better readability, syntaxes of a function are now aligned. Their justifying is tunable. Examples: who, unwrap, ss2tf, strsplit... - When a page has no parameters section, its description section(s) is now automatically displayed, even without using the 'd' option REFERENCES ADDED ---------------- * Redirections - internal: stat=>stats - to Scilab: bicg, bicgstab, cgs, class, iscell, iscellstr, isinteger, isjava, numel, pcg, spdiags, square => squarewave(faux-ami) - to external: print_usage * FileExchange: GnuSciPlot, Ishikawa, STL * ATOMS: forge cglab=>cgal, Dynpeak, FOT, sopi, wgserialxcosio BUG FIXED --------- * 'uman close u' displayed only 'close(H)', forgetting 'close' * Changing csvDefault('separator',..) made 'uman' failing. * when the of a has an id, uman ignored the term. * '& ' in a area yielded an error. Ex: 'uman _atomsGettingStarted dc' * when a had a single , the '' tag could be displayed. * 'uman bitget lru' did not display the parameters section * 'uman author> wb' without section and item yielded an error. * 'uman figure_size wb' did not select '... Fig.figure_size=sizes ...' * 'uman [ wb' missed '[a b c ..]' and other entries * 'uman ? wb' or 'uman # wb' yielded a Bugzilla error * 'uman 12 wb' was accepted while Scilab bugs are numbered starting from 77. * 'uman doc/>plot2d wb' did not target the 'Documentation pages' component * 'uman doc/><100 wb' yielded an error (no topic) * 'uman author> @' used '>' as part of the author name ------------------------------- CHANGES 1.4 => 2.0 (2016-04-06) ------------------------------- NEW FEATURES ------------ * New option 'u' to display only the list of usages (types of calls) * disp_usage() and disp_usage(funame) implemented and documented. * 'uman ... wb': It is now possible to target components or/and authors or/and a maximal change age. * 'uman ##### wb' now targets the bug number ##### on bugzilla. * New full-featured option '@' to comb online archives of Scilab mailing lists * Environment variables are now available (global): - umanDefaultOptions, to choose your own default options (display, language, etc). Command-line options are still available, to easily override default ones. - umanMaxLineWidth>=50. Default = 90. Useful when the console is very wide. - umanUserPaths, to point packages out of SCI\contrib and SCIHOME\contrib - umanNoStyle, to cancel ASCII-conversion of bold and italic styles. * Partial corpus are now supported (subset of translated scilab functions without the en_US version for untranslated ones) * Partial support to Farsi language added (still left-justified). IMPROVEMENTS ------------ * 'uman' is now stable with Scilab 6.0 (6.0-beta1 release) * Tables: long lines in cells and in the history section are now wrapped ex: uman atomsSetConfig ac * Items that title is several-worded like 'Scilab documentation format' could not be addressed neither in the console, nor directly in the help browser nor in the online help, because their single-word id that is the pattern to use to address them was displayed nowhere. In 'See also' sections and Summaries, their id is now displayed instead of their title. Hence, uman help s // now displays * man — on line help XML file description format instead of * Scilab documentation format — on line help XML file description format and 'uman man a ..' can now be used to address the related page. * 'Screen' areas were not specifically identified and delimited. * The tag was not supported. * and tags were not supported. * The list of jar files was weekly updated. It is now just set at the first use of uman, and when the 'r' option is used to intentionally refresh it. * External modules not on ATOMS but having a public forge -- such as Scimax -- are now supported. * For pages having multiple xml:id, all syntaxes were displayed instead of only syntaxes matching the given pattern (ex: man int32) * It is now possible to redirect to keywords (such as graphic properties) instead of to a proper item/page, usable with g or/and w options. For example, 'uman view' now suggests a redirection to 'rotation_angles'. * uman's URL is now displayed at loading, for comment, scoring and bug report REFERENCES ADDED ---------------- * Redirections - internal: if installed: apifun, cglab, ipcv, scimax. gui - to Scilab: deal, patch, surf2patch, urlread, webread - to external: inpolygon, polyarea, web * FileExchange: strrand, rotate3d, mesharea, polygonmetrics, pdiv_inc, partfrac, browseURL * ATOMS: visa, scinetcdf, Computer-Vision, favouritedirs, E4Coder, FireBird, BTD (bioinformatics), cglab * Forge (with no ATOMS): scimax BUGS FIXED ---------- * Scilab6-ready: management +[] modified (partly?); strtok() replaced. * The options had become case-sensitive. * For a contrib module, when the name of the main directory was not strictly the name of the module (as for instance with version indication), uman failed extracting pages from the jar. * When a jar file had a path with space(s), uman was unable to unzip it. * When the japanese archive is used, wrapping of lines in summaries of untranslated sections was shortened. ex: uman call slja * In synopses, '&' characters were displayed as '&'. Ex: uman uman u * In examples, '&' characters were displayed as '\&'. Ex: uman uman e * 'uman graphics' targetted the Graphics page, instead of the summary of graphical functions => 'graphics' replaced with 'plotting'. * 'Calling sequence' renamed 'Syntax' in Scilab 6 is taken into account. * 'uman Type w' did not target the right page. * 'uman interval w' yielded an error (while Int4Sci is installed) * 'uman item1|item2 w' produced an error with host() * 'uman $ wb' returned all reports, instead of reports intitled with some '$'. 'uman \$ wb' had to be used instead. * 'uman mode wb' unexpectedly listed bugs about 'simp_mode'. As well, 'uman matrix wb' included bugs about x_matrix(). * uman wb: '.', '*','\', '|' special regexp characters in pattern were not escaped before calling bugzilla. patterns such that .\., ./., .*., ./, .\, ||, **, etc were unsuccessful. * 'uman dir|%dir_p wb' yielded many lines without 'dir' or '%dir_p' but with 'directory'. Parentheses embracing the alternative a|b|c.. were missing. * 'uman list( wb' or with any item having a '(' produced a grep error. * 'uman [ wb' displayed 'grep: Can not compile pattern' in infinite loop. * With SciMax installed, listing its summary produced an error 'Invalid index' * When the page of an external unloaded module was targeted with 'g', the message "module not loaded => not browsable" was no longer displayed ------------------------------- CHANGES 1.3 => 1.4 (2015-07-31) ------------------------------- REFERENCES ADDED ---------------- * Redirections - internal: latex - to Scilab: closereq, cputime, fgetl, fopen, fread, fwrite * FileExchange: varspace, strrepeat, strrand IMPROVEMENTS & BUG FIXED ------------------------ * 'uman linespec g' missed targetting 'LineSpec' in the help browser case-sensitive. The 'plot' page was displayed instead. * After removing a contrib, "r" did not unregister its help pages. * Tables: content of heading cells was not upcased. * "uman" recompiled for Scilab 6. ------------------------------- CHANGES 1.2 => 1.3 (2015-07-12) ------------------------------- REFERENCES ADDED ---------------- * Redirections added: - to ATOMS: python, MySQL, MSSQL, PostgreSQL, ODBC, Sqlite, Firebird, help (x) - to scilab: trapz - internal: history - to FileExchange: polyint * FileExchange: polyroot, polyIntegrate, cummin, cummax, isDocked(), orderfields * External references added: Labview, GPIB, int4sci IMPROVEMENTS & BUGS FIXED ------------------------- * 'wb': It was not possible to look for bugs cumulated over several Scilab or unknown items separated by '|'. An error was thrown. Example: uman userdata|user_data wb * 'uman hdf5 wb' targeted 'h5read' instead of 'hdf5' in bugzilla. Now, redirections are not applied when 'wb' is used. * For any user's function 'MyFun', 'uman myfun' was case-sensitive and did not detect MyFun. * Help pages: a closing tag was badly placed. Minor fixes or updates. * Windows: uman nidaq w opened a windows directory. * Shortcuts for external references with 'w' dit not work. * uman ./. wb and uman .\. wb yielded a grep error * uman mopen a, uman overloading a : there were large vertical spaces between examples (due to erroneous empty sections) * In a definition list, when a term included some ':', its end was trimmed from the first ':'. Example: 'uman : d' * External packages: the name of their main directory was case-sensitive. ------------------------------- CHANGES 1.1 => 1.2 (2015-06-06) ------------------------------- * uman did not work with Scilab 6. * uman $ wb yielded a java exception. * uman gpib failed without proposing using the "w" option. * Windows: unzipping help archives was not quiet in the consolebox. * uman int16 w did not target the int8 online page instead. * uman wb did not display entries where ends the line. * uman who wb displayed also bugs related to "who_user". * Added redirections: range (x), fzero, inpolygon, std, var, cummax, cummin, circshift, histcounts, orderfields * uman optim : the section "Example : Passing extra parameters" was displayed as Parameters section with title "Parameters". * uman metanet s: with metanet 0.6.2-2, there was an extra \n after each line * uman tokens e: '=' became erroneously ' = ' * Unprotected "<" literal characters in the optim's page made uman crashing. See also http:bugzilla.scilab.org/13877 * No ressources out of ATOMS and FileExchange were registered for "w" targeting: int4sci and GPIB added. * No ressources from FileExchange were registered. More than 40 selected functions on FileExchange are now addressable: bezier, contour3d, cshift, ellipfit, git, struct2json, etc. * List of ATOMS modules updated. * "r": only the page of the pattern, in the queried language, was refreshed (instead of pages of all external packages in all languages) * By default, uman's output was written in open diaries and paused with "j", instead of being ignored unless "j" is used. * for an undocumented pattern, "g" was not used * for an undocumented pattern, "w" canceled by "s" was not used * uman "unknown pattern" w called the web browser twice * functions grabbed on the fileExchange or other sites and inline-documented could not be web-referenced and targeted by uman with "w" and "wb" options. * "wb": for ATOMS without forge or other contrib packages, bugzilla was targeted instead of the comment's section of the ATOMS page or the dedicated website. * There was no separating blank line after any code sample * The output width was up-bounded only by the console width. Now max 100-char * extra empty or blank lines at the end of a section were not removed * summary in ja_JP: when the short description was unbreakable and long, it was displayed on the next line, leaving the first line empty. * "s" option was canceled by "w" (instead of canceling "w" by "s") * items of the "see also" section were not aligned at all * summaries: alignment of short items improved * Help pages updated --------------------- uman 1.1 : 2015-03-27 --------------------- * Help pages updated * ja_JP: Ends of sentences were not wrappable points * summaries : wrapping was only partial. left justification of the unique wrapped line could be wrong. * "uman openserial" displayed an error * "uman type" returned an error (after the implementation of the case-sensitivity management) * Some error messages returned by the OS could be displayed * Automatical refreshing / reloading was done once a day. Now once a week. * The pattern was always case-insensitive. Now only when all in lowercase. * when the pattern was finally head_commented, head_comment was displayed twice * under Linux, jar files were not always properly detected & listed --------------------------------------- uman 1.0 : 2015-03-22 : Initial release --------------------------------------- FIXED & DONE for the first public release: (from bottom to top) * HTML help pages (en, fr) published on sgougeon.free.fr * The toolbox was not completely set: changelog.txt, DESCRIPTION, DESCRIPTION-FUNCTIONS, readme.txt, license.txt added. uman_redist.iss updated. * There were no unitary tests (.dia.ref still to be written) * help in head_comments was not up-to-date * searching the pattern was case-sensitive * "L.." option was possible only as last option * Itemized lists: wrapped lines were not indented * Itemized lists: some lines were wrongly wrapped * Examples with strings including some tages were not displayed * in some pages, some %26#8212 raw entities appeared. * The list of ATOMS modules (and related forge or website) was not up-to-date (2015-03-20. Last = openCV Function implementation...) * Summary: the path within the help was not displayed * Option "a" added : All sections displayed (but bugs URLs) * The title of refsections could have extra spaces. * There was no help page in french * "x" mode: non existing pattern did not display the "uman: "" is not documented" message * ~"wb" mode: braces "{" and "}" were not converted into their equivalent "[" "]" * "wb": symbols were not regexp-escaped before calling bugzilla search in regexp mode. * "x" : priority to external patterns was dropped, since redirections are called only in second. * "wb": any %# pattern prefixed with % was wrongly translated into percent# before calling the online bug page * redirection: some online help or bug pages opened targetting the original pattern instead of the redirected one. * "swb" opened online help and bug pages. Now "s" kills "w" and "b" * "wb": when the pattern was not found, Scilab help page AND bugzilla page were addressed together, instead of only Bugzilla * "wb": when the pattern was not found, Scilab help page was addressed instead of the bugzilla one. * redirections were called a priori, instead of only when the initial pattern was not found * ATOMS modules: Many forge references were not correct. ALl checked. * Tip and Caution tags were not displayed (only Note and Warning) * "h" option introduced for history info * "h" option (help browser) renamed into "g" (GUI). This history also updated * style was not reviewed and improved. * sections identification and display refactorized. For multiple sections of the same type, only the first occurrence was displayed * Some WARNING and NOTE were not detected * In pieces of code, "#;#" style was allowed, instead of "#; #" * There was a memory leak due to undeleted xml documents * .. sections could be wrapped * options: when flags were used before and after the item and "L" was used, most of options were ignored. * Tables: missing cells yielding too short lines yielded an error. * Tables: rows with only one cell were roughly processed. Now, their complex content is processed as for other sectionning tags. * Some
 sequences of programlisting were not processed correctly: their
	 id was displayed instead of the code. Example: uman fft cdLfr  in the
	 "Syntaxe longue pour la FFT mutidimensionnelle" section
	* Mac OS: file finding implemented. Mac OS should now be supported (to be tested)
	* German added for sections detection
	* last implementations were no longer working under Linux. Repared
	* xml page updated
	* option "p" (package) renamed "x" (eXternal) 
	* strsubst2() implemented through TCL did not support Mac OS
	=> replaced with the Java version
	* patterns including spaces did not convert then into "_" (as in many
	 "properties" entries.
	* Redirections : input elements (left column) were not considered whether
	 they had uppercase characters.
	* External faux amis were not reachable. For instance, the equivalence for
	Octave "end" was not accessible (since "end" exists in SCilab). They are
	now reachable using the same "x" option. 
	* "wb" on scilab functions: plot2d or plot3d were in the list for "plot"
	* For pages presenting several functions or items, only explicitly
	 declared ones were supported with some explicit redirections.
	They are now all supported without explicit declared redirections.
	* The list of JAR was set each time uman was called. It is now saved, 
	 and "r" refreshes it.
	* When redirecting, it was not possible to force some options othen than "s"
	* external equivalences were scanned only when the primary query did not 
	 match anything. They are now scanned a priori, in order to enable
	 special processings as forcing the "s" flag for some actual queries.
	* when the "property" or "properties" string was in the query, the display
	of the "description" part was not forced, contrarily to what the help said.
	* Some main categories were not easyly accessible: variables, hfd5, signal,
	 metanet, statistics, windows, xml, sparses, shortcuts, graphics, files, 
	 atoms
	* opening default web browser under Linux was not supported
	* "b" : if ATOMS without forge, the comments section of ATOMS page was not
	 targeted
	* "man" renamed "uman"
	* "x" excluded scanning Scilab pages => role modified
	* .. was not supported
	* Summaries : alignements of "—" implemented
	* Lines wrapping sometimes overflown for imbricated description lists: fixed!
	* support to  and  added
	* atoms/forge data were in an external file. Now in a function
	* .. appeared as is in the text
	* option "x" (eXternal packages first) implemented
	* option "f" (force) renamed "r" (reload)
	* help page in en_US: written and compiled
	* language id in options could be considered as common options.
	* "g" management improved: 
	  - loading status of contrib modules was not defined
	  - unloaded ATOMS modules were temptatively called to helpbrowser
	* option "r" was not proposed
	* not ATOMS modules in SCI\contrib and other external modules in 
	SCIHOME\contrib were not detected 
	* ATOMS modules not set for ALL USERS were not correctly processed
	* the "s" option did not work for ATOMS modules
	* extraction zip sous Linux
	* toolbox : setup (to be finished)
	* "s" was not available => added
	* uman patconvert  yielded an error (due to strsubst2: set TXT {\} )
	* for ATOMS modules, the web target designed for "wb" options was not correct. 
	* "w" option used for a function of an external module was unsuccessful: 
	 there is no online help for these modules => replaced with console display
	* Only the first GET's separators "&" in URLs  was replaced. Following ones
	 were still blocking XML parsing. Example: uman conjgrad c
	* Description lists: indentation depth was too large. It made line-wrapping
	mis-working. Examples:
	  uman schur cd
	  uman fft cdlfr    largeur description incorrecte
	* when a page describes several functions and the short description of one
	 of them was missing, an error occurred. 
	 Example: uman mprintf cd    See http:bugzilla.scilab.org/13748
	* The diary was stopped with the option "j" even when the web was targetted
	* "w": when the item was not found in Scilab, head_comments was called instead
	of calling the online search page.
	* "wb": when the item was not found in Scilab, the item was not passed to
	  the Bugzilla search engine.

--------------------------
uman 0.0 / 2012 : Creation
--------------------------

 -- Samuel GOUGEON   Tue, 22 mar 2015 14:50:02 +0100