uman .. b

Arguments

b | xb

b is the uman's option making uman working in bug query mode.

The uman x option setting the priority to features eXternal to Scilab (for instance ATOMS modules features) can be taken into account if only one item is provided. Otherwise, it will be ignored.

bugNumber.

Integer > 76 (entered as text): id of the targeted bug report on the Scilab Bugzilla bugs tracker.

item, item1|item2|,...

Case-insensitive words or text expressions that must be searched in the title of bugs reports. All reports whose title includes at least one of the listed items are selected.

Neither exclusion ~ (NOT) nor & (AND) conjunction operators are available for items.

author, author1|author2|..

Case-insensitive names of bugs reporters or commenters on Scilab bugzilla bug tracker.

Ndays

Positive integer (entered as text): only reports changed or commented at most Ndays days ago will be selected. This applies only for reports on bugzilla.scilab.org.

section, section1|section2|..

Case-insensitive name(s) of Bugzilla components/categories in which the selected bugs must be searched, provided that the Scilab's bug tracker is actually targeted.

Existing categories:

api	Scilab API ➜ hardcoding
atoms	All ATOMS features
atomsweb	ATOMS web portal
atomsdesk	ATOMS client (functions, GUI)
build, compile	Building Scilab from sources
CACSD	CACSD module
containers	Lists cells structs features
demos	Demontrations
desktop, workspace, IDE	Desktop, console, docking, history, files browser etc
edit, scinotes	Code editor
figfiles	Files from figures
files, rw, iodata	Files management (open, read/write, seek..). HDF5.
GUI	Graphical User Interfaces
hardcoding	Hard coding, API, mexlib, dynamic link
help, doc	Contents of help pages
helpsys	Help system (build and see)
install	Scilab installation (obsolete)
interactions	events, menus, datatips, graphics editor
internal, maintenance	Internals, maintenance (thirdparties, source tree organization,..)
java	Java features
matlab	Code converter, .mat files
maths	Math features (except statistics)
mexlib	Mexlib ➜ hardcoding
misc, unsorted	Unsorted features
optim	Optimization computing
OS	OS functions & files system
parallel	Parallel computing

uman keyword	Misworking website
plot	Plotting in graphical figures
preferences	Preferences management
stats	Statistics functions
strings	Char / string / text processing
syntax, parser	Syntax / interpreter
tests, perfs, quality	Tests, bunchmarks, coverage, profiling, slint
sparse	Sparse matrices
startup	Startup crash or issue (obsolete)
TCL	TCL tclsci functions
terminal, cli, batch	Scilab without IDE
translation, local	Translation - localization features
uicontrol	uicontrol & uitree components
vars, variables	Variables management (clear, global, editvar..)
xcos	Xcos
xml	XML/HTML files processing

atomsweb	atoms.scilab.org
bugtracker, bugzilla	bugzilla.scilab.org
codereview, gerrit	codereview.scilab.org
fileexchange	fileexchange.scilab.org
forge	forge.scilab.org
git, gitweb	gitweb.scilab.org
onlinehelp, helpweb	help.scilab.org
ml, mailinglists	mailinglists.scilab.org
website	www.scilab.org
wiki	wiki.scilab.org

internal operators

/	Separator between sections and authors lists. When only sections or only authors are specified, `"/"` is not needed.
>	Separator between the sections or/and authors list and items. When no section and no author are specified, `">"` is not needed.
<	items<Ndays separator. When no age is specified, `"<"` is not required.
\|	OR conjunction between multiple selected authors, sections, or items.
"..."	When there is at least one space in any part of the search pattern (authors, items, bugs age), the whole pattern must be specified between single or double quotes. Some special patterns like "==" require some quotes as well.

Description

uman .. b runs the web browser defined in your Scilab preferences, and opens an URL searching in online Scilab bugs trackers for the given item(s) and criteria.

uman .. b requires an active internet connexion.

Aliases / redirections defined in uman are not used in "b" mode.

Example: uman flipud b won't look for and find the flipud => flipdim redirection. It will query Bugzilla about flipup as is.

Section(s), author(s), and the bug-changes maximum age Ndays are taken into account only when Bugzilla is targeted. Otherwise, these criteria are ignored.

