Changes between Version 44 and Version 45 of Grass8Planning

Timestamp:

08/31/19 11:59:11 (5 years ago)

Author:

wenzeslaus

Comment:

Notes on wildcards vs RE

Grass8Planning

@@ -88 +88 @@
 * All modules with (pseudo-)random outputs like G7:r.mapcalc with `rand()` should use `seed=` to set the seed and `-s` to get random, non-deterministic result. (This is a blocker since the point is changing interface in a breaking way.)
 * Parser format and functionality should be changed to:
- * comply with PEP8 for Python (e.g., replace `#%` by `"# %`)
+ * comply with PEP8 for Python (e.g., replace `#%` by `# %`)
  * include the high level //standard options// into `--script` and perhaps other places
  * create better strings for the high level //standard options// for use in scripts (e.g., replace `option: G_OPT_R_INPUT` by something like `option: raster_input`) 
@@ -98 +98 @@
  * add short module description in imperative (//Compute XY//) or as a title (//XY computation//), i.e., move these from wxGUI XMLs to modules themselves (e.g., for //r.slope.aspect//, wxGUI has //Slope and aspect//)
 * Consider including simplified modules. We already have r.mapcalc.simple which is useful not only for QGIS Processing etc. but also in GRASS itself, specifically with PyGRASS `GridModule`. For example, //r.slope.aspect// in wxGUI says //Slope and aspect// but in fact it does much more, yet the menu does not indicate that, perhaps a reason to have a basic and advanced versions.
+* Usage of wildcards and regular expressions should be better documented across the interface.
+ * g.list and others have "bash wildcards" (aka glob) as default and then come with flags to turn on basic and extended regular expressions. BRE and ERE ([https://www.regular-expressions.info/posix.html POSIX] or [https://www.regular-expressions.info/gnu.html GNU]) are mysterious and misleading for users not well versed in Unix history.
+ * GUI tends to use Python [https://docs.python.org/3/library/re.html re] package.
+ * In addition to it, users get in contact with SQL (e.g. LIKE, GLOB and REGEX in SQLite).
+ * Examples in the interface seems to be a must regardless of the naming.
 === Raster library ===