Skip to content

Commit 3b20567

Browse files
committed
Update text.rst
1 parent e89f689 commit 3b20567

File tree

1 file changed

+12
-12
lines changed

1 file changed

+12
-12
lines changed

doc/rst/source/text.rst

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -77,8 +77,8 @@ Required Arguments
7777

7878
*textfiles*
7979
This is one or more files containing 1 or more records with (*x*
80-
*y*\ [ *font* *angle* *justify*] *text*). The attributes in
81-
brackets can alternatively be set directly via **-F**. If no files
80+
*y* [*font* *angle* *justify*] *text*). The presence or absence of
81+
items in the brackets are determined by **-F**. If no files
8282
are given, **text** will read standard input. *font* is a font
8383
specification with format [*size*,][*font*,][*color*] where
8484
*size* is text size in points, *font* is the font to use, and
@@ -149,21 +149,21 @@ Optional Arguments
149149
**-F**\ [**+a**\ [*angle*]][**+c**\ [*justify*]][**+f**\ [*font*]][**+j**\ [*justify*]][**+h**\|\ **l**\|\ **r**\ [*first*] \|\ **t**\ *text*\|\ **z**\ [*format*]]
150150
By default, text will be placed horizontally, using the primary
151151
annotation font attributes (:term:`FONT_ANNOT_PRIMARY`), and centered
152-
on the data point. Use this option to override these defaults by
152+
on the data point. Use **-F** to override these defaults by
153153
specifying up to three text attributes (font, angle, and
154-
justification) directly on the command line. Use **+f** to set the
155-
font (size,fontname,color); if no font info is given then the input
154+
justification) directly on the command line. Use modifier **+f** to set the
155+
font ([*size*][,\ *fontname*][,\ *color*]); if no font info is given then the input
156156
file must have this information in one of its columns. Use **+a** to
157-
set the angle; if no angle is given then the input file must have
157+
set the *angle*; if no angle is given then the input file must have
158158
this as a column. Alternatively, use **+A** to force text-baselines
159159
to convert into the -90/+90 range. Use **+j** to set the justification; if no
160-
justification is given then the input file must have this as a
160+
justification is given then the input file must have this item as a
161161
column. Items read from the data file should be in the same order as
162-
specified with the **-F** option. Example:
162+
the modifiers are specified with the **-F** option. Example:
163163
**-F**\ **+f**\ 12p,Helvetica-Bold,red\ **+j+a** selects a 12p red
164164
Helvetica-Bold font and expects to read the justification and angle
165-
from the file, in that order, after *x*, *y* and before *text*.
166-
In addition, the **+c** justification lets us use x,y coordinates extracted from the
165+
from the file, in that order, after *x* *y* and before *text*.
166+
In addition, the **+c** justification lets us use *x,y* coordinates extracted from the
167167
**-R** string instead of providing them in the input file. For example **-F+c**\ TL
168168
gets the *x_min*, *y_max* from the **-R** string and plots the text
169169
at the Upper Left corner of the map. Normally, the text to be plotted
@@ -201,8 +201,8 @@ Optional Arguments
201201
information pertaining to the typesetting of a text paragraph (the
202202
remaining lines until next segment header). The information expected
203203
is (*x y* [*font angle justify*] *linespace parwidth parjust*),
204-
where *x y font angle justify* are defined above (*font*, *angle*,
205-
and *justify* can be set via **-F**), while *linespace* and
204+
where *x y font angle justify* are defined above (the presence or
205+
absence of *font*, *angle*, and *justify* are determined by **-F**), while *linespace* and
206206
*parwidth* are the linespacing and paragraph width, respectively.
207207
The justification of the text paragraph is governed by *parjust*
208208
which may be **l**\ (eft), **c**\ (enter), **r**\ (ight), or

0 commit comments

Comments
 (0)