None of possible items, sections, authors, or age of bugs-change specifications is mandatory, but giving at least one of them is more efficient ;-)

When several types of criteria are provided (section, author, item, bug age), only bugs reports fulfilling all of them are selected.

Queries sent to Bugzilla and that are not about a given bug number are converted into a regular expression and processed as is by the server. However, presently, special regexp characters such as wildcards ., * or other ones are protected and have no special meaning and role in given items.

Processing of the query

When a bugNumber is provided: the page of the bug numbered and documented on Scilab's bugzilla is displayed. Example: uman 11625 b

Otherwise:

If no item, or several |-separated items are provided, uman always queries the Scilab bugzilla bug tracker.
Otherwise: uman looks for the item among native Scilab functions and other Scilab ressources installed on your computer, as it does in normal console mode. Then, according to the type of Scilab ressource where the item is found, the bug query is routed as it follows:
- If the ressource is Scilab itself, Bugzilla is targeted.
- If the ressource is an ATOMS module having a Scilab public forge, or if it is a package out of ATOMS but having a Scilab public forge registered by uman: the bug tracker of the forge is targeted. The list of documented bugs related to the item is selected and displayed on the tickets page of the Forge http://forge.scilab.org/index.php/p/<module_name>/issues/.
- If the ressource is an ATOMS module without Scilab public forge: The comments section of its ATOMS page is targeted, where bugs may be reported.
- If the ressource is a known FileExchange item: The comments section of the FileExchange page is targeted, where bugs may be reported.
- If the ressource is out of ATOMS, FileExchange, and Scilab forges, but is uman-registered and has a known website: Its website is targeted.
- If the item has been found in none of known ressources registered in uman: The Scilab's bugzilla search engine is targeted.

Examples

// ====== ALIVE INTERNET CONNEXION REQUIRED ======
//
uman 11625 b     // Displays the bugzilla page of the bug #11625

uman ode b       // For any Scilab internal function, on bugzilla, well sorted

uman cshift b    // For functions registered on FileExchange, bugs may be
                 //  reported as users comments on the dedicated online page

uman gpib b      // Only registered as external ressource => website targeted.

uman flipud b    // Unknown pattern. The existing redirection to flipdim()
                 // is ignored => "flipud" is searched for as is on Bugzilla.

uman cholesky b  // For any unknown pattern: searched as is on bugzilla

uman ndgrid|meshgrid b  // Bug reports about ndgrid OR meshgrid, on Bugzilla,
                        //  as always when several items are indicated.

uman plot><100 b        // Reports in the Graphic plotting category, changed max 100 days ago

uman gougeon>console b  // Reports / comments by gougeon about "console"

uman gougeon/desktop> b // Reports / comments by gougeon in the "desktop/IDE" category

uman maths/gougeon> b   // Reports / comments by gougeon in the Maths category

uman "<10" b            // Reports changed within the last 10 days.
                        // Without "..", uman would be compared to 10..

With an installed external ATOMS module having a Scilab forge:

yn = atomsIsInstalled("specfun");
atomsInstall specfun ;  // Let's instal specfun
atomsIsLoaded specfun   // => %F: no need to be loaded

uman specfun_combine b  // A ticket about specfun_combine() exists on the
                        // specfun forge. The related page is opened.

if ~yn, atomsRemove("specfun"), end    // cleaning after the example

With an installed external ATOMS module without Scilab forge:

uman disp_usage b  // The ATOMS page is targeted (comments section)

History

Version	Description
3.0	2019-08-22 New List only unresolved bugs configuration parameter introduced. Querying bugs now requires simply the `"b"` option instead of the `"wb"` pair. The former `"b"` semantic is removed. The syntaxes `uman section>.. b` and `uman author/section>.. b` are now supported, in addition to `uman author>.. b` and `uman section/author>.. b`. List of Bugzilla categories updated and overhauled. 13 bugs fixed about the "b" option. Page overhauled.
2.1	2016-10-30 : 7 bugs fixed. Translation of this page in french.
2.0	2016-04-06 : Separate help page for "uman .. b"
1.0	2015-03-22 : First uman release