diff --git a/doc/rst/source/explain_-L_scale.rst_ b/doc/rst/source/explain_-L_scale.rst_ index eb0258d35be..e52b662d1ca 100644 --- a/doc/rst/source/explain_-L_scale.rst_ +++ b/doc/rst/source/explain_-L_scale.rst_ @@ -1,4 +1,4 @@ -**-L**\ [**g**\|\ **j**\|\ **J**\|\ **n**\|\ **x**]\ *refpoint*\ **+w**\ *length*\ [**e**\|\ **f**\|\ **k**\|\ +**-L**\ [**g**\|\ **j**\|\ **J**\|\ **n**\|\ **x**]\ [*refpoint*]\ **+w**\ *length*\ [**e**\|\ **f**\|\ **k**\|\ **M**\|\ **n**\|\ **u**]\ [**+a**\ *align*]\ [**+c**\ [[*slon*/]\ *slat*]]\ [**+f**]\ [**+j**\ *justify*]\ [**+l**\ [*label*]\ ]\ [**+o**\ *dx*\ [/*dy*]]\ [**+u**][**+v**] @@ -8,6 +8,9 @@ .. include:: explain_refpoint.rst_ + If *refpoint* is omitted, the map scale is placed by default in the lower-left corner of the map + (using **+jBL+o0.2c/0.4c**), nudged slightly inward so it does not sit flush against the map frame. + The following modifiers can be appended to |-L| (**+w** is required), with additional explanation and examples provided in the :ref:`placing-map-scales` cookbook section. For Cartesian projection, the modifier **+c** is not allowed and no units should be appended in **+w**. diff --git a/src/gmt_init.c b/src/gmt_init.c index 4bae4ac294c..3859b175474 100644 --- a/src/gmt_init.c +++ b/src/gmt_init.c @@ -8925,6 +8925,7 @@ void gmt_mapscale_syntax (struct GMT_CTRL *GMT, char option, char *string) { GMT_Usage (API, 1, "\n-%c%s", option, GMT_SCALE); GMT_Usage (API, -2, "%s", string); gmt_refpoint_syntax (GMT, "L", NULL, GMT_ANCHOR_MAPSCALE, 3); + GMT_Usage (API, -2, "If is omitted, the scale defaults to the bottom-left corner inside the map frame, nudged slightly inward (using +jBL+o0.2/0.4c)."); GMT_Usage (API, -2, "Set required scale via +w, and (for geographic projection) append a unit from %s [km]. Other scale modifiers are optional:", GMT_LEN_UNITS2_DISPLAY); GMT_Usage (API, 3, "+a Append label alignment (choose among l(eft), r(ight), t(op), and b(ottom)) [t]."); diff --git a/src/gmt_support.c b/src/gmt_support.c index c8770ae4c7d..4e49a843a93 100644 --- a/src/gmt_support.c +++ b/src/gmt_support.c @@ -14128,7 +14128,8 @@ int gmt_getinset (struct GMT_CTRL *GMT, char option, char *in_text, struct GMT_M int gmt_getscale (struct GMT_CTRL *GMT, char option, char *text, struct GMT_MAP_SCALE *ms) { /* This function parses the -L map scale syntax: - * -L[g|j|J|n|x]+c[/]/+w[e|f|M|n|k|u][+a][+f][+j][+l